{"openapi":"3.1.0","info":{"title":"Runtype API","version":"1.0.0"},"paths":{"/.well-known/jwks.json":{"get":{"operationId":"identityIntegrations_identityAssertionSigningKeysJwks","summary":"Identity assertion signing keys (JWKS)","description":"Public keys that verify the Runtype-signed `{{_identity.token}}` a tool call carries. Verify offline: check the ES256 signature against the key whose `kid` matches the token header, then the header `typ` (`runtype-identity+jwt`), `iss` (pin it to the one Runtype organization you trust: `<API origin>/orgs/<organizationId>`), `aud` (your host), `exp`, and the per-scope assurance in the `runtype` claim. The same keys sign agent access tokens (`typ: at+jwt`) under the separate issuer `<API origin>/orgs/<organizationId>/agents`; accept those only if you pin that issuer explicitly. Cache the response for up to five minutes; re-fetch when a token names an unknown `kid`.","tags":["identityIntegrations"],"responses":{"200":{"description":"The published key set. Empty when this environment has no signing key configured.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdentityAssertionJwks"}}}}}}},"/.well-known/oauth-authorization-server/orgs/{organizationId}/agents":{"get":{"operationId":"identityIntegrations_agentIssuerMetadata","summary":"Agent issuer metadata","description":"RFC 8414 authorization server metadata for the agents issuer of one organization. A resource server that accepts agent tokens pins this `issuer`, verifies against `jwks_uri`, and checks `typ: at+jwt` and `aud`.","tags":["identityIntegrations"],"parameters":[{"name":"organizationId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"The issuer metadata.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentIssuerMetadata"}}}},"404":{"description":"Agent tokens are not available for this organization.","content":{"application/json":{"schema":{"description":"Any type"}}}}}}},"/v1/identity-integrations":{"get":{"operationId":"identityIntegrations_listIdentityIntegrations","summary":"List identity integrations","description":"Lists the owner's Identity Exchange integrations (verification descriptors for customer-native auth proofs). Credentials are redacted to a presence list.","tags":["identityIntegrations"],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Identity_Integrations_listIdentityIntegrations_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]},"post":{"operationId":"identityIntegrations_createAnIdentityIntegration","summary":"Create an identity integration","description":"Creates an Identity Exchange integration. The descriptor is validated against the shared schema and the server mints the integration id (the cross-integration isolation namespace).","tags":["identityIntegrations"],"responses":{"201":{"description":"Identity integration created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Identity_Integrations_createAnIdentityIntegration_Response_201"}}}},"400":{"description":"Invalid descriptor or request body","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateAnIdentityIntegrationRequestBadRequestError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"An active integration for this issuer already exists","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"credentials":{"$ref":"#/components/schemas/V1IdentityIntegrationsPostRequestBodyContentApplicationJsonSchemaCredentials","description":"Provider management/client credentials. Sealed at rest, bound to this integration, and never returned by any endpoint. Set a field to rotate it; null clears it."},"descriptor":{"type":"object","additionalProperties":{"description":"Any type"},"description":"The IdentityAdapterDescriptor (without id — the server mints it). Validated against the shared identityAdapterDescriptorSchema: discriminated by 'kind' ('oidc-jwt' | 'session' | 'custom'); verifiable kinds require https issuer/jwksUri, a non-wildcard audience, and asymmetric-only allowedAlgorithms; maxAssurance may only lower the kind ceiling ('oidc-jwt' → 'verified', others → 'asserted')."},"name":{"type":"string","minLength":1,"maxLength":255},"provider":{"$ref":"#/components/schemas/V1IdentityIntegrationsPostRequestBodyContentApplicationJsonSchemaProvider"}},"required":["descriptor","name","provider"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/identity-integrations/{id}":{"get":{"operationId":"identityIntegrations_getAnIdentityIntegration","summary":"Get an identity integration","tags":["identityIntegrations"],"parameters":[{"name":"id","in":"path","description":"Identity integration id (idint_...)","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Identity_Integrations_getAnIdentityIntegration_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]},"delete":{"operationId":"identityIntegrations_deleteAnIdentityIntegration","summary":"Delete an identity integration","description":"Hard-deletes the integration and its sealed credentials. Existing projected identities (product_tenants / end_users rows carrying this integration id) are kept — the id remains their isolation namespace.","tags":["identityIntegrations"],"parameters":[{"name":"id","in":"path","description":"Identity integration id (idint_...)","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Identity integration deleted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Identity_Integrations_deleteAnIdentityIntegration_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]},"patch":{"operationId":"identityIntegrations_updateAnIdentityIntegration","summary":"Update an identity integration","description":"Updates name/provider/status, replaces the descriptor (re-validated), and/or rotates credentials (per-field: string sets, null clears, absent keeps).","tags":["identityIntegrations"],"parameters":[{"name":"id","in":"path","description":"Identity integration id (idint_...)","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Identity integration updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Identity_Integrations_updateAnIdentityIntegration_Response_200"}}}},"400":{"description":"Invalid descriptor or request body","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateAnIdentityIntegrationRequestBadRequestError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"An active integration for this issuer already exists","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"credentials":{"$ref":"#/components/schemas/V1IdentityIntegrationsIdPatchRequestBodyContentApplicationJsonSchemaCredentials","description":"Provider management/client credentials. Sealed at rest, bound to this integration, and never returned by any endpoint. Set a field to rotate it; null clears it."},"descriptor":{"type":"object","additionalProperties":{"description":"Any type"},"description":"The IdentityAdapterDescriptor (without id — the server mints it). Validated against the shared identityAdapterDescriptorSchema: discriminated by 'kind' ('oidc-jwt' | 'session' | 'custom'); verifiable kinds require https issuer/jwksUri, a non-wildcard audience, and asymmetric-only allowedAlgorithms; maxAssurance may only lower the kind ceiling ('oidc-jwt' → 'verified', others → 'asserted')."},"name":{"type":"string","minLength":1,"maxLength":255},"provider":{"$ref":"#/components/schemas/V1IdentityIntegrationsIdPatchRequestBodyContentApplicationJsonSchemaProvider"},"status":{"$ref":"#/components/schemas/V1IdentityIntegrationsIdPatchRequestBodyContentApplicationJsonSchemaStatus"}}}}}},"security":[{"BearerAuth":[]}]}},"/v1/identity/token":{"post":{"operationId":"identityIntegrations_getAnAgentAccessToken","summary":"Get an agent access token","description":"OAuth 2.0 token endpoint for agents running outside Runtype. An external agent authenticates as the OAuth client (`private_key_jwt`, `client_secret_basic` or `client_secret_post`) and gets a short-lived RFC 9068 access token whose `sub` is `agent:<agentId>` and whose `aud` is the requested resource, when the agent audience policy allows that resource. Errors follow RFC 6749 §5.2. Responses are never cached.","tags":["identityIntegrations"],"responses":{"200":{"description":"The issued token.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentAccessTokenResponse"}}}},"400":{"description":"The request was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentAccessTokenError"}}}},"401":{"description":"Client authentication failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentAccessTokenError"}}}},"429":{"description":"Too many token requests.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentAccessTokenError"}}}},"500":{"description":"No token was issued.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentAccessTokenError"}}}},"503":{"description":"Issuance is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentAccessTokenError"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"actor_token":{"type":"string","description":"Not accepted; the actor is the authenticated client."},"audience":{"type":"string","description":"Not accepted; name the target with `resource`."},"client_assertion":{"type":"string","description":"A JWT signed with a registered key (`private_key_jwt`): `iss` and `sub` are the agent ID, `aud` is the agents issuer, `jti` is unique, and `exp - iat` is at most 300 seconds."},"client_assertion_type":{"$ref":"#/components/schemas/V1IdentityTokenPostRequestBodyContentApplicationXWwwFormUrlencodedSchemaClientAssertionType"},"client_id":{"type":"string","description":"The agent ID. Required with `client_secret`; optional with a client assertion, whose `sub` names the agent."},"client_secret":{"type":"string","description":"An `rt_agent_sk_` client secret (`client_secret_post`). Prefer HTTP Basic or a client assertion."},"grant_type":{"$ref":"#/components/schemas/V1IdentityTokenPostRequestBodyContentApplicationXWwwFormUrlencodedSchemaGrantType","description":"Always `client_credentials`. Token exchange returns `unsupported_grant_type`."},"resource":{"type":"string","description":"The canonical resource URI (RFC 8707) the token is for, for example `https://mcp.example.com/mcp`. It must be on the agent audience policy for the principal grant."},"scope":{"type":"string","description":"Space-separated scopes; each must be allowed by the policy entry for `resource`."}},"required":["grant_type","resource"]}}}}}},"/v1/agent-aliases":{"get":{"operationId":"agentAliases_listReleaseAliasesWithOneNameAcrossTheOrganization","summary":"List release aliases with one name across the organization","description":"Every agent in the caller's organization that carries a release alias with this name, with the pointer revision to quote back as `If-Match`. This is the read a \"pull request closed\" cleanup makes before archiving each pointer. Archived rows are omitted unless `includeArchived=true`; the built-in `live` alias is readable here like any other name.","tags":["agentAliases"],"parameters":[{"name":"alias","in":"query","description":"The alias name to look for, e.g. `pr-482`.","required":true,"schema":{"type":"string"}},{"name":"includeArchived","in":"query","description":"Pass `true` to include already-archived pointers.","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Release aliases with this name","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Agent_Aliases_listReleaseAliasesWithOneNameAcrossTheOrganization_Response_200"}}}},"400":{"description":"Invalid alias name","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/agents/{id}/aliases":{"get":{"operationId":"agentAliases_listReleaseAliasesForAnAgent","summary":"List release aliases for an agent","description":"List the named pointers that select which immutable version of this agent runs. `live` sorts first, then the preview aliases by name. Archived aliases are omitted unless `includeArchived=true`. Omitting `limit` returns every pointer; supplying it pages through the same order with `cursor`.","tags":["agentAliases"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"includeArchived","in":"query","description":"Pass `true` to include archived aliases, which never resolve for execution.","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","description":"Maximum aliases to return. Omit for the full set.","required":false,"schema":{"type":"string"}},{"name":"cursor","in":"query","description":"The `nextCursor` from a previous page of this same order.","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Release aliases","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Agent_Aliases_listReleaseAliasesForAnAgent_Response_200"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Agent not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/agents/{id}/aliases/{alias}":{"get":{"operationId":"agentAliases_getOneReleaseAlias","summary":"Get one release alias","description":"Read one pointer. A missing or archived alias answers a structured 404 naming the alias; it never falls back to live.","tags":["agentAliases"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"alias","in":"path","required":true,"schema":{"type":"string"}},{"name":"includeArchived","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Release alias","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Agent_Aliases_getOneReleaseAlias_Response_200"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Alias or agent not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetOneReleaseAliasRequestNotFoundError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]},"put":{"operationId":"agentAliases_activateAVersionAtAReleaseAlias","summary":"Activate a version at a release alias","description":"Aim one alias at one immutable version of the same agent, appending a deployment receipt in the same transaction. Moving an existing `live` pointer requires the AGENTS:DEPLOY:LIVE scope and an `If-Match` revision; preview aliases require AGENTS:DEPLOY:PREVIEW. Dependency references the version names are fingerprinted first, and an unresolvable reference refuses the activation. Activating a preview alias renews its 14-day expiry; `live` never expires.","tags":["agentAliases"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"alias","in":"path","required":true,"schema":{"type":"string"}},{"name":"if-match","in":"header","description":"The alias revision this write expects. Required on a `live` alias that already exists (428 without it) and refused with 412 when the stored revision has moved on. Optional on preview aliases and on the first `live` deployment, which has no revision yet.","required":false,"schema":{"type":"string"}},{"name":"idempotency-key","in":"header","description":"Replay key. Repeating an activation with the same key returns the receipt the first call produced instead of moving the pointer twice.","required":false,"schema":{"type":"string","maxLength":255}}],"responses":{"200":{"description":"Alias activated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Agent_Aliases_activateAVersionAtAReleaseAlias_Response_200"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Agent or version not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Idempotency key already used for a different activation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActivateAVersionAtAReleaseAliasRequestConflictError"}}}},"412":{"description":"Alias revision mismatch","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActivateAVersionAtAReleaseAliasRequestPreconditionFailedError"}}}},"422":{"description":"Version references a dependency that no longer resolves","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActivateAVersionAtAReleaseAliasRequestUnprocessableEntityError"}}}},"428":{"description":"If-Match required for the live alias","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActivateAVersionAtAReleaseAliasRequestPreconditionError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"promotion":{"$ref":"#/components/schemas/AgentDeploymentPromotion"},"reason":{"type":"string","maxLength":2000,"description":"Why this deployment happened, recorded on the receipt for humans. Context only: nothing branches on it."},"versionId":{"type":"string","minLength":1}},"required":["versionId"]}}}},"security":[{"BearerAuth":[]}]},"delete":{"operationId":"agentAliases_archiveAReleaseAlias","summary":"Archive a release alias","description":"Archive a preview alias: it stops resolving for new executions, keeps its deployment history, and does not interrupt admitted runs. The row is never deleted, so a later activation revives the same pointer. `live` cannot be archived.","tags":["agentAliases"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"alias","in":"path","required":true,"schema":{"type":"string"}},{"name":"if-match","in":"header","description":"The alias revision this write expects. Required on a `live` alias that already exists (428 without it) and refused with 412 when the stored revision has moved on. Optional on preview aliases and on the first `live` deployment, which has no revision yet.","required":false,"schema":{"type":"string"}},{"name":"idempotency-key","in":"header","description":"Replay key. Repeating an activation with the same key returns the receipt the first call produced instead of moving the pointer twice.","required":false,"schema":{"type":"string","maxLength":255}}],"responses":{"200":{"description":"Alias archived","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Agent_Aliases_archiveAReleaseAlias_Response_200"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Alias or agent not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArchiveAReleaseAliasRequestNotFoundError"}}}},"409":{"description":"The live alias cannot be archived","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArchiveAReleaseAliasRequestConflictError"}}}},"412":{"description":"Alias revision mismatch","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArchiveAReleaseAliasRequestPreconditionFailedError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/agents/{id}/aliases/{alias}/bindings":{"get":{"operationId":"agentAliases_readTheSecretBindingNamesOfAReleaseAlias","summary":"Read the secret binding names of a release alias","description":"The per-alias secret binding NAMES this pointer carries. A binding value is write-only: no read surface returns it, and it never appears on a receipt, an audit envelope or a log line.","tags":["agentAliases"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"alias","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Binding names","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Agent_Aliases_readTheSecretBindingNamesOfAReleaseAlias_Response_200"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Alias or agent not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReadTheSecretBindingNamesOfAReleaseAliasRequestNotFoundError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]},"put":{"operationId":"agentAliases_replaceTheSecretBindingsOfAReleaseAlias","summary":"Replace the secret bindings of a release alias","description":"Replace the complete set of `{{secret:NAME}}` values executions resolve when they reach this agent through this pointer. A binding wins over the organization secret of the same name, so one preview per pull request can aim its HTTP tools at that pull request environment while the version content stays byte-identical to what `live` runs. Whole-set replacement: a name you stop sending stops resolving. Values are encrypted at rest and never returned. Names beginning RUNTYPE_, PLATFORM_, CLOUDFLARE_ or INTERNAL_ are refused because they are platform-resolved before the alias plane. A change bumps the alias revision and appends a `bind` receipt; an identical set writes nothing. Requires the same deploy scope as activating this alias.","tags":["agentAliases"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"alias","in":"path","required":true,"schema":{"type":"string"}},{"name":"if-match","in":"header","description":"The alias revision this write expects. Required on a `live` alias that already exists (428 without it) and refused with 412 when the stored revision has moved on. Optional on preview aliases and on the first `live` deployment, which has no revision yet.","required":false,"schema":{"type":"string"}},{"name":"idempotency-key","in":"header","description":"Replay key. Repeating an activation with the same key returns the receipt the first call produced instead of moving the pointer twice.","required":false,"schema":{"type":"string","maxLength":255}}],"responses":{"200":{"description":"Bindings replaced","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Agent_Aliases_replaceTheSecretBindingsOfAReleaseAlias_Response_200"}}}},"400":{"description":"Binding name or value rejected","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReplaceTheSecretBindingsOfAReleaseAliasRequestBadRequestError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Alias or agent not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReplaceTheSecretBindingsOfAReleaseAliasRequestNotFoundError"}}}},"412":{"description":"Alias revision mismatch","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReplaceTheSecretBindingsOfAReleaseAliasRequestPreconditionFailedError"}}}},"428":{"description":"If-Match required for the live alias","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReplaceTheSecretBindingsOfAReleaseAliasRequestPreconditionError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"bindings":{"type":"object","additionalProperties":{"type":"string"},"description":"The complete binding set, NAME to value. An empty object clears every binding."},"reason":{"type":"string","maxLength":2000,"description":"Why this binding write happened, recorded on the receipt for humans."}},"required":["bindings"]}}}},"security":[{"BearerAuth":[]}]},"delete":{"operationId":"agentAliases_clearTheSecretBindingsOfAReleaseAlias","summary":"Clear the secret bindings of a release alias","description":"Remove every per-alias secret binding from this pointer, so its executions fall back to the organization secrets. Equivalent to replacing the set with an empty object.","tags":["agentAliases"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"alias","in":"path","required":true,"schema":{"type":"string"}},{"name":"if-match","in":"header","description":"The alias revision this write expects. Required on a `live` alias that already exists (428 without it) and refused with 412 when the stored revision has moved on. Optional on preview aliases and on the first `live` deployment, which has no revision yet.","required":false,"schema":{"type":"string"}},{"name":"idempotency-key","in":"header","description":"Replay key. Repeating an activation with the same key returns the receipt the first call produced instead of moving the pointer twice.","required":false,"schema":{"type":"string","maxLength":255}}],"responses":{"200":{"description":"Bindings cleared","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Agent_Aliases_clearTheSecretBindingsOfAReleaseAlias_Response_200"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Alias or agent not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClearTheSecretBindingsOfAReleaseAliasRequestNotFoundError"}}}},"412":{"description":"Alias revision mismatch","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClearTheSecretBindingsOfAReleaseAliasRequestPreconditionFailedError"}}}},"428":{"description":"If-Match required for the live alias","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClearTheSecretBindingsOfAReleaseAliasRequestPreconditionError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/agents/{id}/aliases/{alias}/rollback":{"post":{"operationId":"agentAliases_rollAReleaseAliasBackToItsPreviousVersion","summary":"Roll a release alias back to its previous version","description":"Re-aim an alias at the version recorded as `previousVersionId` on its most recent pointer-moving receipt, walking `steps` receipts back. Writes a `rollback` receipt. Rolling back `live` follows the same scope and `If-Match` rules as activation, and restores configuration only: external data and side effects are not rolled back.","tags":["agentAliases"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"alias","in":"path","required":true,"schema":{"type":"string"}},{"name":"if-match","in":"header","description":"The alias revision this write expects. Required on a `live` alias that already exists (428 without it) and refused with 412 when the stored revision has moved on. Optional on preview aliases and on the first `live` deployment, which has no revision yet.","required":false,"schema":{"type":"string"}},{"name":"idempotency-key","in":"header","description":"Replay key. Repeating an activation with the same key returns the receipt the first call produced instead of moving the pointer twice.","required":false,"schema":{"type":"string","maxLength":255}}],"responses":{"200":{"description":"Alias rolled back","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Agent_Aliases_rollAReleaseAliasBackToItsPreviousVersion_Response_200"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Alias, agent, or rollback target not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RollAReleaseAliasBackToItsPreviousVersionRequestNotFoundError"}}}},"412":{"description":"Alias revision mismatch","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RollAReleaseAliasBackToItsPreviousVersionRequestPreconditionFailedError"}}}},"422":{"description":"Target version references a dependency that no longer resolves","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RollAReleaseAliasBackToItsPreviousVersionRequestUnprocessableEntityError"}}}},"428":{"description":"If-Match required for the live alias","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RollAReleaseAliasBackToItsPreviousVersionRequestPreconditionError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"reason":{"type":"string","maxLength":2000},"steps":{"type":"integer","minimum":1,"maximum":50,"default":1}}}}}},"security":[{"BearerAuth":[]}]}},"/v1/agents/{id}/deployments":{"get":{"operationId":"agentAliases_listDeploymentReceiptsForAnAgent","summary":"List deployment receipts for an agent","description":"The append-only deployment history of this agent, newest first, cursor-paginated. Each receipt records the pointer, the previous and new versions, the alias revision, the actor, provenance and the dependency fingerprints checked at activation.","tags":["agentAliases"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"alias","in":"query","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"string"}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Deployment receipts","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Agent_Aliases_listDeploymentReceiptsForAnAgent_Response_200"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Agent not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/agent-feedback":{"post":{"operationId":"agentFeedback_reportAProblem","summary":"Report a problem","description":"Report a problem with the Runtype API, MCP tools, documentation, SDKs, CLI, or dashboard. Built for coding agents: include a category, a short note, and the affected request ID or URL. Any API key can submit, and submitting costs no credits. Secret-looking values in the note are redacted before storage.","tags":["agentFeedback"],"responses":{"202":{"description":"Feedback received","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Agent_Feedback_reportAProblem_Response_202"}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many reports in a short window","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"category":{"$ref":"#/components/schemas/V1AgentFeedbackPostRequestBodyContentApplicationJsonSchemaCategory","description":"Which part of Runtype the problem is in."},"note":{"type":"string","minLength":1,"maxLength":2000,"description":"Short description of the problem: what you tried, what you expected, and what happened."},"requestId":{"type":"string","minLength":1,"maxLength":200,"description":"The affected request, execution, or record ID, when there is one."},"toolName":{"type":"string","minLength":1,"maxLength":200,"description":"The MCP tool, SDK method, or CLI command involved, when there is one."},"url":{"type":"string","minLength":1,"maxLength":2048,"description":"The affected endpoint path or documentation URL, when there is one."}},"required":["category","note"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/agent-versions/{agentId}":{"get":{"operationId":"agentVersions_listVersionsForAnAgent","summary":"List versions for an agent","tags":["agentVersions"],"parameters":[{"name":"agentId","in":"path","required":true,"schema":{"type":"string"}},{"name":"type","in":"query","required":false,"schema":{"$ref":"#/components/schemas/V1AgentVersionsAgentIdGetParametersType"}}],"responses":{"200":{"description":"Agent versions list","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Agent_Versions_listVersionsForAnAgent_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Agent not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalError"}}}},"503":{"description":"Database temporarily unavailable; nothing was read or written. Retry after the `Retry-After` interval (seconds).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatabaseUnavailableError"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/agent-versions/{agentId}/propose":{"post":{"operationId":"agentVersions_proposeANewAgentVersion","summary":"Propose a new agent version","description":"Append a version carrying new instructions and aim a preview alias at it. The agent row, its draft pointer, the published version and the `live` alias do not move, so no run reaches it unless it names the alias. Repeating the same instructions changes nothing.","tags":["agentVersions"],"parameters":[{"name":"agentId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"The proposed version","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Agent_Versions_proposeANewAgentVersion_Response_200"}}}},"400":{"description":"Invalid input, or the agent type cannot be proposed against","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Agent not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalError"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"alias":{"type":"string","minLength":1,"description":"The preview alias to aim at it. Defaults to `otto-proposed-` plus the label as a slug, or a hash of the instructions when there is no label."},"label":{"type":"string","maxLength":255},"notes":{"type":"string","description":"Why this version exists: the evidence for it, shown in version history."},"systemPrompt":{"type":"string","minLength":1,"description":"The full instructions this version proposes."}},"required":["systemPrompt"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/agent-versions/{agentId}/publish":{"post":{"operationId":"agentVersions_publishASpecificAgentVersion","summary":"Publish a specific agent version","description":"Apply an immutable version to the live agent row and move the `live` release alias, in one transaction. Until the omitted-selector cutover this is the writer that changes what actually executes, so it is the verb a live deployment uses; the alias activate route owns preview pointers. Supplying `If-Match` opts this call into the same protected-live compare-and-swap the alias routes enforce.","tags":["agentVersions"],"parameters":[{"name":"agentId","in":"path","required":true,"schema":{"type":"string"}},{"name":"if-match","in":"header","description":"The `live` alias revision this publish expects. Optional: omitting it keeps the historical last-writer-wins behavior for existing callers. When present and stale, the publish is refused with 412 and nothing is written.","required":false,"schema":{"type":"string"}},{"name":"idempotency-key","in":"header","description":"Replay key. Repeating a publish with the same key returns the receipt the first call produced instead of moving the pointer twice.","required":false,"schema":{"type":"string","maxLength":255}}],"responses":{"200":{"description":"Version published","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Agent_Versions_publishASpecificAgentVersion_Response_200"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublishASpecificAgentVersionRequestBadRequestError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Publishing would overwrite a definition managed by code, the idempotency key was already used for a different version, or a declared rollback does not aim at the version the live receipt chain says it replaced","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublishASpecificAgentVersionRequestConflictError"}}}},"412":{"description":"The live alias moved since the revision this publish quoted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublishASpecificAgentVersionRequestPreconditionFailedError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalError"}}}},"503":{"description":"Database temporarily unavailable; nothing was read or written. Retry after the `Retry-After` interval (seconds).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatabaseUnavailableError"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"deployment":{"$ref":"#/components/schemas/V1AgentVersionsAgentIdPublishPostRequestBodyContentApplicationJsonSchemaDeployment"},"onConflict":{"$ref":"#/components/schemas/V1AgentVersionsAgentIdPublishPostRequestBodyContentApplicationJsonSchemaOnConflict","default":"error","description":"Use overwrite only after confirming replacement of a code-managed agent."},"versionId":{"type":"string","minLength":1}},"required":["versionId"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/agent-versions/{agentId}/published":{"get":{"operationId":"agentVersions_getThePublishedVersionForAnAgent","summary":"Get the published version for an agent","tags":["agentVersions"],"parameters":[{"name":"agentId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Published agent version","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Agent_Versions_getThePublishedVersionForAnAgent_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalError"}}}},"503":{"description":"Database temporarily unavailable; nothing was read or written. Retry after the `Retry-After` interval (seconds).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatabaseUnavailableError"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/agent-versions/{agentId}/{versionId}":{"get":{"operationId":"agentVersions_getASpecificAgentVersion","summary":"Get a specific agent version","tags":["agentVersions"],"parameters":[{"name":"agentId","in":"path","required":true,"schema":{"type":"string"}},{"name":"versionId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Agent version detail","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Agent_Versions_getASpecificAgentVersion_Response_200"}}}},"400":{"description":"Version does not belong to this agent","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalError"}}}},"503":{"description":"Database temporarily unavailable; nothing was read or written. Retry after the `Retry-After` interval (seconds).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatabaseUnavailableError"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/agents":{"get":{"operationId":"agents_listAgents","summary":"List agents","description":"Get all agents for the authenticated user with filtering and cursor pagination.","tags":["agents"],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"string"}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"}},{"name":"includeCount","in":"query","required":false,"schema":{"type":"string"}},{"name":"search","in":"query","required":false,"schema":{"type":"string"}},{"name":"agentType","in":"query","description":"Filter to a single agent type.","required":false,"schema":{"$ref":"#/components/schemas/V1AgentsGetParametersAgentType"}},{"name":"managedInCode","in":"query","description":"Filter by code provenance. `true` returns only agents whose `lastModifiedSource` is `sdk` or `terraform`; `false` returns every other agent, including one with no recorded source.","required":false,"schema":{"$ref":"#/components/schemas/V1AgentsGetParametersManagedInCode"}},{"name":"model","in":"query","description":"Filter by `config.model`, case-insensitive: an agent matches when its model id equals or starts with this value (`claude-sonnet` matches `claude-sonnet-4-5`).","required":false,"schema":{"type":"string","minLength":1,"maxLength":255}},{"name":"view","in":"query","description":"Response representation. `full` (default) preserves complete values; `compact` shortens every string value longer than 100 characters to a 100-character preview followed by `…`.","required":false,"schema":{"$ref":"#/components/schemas/V1AgentsGetParametersView"}}],"responses":{"200":{"description":"Paginated list of agents","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Agents_listAgents_Response_200"}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]},"post":{"operationId":"agents_createAgent","summary":"Create agent","description":"Create a new agent with optional capabilities and configuration. Supports runtype, external, and claude_managed agent types. External-agent auth credentials are accepted on write but returned as <redacted>; a configuration copied from a management response must replace that placeholder with the real credential before create.","tags":["agents"],"responses":{"201":{"description":"Agent created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Agents_createAgent_Response_201"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Feature not available","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Feature not available in production","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"agentType":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaAgentType","default":"runtype"},"capabilities":{"type":"array","items":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaCapabilitiesItems"}},"claudeManagedConfig":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaClaudeManagedConfig"},"config":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfig"},"description":{"type":"string"},"externalConfig":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaExternalConfig"},"icon":{"type":"string","maxLength":50},"maxTurns":{"type":"integer","minimum":1,"maximum":100},"name":{"type":"string","minLength":1},"primaryFlowId":{"description":"primaryFlowId is retired: primary-flow agents were removed (ADR 0024). Attach the flow to the agent as a runtime tool ({ toolType: 'flow', flowId }) or dispatch the flow directly via POST /v1/dispatch.","deprecated":true}},"required":["name"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/agents/ensure":{"post":{"operationId":"agents_ensureAgentConfigAsCodeConverge","summary":"Ensure agent (config-as-code converge)","description":"Idempotently converge a repo-defined agent definition onto the platform. Identity is name + account scope. Hash-only probes skip the payload in the steady state (a miss is a normal 200 `definitionRequired` response, not an error); full requests create the agent or append a new version when the canonical content hash differs. Non-executing: never touches the execution pipeline. The response always carries the server-computed canonical hash. Set dryRun to plan without writing (CI drift gate), onConflict: \"overwrite\" to converge over dashboard/API edits, and deploy: { alias } to atomically save and activate the definition at a release alias (release: \"publish\" / \"none\" remain compatibility spellings of deploy live / save-only, and mixing the two is a 400). A non-live deploy is alias-scoped: it appends a candidate version and moves that one pointer, and never writes the agent row, its config hash, its capabilities, its draft pointer or its live pointer, so \"unchanged\" is decided against the hash stored on the alias rather than against the live row. onConflict, expectedRemoteHash and managed-by-code provenance describe live-row writes and therefore do not apply to a non-live deploy; remoteHash in the response is the hash the alias carried before. The one exception is an agent name that does not exist yet: the create is the live row (there is nothing to preview against), and live is still not aimed. Optional version.label / version.notes stamp provenance (a git SHA, a release tag) on the appended version row.","tags":["agents"],"responses":{"200":{"description":"Converge result: unchanged | created | updated | definitionRequired (hash miss — retry with the full definition) | plan (dryRun)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentEnsureResponse"}}}},"400":{"description":"Validation error, unsupported agent type, or code alias_requires_organization when a non-live deploy targets a personal-scope agent","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentEnsureBadRequest"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflict: external_modification (last write was not ensure; pass onConflict: \"overwrite\") or remote_changed (expectedRemoteHash guard)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentEnsureConflict"}}}},"422":{"description":"Submitted contentHash does not match the server-recomputed canonical hash","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentEnsureHashMismatch"}}}},"500":{"description":"Internal server error, or code alias_activation_failed when a non-live activation could not be applied (nothing was written)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentEnsureServerError"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"capabilities":{"type":"array","items":{"$ref":"#/components/schemas/AgentEnsureCapability"},"description":"The complete set of capabilities (flow, sub-agent and saved-tool attachments) on this agent, in display order. Each entry names its source by name, so the declaration is portable across accounts. Capabilities on the agent but absent here are removed; omit the field to leave them untouched. When present, the capabilities are part of the content hash and of the version this converge snapshots. They are written to the agent itself, so they cannot accompany a non-live deploy."},"contentHash":{"type":"string","pattern":"^[0-9a-f]{64}$"},"definition":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinition"},"deploy":{"$ref":"#/components/schemas/AgentEnsureDeployTarget"},"dryRun":{"type":"boolean"},"expectedRemoteHash":{"type":"string","pattern":"^[0-9a-f]{64}$"},"name":{"type":"string","minLength":1},"onConflict":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaOnConflict"},"release":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaRelease","description":"Compatibility input, translated to a deploy: \"publish\" activates live, \"none\" saves without activating. Prefer deploy."},"skills":{"type":"array","items":{"$ref":"#/components/schemas/AgentEnsureSkillBinding"},"description":"The complete set of skills bound to this agent, in load order. Each entry names a skill by slug; `version` pins that skill versionNumber, and omitting it follows the skill's published version. Skills bound to the agent but absent here are unbound; omit the field to leave bindings untouched. Bindings are agent state, not alias state, so they take effect immediately and cannot accompany a non-live deploy."},"version":{"$ref":"#/components/schemas/EnsureVersionMetadata"}},"required":["name"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/agents/fetch-agent-card":{"post":{"operationId":"agents_fetchExternalAgentCard","summary":"Fetch external agent card","description":"Proxy-fetch an external agent card from a URL, avoiding CORS issues. The URL is validated against SSRF attacks. With `transport: \"device\"`, the card is fetched through the paired local listener `deviceId`, so the URL must be a loopback address on that machine. Pass `bearerToken` when the card itself requires one.","tags":["agents"],"responses":{"200":{"description":"Agent card JSON","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Agents_fetchExternalAgentCard_Response_200"}}}},"400":{"description":"Invalid URL or non-JSON response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Failed to fetch agent card from remote","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"bearerToken":{"type":"string","minLength":1,"maxLength":4096,"description":"Sent as `Authorization: Bearer` on the card request. Never stored or echoed."},"deviceId":{"type":"string","minLength":1,"maxLength":128,"description":"The paired listener to fetch through. Required when transport is \"device\"."},"transport":{"$ref":"#/components/schemas/V1AgentsFetchAgentCardPostRequestBodyContentApplicationJsonSchemaTransport","description":"How to reach the card: directly (default) or through a paired local listener"},"url":{"type":"string","format":"uri"}},"required":["url"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/agents/pull":{"get":{"operationId":"agents_pullAgentDefinitionConfigAsCode","summary":"Pull agent definition (config-as-code)","description":"Return the canonical config-as-code definition and provenance for an agent by name — the absorb-drift direction of the ensure protocol. The contentHash is recomputed from the live agent state, so it is accurate even immediately after a dashboard edit.","tags":["agents"],"parameters":[{"name":"name","in":"query","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Canonical definition + provenance","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentPullResponse"}}}},"400":{"description":"Invalid parameters or unsupported agent type","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No agent with that name in the account scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/agents/{id}":{"get":{"operationId":"agents_getAgentDetails","summary":"Get agent details","description":"Get an agent by ID including its capabilities and configuration. External-agent auth credentials are write-only: a configured externalConfig.auth.credentials value is returned as <redacted>, never plaintext.","tags":["agents"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Agent details with capabilities","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Agents_getAgentDetails_Response_200"}}}},"400":{"description":"Invalid agent ID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Agent not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]},"put":{"operationId":"agents_updateAgent","summary":"Update agent","description":"Update an existing agent. Supports partial updates — only provided fields are changed. Both config and externalConfig are merged onto the stored values, so a partial write preserves keys it omits (notably externalConfig.protocol and externalConfig.cachedAgentCard). To REMOVE a value, send it explicitly as null: a null field clears that field, and externalConfig: null clears the whole object. Nested values replace atomically — sending auth replaces the entire auth block, so switching auth type cannot reuse the previous credential. Agent management responses return a configured auth.credentials value as <redacted>; echoing that placeholder on an update preserves the stored credential only when auth.type is unchanged. Repointing an A2A external agent (endpoint, agentCardUrl, protocol, transport or deviceId) re-fetches and caches the agent card from its new location, as create does, and rejects the update with 400 or 502 when no card can be fetched; an explicitly sent cachedAgentCard is kept as sent, and switching to the runtype-stream protocol discards the card. Moving externalConfig.endpoint to a different host additionally requires re-sending externalConfig.auth: a stored credential is never carried to a host it was not configured against, so a repoint that omits auth is rejected with 400. When auth.credentials is a {{secret:NAME}} reference, re-sending that same reference with the new endpoint repoints the agent without the caller ever handling the token; the 400 names the stored reference so a client that only sees <redacted> can re-send it.","tags":["agents"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"if-match","in":"header","description":"The updatedAt value last loaded. A stale revision returns 409 without saving.","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Agent updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Agents_updateAgent_Response_200"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Feature not available","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Agent not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"The saved agent revision changed; local edits were not saved","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"agentType":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaAgentType"},"capabilityChanges":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaCapabilityChanges","description":"Capability additions and removals committed with the definition and its draft snapshot. If-Match guards the entire save."},"claudeManagedConfig":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaClaudeManagedConfig"},"config":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfig"},"description":{"type":"string"},"externalConfig":{"oneOf":[{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaExternalConfig"},{"type":"null"}]},"icon":{"type":"string","maxLength":50},"maxTurns":{"type":"integer","minimum":1,"maximum":100},"name":{"type":"string","minLength":1},"primaryFlowId":{"description":"primaryFlowId is retired: primary-flow agents were removed (ADR 0024). Attach the flow to the agent as a runtime tool ({ toolType: 'flow', flowId }) or dispatch the flow directly via POST /v1/dispatch.","deprecated":true}}}}}},"security":[{"BearerAuth":[]}]},"delete":{"operationId":"agents_deleteAgent","summary":"Delete agent","description":"Delete an agent and cascade-delete its capabilities.","tags":["agents"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Agent deleted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Agents_deleteAgent_Response_200"}}}},"400":{"description":"Invalid agent ID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Agent not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/agents/{id}/approve":{"post":{"operationId":"agents_resolveAPendingAgentToolApproval","summary":"Resolve a pending agent tool approval","description":"Resolve a pending tool approval on a paused agent execution (approved/denied). Streams a Server-Sent Events response when streamResponse is true (default); otherwise returns a JSON result.","tags":["agents"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Server-Sent Events stream of agent execution events (or a JSON result when streamResponse is false)","content":{"text/event-stream":{"schema":{"$ref":"#/components/schemas/ExecutionStreamEvent"}}}},"400":{"description":"Invalid request body","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Platform-key spend limit exceeded during a buffered continuation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentApprovalContinuationJsonResponse"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Agent or execution not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Execution is not awaiting this approval or cannot be resumed here","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"The paused execution was armed by the retired legacy flow engine and cannot be resumed (LEGACY_PAUSE_UNRESUMABLE); re-run the flow","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":{"description":"Any type"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/agents/{id}/capabilities":{"post":{"operationId":"agents_addCapabilityToAgent","summary":"Add capability to agent","description":"Add a capability (flow, sub-agent, or tool binding) to an agent.","tags":["agents"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Capability added","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Agents_addCapabilityToAgent_Response_201"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Agent not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Tool name already exists for this agent","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"enabled":{"type":"boolean"},"flowId":{"type":"string"},"parametersSchema":{"description":"Any type"},"subAgentId":{"type":"string"},"toolDescription":{"type":"string"},"toolId":{"type":"string"},"toolName":{"type":"string","minLength":1,"maxLength":100}},"required":["toolName"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/agents/{id}/capabilities/{capabilityId}":{"delete":{"operationId":"agents_removeCapabilityFromAgent","summary":"Remove capability from agent","description":"Remove a capability (flow, sub-agent, or tool binding) from an agent.","tags":["agents"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"capabilityId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Capability removed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Agents_removeCapabilityFromAgent_Response_200"}}}},"400":{"description":"Invalid agent or capability ID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions (AGENTS:WRITE required)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Agent or capability not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/agents/{id}/conversations/{conversationId}/events":{"get":{"operationId":"agents_listInternalAgentConversationEvents","summary":"List internal agent conversation events","description":"List provenance-bearing internal events posted to a saved agent conversation, including detached subagent completion activities. These events are never represented as human messages.","tags":["agents"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"conversationId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"limit","in":"query","required":false,"schema":{"type":"string"}},{"name":"after","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Conversation event list in chronological order","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Agents_listInternalAgentConversationEvents_Response_200"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Agent not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/agents/{id}/credentials":{"get":{"operationId":"agents_listAgentCredentials","summary":"List agent credentials","description":"Every credential an external agent has held for the agent token endpoint, newest first. Secrets are never returned.","tags":["agents"],"parameters":[{"name":"id","in":"path","description":"Agent ID","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"The credentials","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentCredentialList"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Agent or credential not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/agents/{id}/credentials/keys":{"post":{"operationId":"agents_registerAnAgentPublicKey","summary":"Register an agent public key","description":"Register a public JWK the external agent signs `private_key_jwt` client assertions with. Symmetric keys, keys with private members and algorithms outside the allowlist are refused.","tags":["agents"],"parameters":[{"name":"id","in":"path","description":"Agent ID","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"The registered key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentCredential"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Agent or credential not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegisterAgentPublicKeyRequest"}}}},"security":[{"BearerAuth":[]}]}},"/v1/agents/{id}/credentials/secrets":{"post":{"operationId":"agents_createAnAgentClientSecret","summary":"Create an agent client secret","description":"Create an `rt_agent_sk_` client secret for the token endpoint. It is shown once. An agent holds at most two active secrets, so you can rotate without downtime: create the new one, switch the agent, then revoke the old one.","tags":["agents"],"parameters":[{"name":"id","in":"path","description":"Agent ID","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"The new secret","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentClientSecretCreated"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Agent or credential not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateAgentClientSecretRequest"}}}},"security":[{"BearerAuth":[]}]}},"/v1/agents/{id}/credentials/{credentialId}/revoke":{"post":{"operationId":"agents_revokeAnAgentCredential","summary":"Revoke an agent credential","description":"Revoke a key or secret. The next token request that uses it fails; tokens already issued expire within 300 seconds.","tags":["agents"],"parameters":[{"name":"id","in":"path","description":"Agent ID","required":true,"schema":{"type":"string"}},{"name":"credentialId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"The revoked credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentCredential"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Agent or credential not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/agents/{id}/execute":{"post":{"operationId":"agents_executeAgent","summary":"Execute agent","description":"Execute an agent with a message array. Streams a Server-Sent Events response when streamResponse is true (default); otherwise returns a JSON result. Send the RFC 7240 `Prefer: respond-async` header to receive a durable execution handle immediately, then poll its status URL for completion. The optional `durability` body field pins the lane for this request (`forced`: `durable` or `in_process`) or bounds its attached watch (`watchLeaseMs`), and outranks the saved agent config.","tags":["agents"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"x-runtype-concurrency","in":"header","description":"How a durable turn handles overlap. `reject` (default) answers CONVERSATION_BUSY naming the occupant execution, its phase, and a Retry-After; `supersede` cancels and replaces; `queue` runs afterward; `steer` durably appends new user-message deltas to the same execution at a safe boundary, attaches through the host's slot claim when the host has not started yet, or starts the next execution if completion wins. Steer requires a conversationId, preserves configuration and authority, cannot combine with coalesce, and rejects unsupported lanes. `auto` sends the same user-message deltas as steer and lets a classifier choose: while a turn runs, a message that belongs to it steers and an independent one queues as the next turn; with nothing running it is an ordinary turn with no route report. A routed or downgraded answer reports the route in `X-Runtype-Busy-Message-Route` / `-Source` (plus `-Probability` and `-Model` when the classifier answered) and, on JSON bodies, `busyMessageRoute`. Where auto cannot route (in-process execution, stored history, no conversationId, coalesce, Prefer: respond-async) it keeps the default admission and reports source `disabled`. Other policies remain ignored on in-process execution.","required":false,"schema":{"$ref":"#/components/schemas/V1AgentsIdExecutePostParametersXRuntypeConcurrency"}},{"name":"x-runtype-coalesce","in":"header","description":"Send `true` to fold this request into an already-pending turn for the same conversation instead of starting a second one. The response is the pending execution. Any other value (or omitting the header) starts a new turn.","required":false,"schema":{"$ref":"#/components/schemas/V1AgentsIdExecutePostParametersXRuntypeCoalesce"}},{"name":"idempotency-key","in":"header","description":"Caller-chosen key that makes admission idempotent: a retry with the same key returns the ORIGINAL execution rather than starting a second turn, and consumes no additional quota. Scoped to the durable lane.","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Server-Sent Events stream of agent execution events (or a JSON result when streamResponse is false)","content":{"text/event-stream":{"schema":{"$ref":"#/components/schemas/ExecutionStreamEvent"}}}},"400":{"description":"Invalid agent ID or request body, or an external agent that opts into identity assertion called with no identity to assert (IDENTITY_ASSERTION_UNAVAILABLE; the agent was not called)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExecuteAgentRequestBadRequestError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Agent not found, a version selector that names no pointer (alias_not_found, alias_archived, alias_expired, version_not_found), or a saved agent with no runnable live version (AGENT_NOT_DEPLOYED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Organization model configuration needs configuration, the durable conversation is busy (CONVERSATION_BUSY names the occupant execution and its phase; honor Retry-After or steer it with x-runtype-concurrency: steer), or a `history: \"stored\"` turn lost the compare-and-swap on its conversation (CONVERSATION_MODIFIED; nothing ran, re-read the conversation and retry)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExecuteAgentRequestConflictError"}}}},"413":{"description":"A `history: \"stored\"` turn could not be stored: the conversation is already at the record payload limit. Nothing ran.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExecutionFailedError"}}}},"502":{"description":"An external agent call failed upstream: rejected credentials, rate limited, an HTTP error, a network failure, or an invalid response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Asynchronous execution unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"An external agent call timed out","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":{"description":"Any type"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/agents/{id}/executions":{"get":{"operationId":"agents_listAgentExecutions","summary":"List agent executions","description":"Deprecated: use `GET /v1/runs?agentId={id}`, the single run list for every agent and flow run, including runs dispatched with `storeResults: false` that write no row here. This endpoint stays available and unchanged. It reads the control-plane `agent_executions` table only. List execution history for an agent with cursor pagination. Rows include `finalOutput` by default; pass `view=compact` for the lighter projection that omits it and previews long strings. Supports cross-agent subagent drill-down via parentExecutionId or executionId filters.","tags":["agents"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"string"}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"}},{"name":"includeCount","in":"query","required":false,"schema":{"type":"string"}},{"name":"status","in":"query","required":false,"schema":{"$ref":"#/components/schemas/V1AgentsIdExecutionsGetParametersStatus"}},{"name":"surfaceType","in":"query","required":false,"schema":{"type":"string"}},{"name":"agentSource","in":"query","description":"Only runs recorded with this agent source; `external` selects runs ingested from outside Runtype (OTLP / compatibility ingest).","required":false,"schema":{"$ref":"#/components/schemas/V1AgentsIdExecutionsGetParametersAgentSource"}},{"name":"from","in":"query","required":false,"schema":{"type":"string"}},{"name":"to","in":"query","required":false,"schema":{"type":"string"}},{"name":"parentExecutionId","in":"query","required":false,"schema":{"type":"string"}},{"name":"executionId","in":"query","required":false,"schema":{"type":"string"}},{"name":"view","in":"query","description":"Response representation. `full` (default) preserves complete values and includes each row's `finalOutput`; `compact` omits `finalOutput` and shortens every remaining string value longer than 100 characters to a 100-character preview followed by `…`.","required":false,"schema":{"$ref":"#/components/schemas/V1AgentsIdExecutionsGetParametersView"}}],"responses":{"200":{"description":"Paginated list of agent executions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Agents_listAgentExecutions_Response_200"}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Agent not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"deprecated":true,"security":[{"BearerAuth":[]}]}},"/v1/agents/{id}/executions/{executionId}":{"get":{"operationId":"agents_getExecutionDetail","summary":"Get execution detail","description":"Get full details for a single agent execution including final output, iteration details, and loop configuration.","tags":["agents"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"executionId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Execution detail","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Agents_getExecutionDetail_Response_200"}}}},"400":{"description":"Invalid ID format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Execution not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/agents/{id}/executions/{executionId}/cancel":{"post":{"operationId":"agents_cancelADetachedAgentExecution","summary":"Cancel a detached agent execution","description":"Request cooperative cancellation of a running detached subagent. Repeated cancellation is idempotent.","tags":["agents"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"executionId","in":"path","required":true,"schema":{"type":"string"}},{"name":"conversationId","in":"query","description":"Required when the detached run belongs to a parent conversation.","required":false,"schema":{"type":"string","minLength":1}}],"responses":{"202":{"description":"Cancellation accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Agents_cancelADetachedAgentExecution_Response_202"}}}},"400":{"description":"Invalid ID format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Execution not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Execution is not cancellable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/agents/{id}/executions/{executionId}/events":{"get":{"operationId":"agents_streamExecutionEvents","summary":"Stream execution events","description":"Reconnect to a durable agent turn: replay-and-tail its Server-Sent Events. A turn that streams over an expired watch lease ends with `await` / `awaitReason: \"detached\"` while the execution keeps running; pass the last seen SSE `id:` as `after` to rejoin it. The session owner is resolved from the execution's own persisted record — its conversation for a top-level turn, its private child thread for a subagent run — and the optional `conversationId` is used only for a turn that persists no record of its own. Replays buffered events strictly past the `after` cursor, then live-tails if the turn is still running. Each event carries an SSE `id:` line — a durable row seq, or (unified vocabulary) a composite `<seq>.<subIndex>` when one durable row translates to multiple events. Pass that id verbatim after any disconnect (tab reload, sleep, stream timeout) to resume without missing or duplicating events. Replayed and live-tailed frames use the unified execution vocabulary. A Runtype session turn's response carries `X-Runtype-Execution-Driver`, the driver holding the turn when the stream attached: `request-worker` or `workflow-leg` while that driver holds it, otherwise `owner`.","tags":["agents"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"executionId","in":"path","required":true,"schema":{"type":"string"}},{"name":"conversationId","in":"query","description":"Fallback session key, honored only for a turn that persists no execution record of its own (the Claude Managed lane). A durable turn resolves its session owner from the persisted execution, and a subagent run from its private child thread.","required":false,"schema":{"type":"string","minLength":1}},{"name":"after","in":"query","description":"Replay only events strictly past this cursor (the last seen SSE id, passed verbatim): a plain row seq, or the composite `<seq>.<subIndex>` a unified-vocabulary stream stamps on intermediate sub-frames. Defaults to 0 (replay the whole turn).","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Server-Sent Events stream (buffered replay followed by a live tail)","content":{"text/event-stream":{"schema":{"$ref":"#/components/schemas/ExecutionStreamEvent"}}}},"400":{"description":"No session owner resolves for this execution","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient API key permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Execution not found, or it addresses no durable session","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Failed to attach to the execution stream","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/agents/{id}/executions/{executionId}/tool-calls":{"get":{"operationId":"agents_listToolCalls","summary":"List tool calls","description":"List tool calls for a single agent execution. Returns a compact payload without input/output JSON — use the detail endpoint for full payloads. `executionId` is the execution row id (`aex_…`) or the run id the stream reports (`exec_…`). A call paused at an approval gate is `awaiting_approval` until decided, then carries the outcome; a declined call is `denied`, not `failed`.","tags":["agents"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"executionId","in":"path","description":"The execution row id (`aex_…`) or the run id the stream reports (`exec_…`).","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Tool calls for the execution","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Agents_listToolCalls_Response_200"}}}},"400":{"description":"Invalid ID format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Agent or execution not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/agents/{id}/executions/{executionId}/tool-calls/{toolCallId}":{"get":{"operationId":"agents_getToolCallDetail","summary":"Get tool call detail","description":"Get full payload for a single tool call including input parameters and output result.","tags":["agents"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"executionId","in":"path","required":true,"schema":{"type":"string"}},{"name":"toolCallId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Full tool call detail","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Agents_getToolCallDetail_Response_200"}}}},"400":{"description":"Invalid ID format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Tool call not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/agents/{id}/export-runtime":{"get":{"operationId":"agents_exportAgentForRuntime","summary":"Export agent for runtime","description":"Export a fully-resolved, self-contained agent definition that the @runtypelabs/runtime package can consume directly at boot. Capabilities, flows, and nested sub-agents are inlined recursively (up to 3 levels). Skills bound to the agent are snapshotted into `skills`, each with the skill version it resolved to, and the runtime loads them with no host wiring. MCP credential values and external-agent auth credentials are replaced with secret-name references. A configured `decision_judge` tool carries its published question set (questions, model, version, input mapping and current calibration) at `config.questionSet`, resolved once at export so a self-hosted runtime never looks the question set up; a question set that is missing, unpublished, owned by another account, or pinned to an unpublished version is reported in `warnings` with reason `question_set_unresolved` instead of failing the export. An export that would carry a literal credential typed into a tool config or MCP server is refused with `422` and code `raw_credential_in_export`. Requires the `RUNTIME:EXPORT` scope and an Enterprise plan (the `byoc` entitlement); an unentitled account receives `403` with code `BYOC_PLAN_REQUIRED` in every environment.\n\nThe response carries `hostDependencies`: the runtime seams the exported artifact needs a host to wire before it can run everything it describes. A durable-class step (`wait-until` or `crawl`) anywhere in the agent's executable closure declares a `durable-pause-host` dependency; a detached-capable dynamic subagent pool or a detached inline subagent tool declares a `background-run-coordinator` dependency; an account-owned tool reference (`mcp:` or `builtin:` integration id) the export did not inline declares a `hosted-tool-resolver` dependency; and an enabled record step (`upsert-record`, `update-record`, `get-record`, `list-records`, `retrieve-record`) declares a `record-store` dependency. The array is empty when nothing needs wiring.\n\nThe response also carries `warnings`: each referenced sub-agent or flow the export could not embed, with the reason (`not_found`, `claude_managed_unsupported`, `max_depth_exceeded` for nesting deeper than 3 levels, `invalid_flow_config`, `unresolved_tool_ref`, or `unsupported_mcp_auth`), and each configured decision tool whose question set could not be resolved (`question_set_unresolved`). The export still returns `200` and leaves the referencing capability or tool out of the artifact; a decision tool stays in, without `config.questionSet`. The array is empty when every child was embedded.\n\nPass at most one release selector. `versionId` exports that published version; `alias` exports the version a release alias (for example `staging`, `live` or `pr-42`) currently points at, resolved exactly as the execution selector `agent: { agentId, alias }` resolves it. With neither, the export follows the agent's default target: the version its `live` alias names when the org runs on release aliases, otherwise the agent's current definition. A version-backed export carries `release` with the resolved `versionId`, plus `alias` and `aliasRevision` when an alias selected it. An unknown version or alias, or an archived or expired alias, answers `404`.","tags":["agents"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"versionId","in":"query","description":"Export this published agent version. Mutually exclusive with `alias`.","required":false,"schema":{"type":"string","minLength":1}},{"name":"alias","in":"query","description":"Export the version this release alias currently points at. Mutually exclusive with `versionId`.","required":false,"schema":{"type":"string","minLength":1}},{"name":"format","in":"query","description":"`json` (the default) returns the exported definition. `bundle` returns a vendorable `application/zip` with `agent.json` (the same definition), `runtime/` (the prebuilt `@runtypelabs/runtime` ESM package for the platform runtime version, installable as `file:./runtime`), `manifest.json`, and `LICENSE` (the runtime ships under FSL-1.1-ALv2).","required":false,"schema":{"$ref":"#/components/schemas/V1AgentsIdExportRuntimeGetParametersFormat"}}],"responses":{"200":{"description":"Exported agent definition, or with `format=bundle` a zip archive. Two bundle exports of the same version are byte-identical. The bundle `manifest.json` records the runtime version and source commit, the agent `versionId`/alias, the entrypoints, `hostDependencies`, `warnings`, and `contentHash`: sha256 over the `sha256sum` listing (`<sha256>  <path>` lines sorted by path) of every file except `manifest.json`. The same hash is sent in the `X-Runtype-Bundle-Content-Hash` header.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Agents_exportAgentForRuntime_Response_200"}}}},"400":{"description":"Invalid agent ID, or both `versionId` and `alias` were supplied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions, or the account plan does not include runtime extraction (code `BYOC_PLAN_REQUIRED`, Enterprise plans only)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Agent not found, or the selected version or alias does not exist, is archived, or has expired","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"The agent type cannot export a selected version (code `selector_unsupported_agent_type`), or the export would carry a literal credential (code `raw_credential_in_export`; `details` names each tool or MCP server field without echoing the value)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RuntimeExportError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"With `format=bundle`: the prebuilt runtime artifact for this platform version is not available (code `RUNTIME_ARTIFACT_UNAVAILABLE`, with a `reason` such as `artifact_missing`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/agents/{id}/publish":{"post":{"operationId":"agents_publishAgent","summary":"Publish agent","description":"Snapshot the current live agent state and promote it to a published version.","tags":["agents"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Agent published successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Agents_publishAgent_Response_200"}}}},"400":{"description":"Invalid agent ID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Agent not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/agents/{id}/refresh-agent-card":{"post":{"operationId":"agents_refreshCachedAgentCard","summary":"Refresh cached agent card","description":"Re-fetch the agent card from the configured agentCardUrl (or derived A2A well-known URL) and update the cached copy. Detects skill changes, auto-applies roles to new skills, and returns a change report. External-agent auth credentials remain write-only and are returned as <redacted>.","tags":["agents"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Updated agent with change report","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Agents_refreshCachedAgentCard_Response_200"}}}},"400":{"description":"Invalid agent ID, not an external agent, or no agent card URL","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Agent not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Failed to fetch agent card from remote","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/agents/{id}/resume":{"post":{"operationId":"agents_resumeAPausedAgentExecution","summary":"Resume a paused agent execution","description":"Resume a paused agent execution by supplying local tool outputs. Streams a Server-Sent Events response when streamResponse is true (default); otherwise returns a JSON result.","tags":["agents"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Server-Sent Events stream of agent execution events (or a JSON result when streamResponse is false)","content":{"text/event-stream":{"schema":{"$ref":"#/components/schemas/ExecutionStreamEvent"}}}},"400":{"description":"Invalid request body","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Platform-key spend limit exceeded during a buffered continuation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentResumeContinuationJsonResponse"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Agent or execution not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"The paused execution was armed by the retired legacy flow engine and cannot be resumed (LEGACY_PAUSE_UNRESUMABLE); re-run the flow","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":{"description":"Any type"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/agents/{id}/run-insights":{"get":{"operationId":"agents_rollUpRecentRunsOfAnAgent","summary":"Roll up recent runs of an agent","description":"Aggregates the agent's most recent runs into per-version and per-tool counts, average tokens and cost, and the attached tools that were never called in the window. Backs the run-detail advice strip; the counts are evidence about a version, not billing figures.","tags":["agents"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","description":"How many recent runs to roll up (default 50, max 200)","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Run insights for the agent","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Agents_rollUpRecentRunsOfAnAgent_Response_200"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Agent not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/agents/{id}/runs":{"get":{"operationId":"agents_listManagedAgentRuns","summary":"List managed agent runs","description":"List the durable per-turn run summaries for a saved Claude Managed agent, newest first, optionally scoped to one conversation. Each row is written when a managed turn settles. Auth: agent ownership + AGENTS:READ (the same trust level as the events reconnect route).","tags":["agents"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"conversationId","in":"query","description":"Scope to a single conversation key.","required":false,"schema":{"type":"string","minLength":1}},{"name":"limit","in":"query","description":"Max rows to return (default 50, capped at 200).","required":false,"schema":{"type":"integer","minimum":1,"maximum":200}}],"responses":{"200":{"description":"The agent run summaries","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Agents_listManagedAgentRuns_Response_200"}}}},"400":{"description":"Invalid agent ID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Agent not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/agents/{id}/runs/{runId}":{"get":{"operationId":"agents_getAManagedAgentRun","summary":"Get a managed agent run","description":"Fetch one durable run summary plus its deliverable pointers (the swept `/mnt/session/outputs/` files; the bytes live in asset storage). Auth: agent ownership + AGENTS:READ.","tags":["agents"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"runId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"The run summary and its deliverables","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Agents_getAManagedAgentRun_Response_200"}}}},"400":{"description":"Invalid agent ID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Agent or run not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/agents/{id}/token-audience-policy":{"get":{"operationId":"agents_getTheAgentTokenAudiencePolicy","summary":"Get the agent token audience policy","description":"The resources this agent may get tokens for, with the grants, scopes and TTL ceiling of each.","tags":["agents"],"parameters":[{"name":"id","in":"path","description":"Agent ID","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"The policy","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TokenAudiencePolicy"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Agent or credential not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]},"put":{"operationId":"agents_replaceTheAgentTokenAudiencePolicy","summary":"Replace the agent token audience policy","description":"Replace every entry of the policy at once. Each change increases `policyRevision`, takes effect on the next token request, and is audited with you as the actor. Resource URIs are stored in canonical form.","tags":["agents"],"parameters":[{"name":"id","in":"path","description":"Agent ID","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"The new policy","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReplaceTokenAudiencePolicyResponse"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Agent or credential not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReplaceTokenAudiencePolicyRequest"}}}},"security":[{"BearerAuth":[]}]}},"/v1/agents/{id}/voice":{"post":{"operationId":"agents_executeAgentVoiceTextToSpeech","summary":"Execute agent voice (text-to-speech)","description":"Generate speech audio for the given text using the agent voice configuration (ElevenLabs TTS).","tags":["agents"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Generated audio result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Agents_executeAgentVoiceTextToSpeech_Response_200"}}}},"400":{"description":"Invalid agent ID or missing text parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions or agent does not support voice","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Agent not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":{"description":"Any type"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/agents/{id}/voice/drafts":{"post":{"operationId":"agents_createAVoiceTestDraft","summary":"Create a voice test draft","description":"Hold an unsaved agent definition for about 15 minutes so a browser voice call can run it instead of the saved agent, without saving or publishing. The body is merged onto the saved agent exactly as `PUT /agents/{id}` would merge it, and nothing is written to the agent. Runtype agents only; the merged config must have voice enabled.","tags":["agents"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Draft created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateVoiceAgentDraftResponse"}}}},"400":{"description":"Invalid agent ID or draft configuration","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Agent not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"The agent is not a Runtype agent, or the draft has voice disabled","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Draft storage is unavailable in this environment","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequest"}}}},"security":[{"BearerAuth":[]}]}},"/v1/analytics/end-user-conversations":{"get":{"operationId":"analytics_getProductConversationsByEndUser","summary":"Get product conversations by end user","description":"Rank the verified end users of a product by widget conversations (or messages) started in the window. Conversations from visitors without a verified identity are reported as a separate unattributed total. Known limitation: a conversation linked to its end user only through the widget visitor (not stamped with the end user itself, as in product- or tenant-scoped surfaces) loses that link when the visitor is deleted after its idle TTL (default 90 days, configurable via `visitorIdleDays`). Such conversations then move from that end user to the unattributed total, so counts for older windows can drop over time.","tags":["analytics"],"parameters":[{"name":"productId","in":"query","required":true,"schema":{"type":"string","minLength":1}},{"name":"productTenantId","in":"query","required":false,"schema":{"type":"string","minLength":1}},{"name":"period","in":"query","required":false,"schema":{"$ref":"#/components/schemas/V1AnalyticsEndUserConversationsGetParametersPeriod"}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":93}},{"name":"sort","in":"query","required":false,"schema":{"$ref":"#/components/schemas/V1AnalyticsEndUserConversationsGetParametersSort","default":"conversations"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":200,"default":50}}],"responses":{"200":{"description":"End-user conversation breakdown","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Analytics_getProductConversationsByEndUser_Response_200"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Feature or product not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/analytics/end-user-usage":{"get":{"operationId":"analytics_getProductUsageByEndUser","summary":"Get product usage by end user","description":"Get a retained, product-scoped breakdown of executions and platform spend by projected end user.","tags":["analytics"],"parameters":[{"name":"productId","in":"query","required":true,"schema":{"type":"string","minLength":1}},{"name":"productTenantId","in":"query","required":false,"schema":{"type":"string","minLength":1}},{"name":"period","in":"query","required":false,"schema":{"$ref":"#/components/schemas/V1AnalyticsEndUserUsageGetParametersPeriod"}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":93}},{"name":"sort","in":"query","required":false,"schema":{"$ref":"#/components/schemas/V1AnalyticsEndUserUsageGetParametersSort","default":"spend"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":200,"default":50}}],"responses":{"200":{"description":"End-user usage breakdown","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Analytics_getProductUsageByEndUser_Response_200"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Feature or product not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/analytics/record-results":{"get":{"operationId":"analytics_getRecordResults","summary":"Get record results","description":"Get all record results for the current user with filtering and pagination. When a `days` parameter is provided, returns aggregated daily execution analytics instead of paginated results.","tags":["analytics"],"parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"string"}},{"name":"page","in":"query","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"string"}},{"name":"status","in":"query","required":false,"schema":{"type":"string"}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Record results or aggregated daily analytics","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Analytics_getRecordResults_Response_200"}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/analytics/stats":{"get":{"operationId":"analytics_getAnalyticsStats","summary":"Get analytics stats","description":"Get user analytics stats (records, prompts, flows, executions, evals, agents, products count). Supports optional `from` and `to` date filters.","tags":["analytics"],"parameters":[{"name":"from","in":"query","required":false,"schema":{"type":"string"}},{"name":"to","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Analytics stats","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Analytics_getAnalyticsStats_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/assets":{"post":{"operationId":"assets_storeAnAsset","summary":"Store an asset","description":"Persist a file to Runtype asset storage and return its descriptor (id, servable URL, content type, size). Provide EXACTLY ONE of `content` (base64-encoded inline bytes) or `url` (a source the server downloads with SSRF protection and a 25 MB cap). Public assets get a permanent public URL; private assets get a 1-hour HMAC-signed URL. Tenant identity is taken from the authenticated caller — identity fields in the body are rejected. Also reachable at POST /v1/runtime/assets (the runtime-family contract consumed by `@runtypelabs/runtime`'s HostedAssetStore).","tags":["assets"],"responses":{"200":{"description":"The stored-asset descriptor","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Assets_storeAnAsset_Response_200"}}}},"400":{"description":"Invalid request body (not exactly one of content/url, invalid base64, …)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StoreAnAssetRequestBadRequestError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"API key lacks ASSETS:WRITE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"The store operation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalError"}}}},"503":{"description":"Asset storage is not configured in this environment","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StoreAnAssetRequestServiceUnavailableError"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Assets_storeAnAsset_Request"}}}},"security":[{"BearerAuth":[]}]}},"/v1/assets/preview/{orgId}/{assetId}":{"get":{"operationId":"assets_previewAsset","summary":"Preview asset","description":"Serve a preview-rendering HTML asset inline with locked-down CSP.","tags":["assets"],"parameters":[{"name":"orgId","in":"path","required":true,"schema":{"type":"string"}},{"name":"assetId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"HTML preview content","content":{"application/octet-stream":{"schema":{"type":"string","format":"binary"}}}},"403":{"description":"Must use storage domain","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Asset not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"Preview expired","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Unsupported content type","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Asset storage not configured","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/assets/{assetId}/extend":{"post":{"operationId":"assets_extendPreviewExpiry","summary":"Extend preview expiry","description":"Re-up a preview page's expiration, keeping the same URL. Defaults to the caller's current plan TTL; pass `expiresInSeconds` to choose a shorter lifetime (the plan TTL is a hard ceiling — longer requests are clamped). Works on live previews and on previews that have already expired (expired pages keep their stored content; only serving is blocked). Applies to preview-rendering assets created by `publish_page` — download assets are not time-gated at the serving layer and cannot be extended.","tags":["assets"],"parameters":[{"name":"assetId","in":"path","description":"Asset ID (e.g. \"asset_01k…\"). A trailing file extension (\".html\") is ignored.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Expiry extended","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Assets_extendPreviewExpiry_Response_200"}}}},"400":{"description":"Asset is not a preview asset","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Asset not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"Stored content no longer exists","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Asset storage not configured","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"expiresInSeconds":{"type":"number","format":"double","description":"New lifetime in seconds (positive integer). Capped at the plan's preview TTL — shorter is honored, longer is clamped. Omit for the plan default."}}}}}},"security":[{"BearerAuth":[]}]}},"/v1/assets/{orgId}/{assetId}":{"get":{"operationId":"assets_getAsset","summary":"Get asset","description":"Serve an asset from R2 storage with proper headers. Public assets served immediately; private assets require signed URL.","tags":["assets"],"parameters":[{"name":"orgId","in":"path","required":true,"schema":{"type":"string"}},{"name":"assetId","in":"path","required":true,"schema":{"type":"string"}},{"name":"sig","in":"query","description":"HMAC-SHA256 signature for private assets","required":false,"schema":{"type":"string"}},{"name":"exp","in":"query","description":"Expiration timestamp for signed URL","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Asset content. The Content-Type reflects the stored asset (e.g. image/png, image/jpeg), defaulting to application/octet-stream.","content":{"application/octet-stream":{"schema":{"type":"string","format":"binary"}}}},"403":{"description":"Access denied or must use storage domain","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Asset not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Asset storage not configured","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/internal-assets/{assetId}":{"get":{"operationId":"assets_getInternalAsset","summary":"Get internal asset","description":"Stream the bytes of an `internal`-visibility asset (offloaded inbound media). Authenticated and scoped to the caller's tenant — internal assets have no public or signed URL and are only readable by their owner.","tags":["assets"],"parameters":[{"name":"assetId","in":"path","description":"Asset ID (e.g. \"asset_01k…\"). A trailing file extension is ignored.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Asset content. Content-Type reflects the stored asset, defaulting to application/octet-stream.","content":{"application/octet-stream":{"schema":{"type":"string","format":"binary"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Asset not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Asset storage not configured","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/auth/me":{"get":{"operationId":"authentication_getCurrentUserInfo","summary":"Get current user info","description":"Get the current user and organization info for the authenticated caller (Clerk session or API key).","tags":["authentication"],"responses":{"200":{"description":"Current user and organization info","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Authentication_getCurrentUserInfo_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/auth/me/workspace":{"post":{"operationId":"authentication_provisionTheCallerWorkspaceOrganization","summary":"Provision the caller workspace organization","description":"Idempotently provision (or resolve) the authenticated user workspace organization (the auto-created org of one). Session auth only; gated by the workspace-model rollout flag.","tags":["authentication"],"responses":{"200":{"description":"Workspace organization provisioned or already present","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Authentication_provisionTheCallerWorkspaceOrganization_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"API-key callers are rejected, or the workspace model is disabled","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProvisionTheCallerWorkspaceOrganizationRequestForbiddenError"}}}},"502":{"description":"Workspace provisioning failed (Clerk error)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/batch/cancel/{id}":{"post":{"operationId":"batch_cancelABatchExecution","summary":"Cancel a batch execution","description":"Cancels a running or queued batch execution.","tags":["batch"],"parameters":[{"name":"id","in":"path","description":"Batch execution ID","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Batch cancelled","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Batch_cancelABatchExecution_Response_200"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/batch/flow":{"post":{"operationId":"batch_submitABatchFlowExecution","summary":"Submit a batch flow execution","description":"Submits a batch of records for flow execution. Checks daily execution limits and feature gating, and refuses up front (422 RUNTIME_LANE_INELIGIBLE) a flow the batch host cannot run.","tags":["batch"],"responses":{"200":{"description":"Batch submitted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Batch_submitABatchFlowExecution_Response_200"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Feature not available","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"The flow uses capabilities the batch host cannot run (RUNTIME_LANE_INELIGIBLE, with `reasons` such as `ineligible:wait-until`). Nothing is queued and no executions are counted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchLaneRefusalError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"description":"Batch flow request body. Target one of flowId, flowDefinition, or agentId; supply recordIds, records, or both. The optional options object accepts the documented execution tunables; unknown or out-of-range option keys are rejected at submission. Legacy snake_case aliases are accepted.","content":{"application/json":{"schema":{"type":"object","properties":{"agentId":{"type":["string","null"],"description":"Agent to execute per record instead of a flow. Saved records are loaded and their conversation read from metadata.messages; inline records reach the agent only when their type is _agent_eval or _agent_schedule and metadata.messages carries the conversation. Any other inline record type fails per record."},"flowDefinition":{"$ref":"#/components/schemas/BatchFlowDefinition"},"flowId":{"type":["string","null"],"description":"Saved flow to execute per record. One of flowId, flowDefinition, or agentId is required."},"inputs":{"type":["object","null"],"additionalProperties":{"description":"Any type"},"description":"Flow input variables applied to every record execution."},"messages":{"type":["array","null"],"items":{"$ref":"#/components/schemas/V1BatchFlowPostRequestBodyContentApplicationJsonSchemaMessagesItems"},"description":"Conversation seed passed unchanged to every record execution. Records cannot see each other's history."},"options":{"oneOf":[{"$ref":"#/components/schemas/V1BatchFlowPostRequestBodyContentApplicationJsonSchemaOptions"},{"type":"null"}]},"recordIds":{"type":["array","null"],"items":{"type":"string"},"description":"Saved record ids to process. May be combined with records; the batch runs the union. At least one of recordIds or records must be non-empty. Maximum 50000 records per batch across both."},"records":{"type":["array","null"],"items":{"$ref":"#/components/schemas/BatchInlineRecord"},"description":"Inline records to process without saving them first. May be combined with recordIds. Maximum 50000 records per batch across both."}}}}}},"security":[{"BearerAuth":[]}]}},"/v1/batch/status/{id}":{"get":{"operationId":"batch_getBatchExecutionStatus","summary":"Get batch execution status","description":"Returns the current status and progress of a batch execution.","tags":["batch"],"parameters":[{"name":"id","in":"path","description":"Batch execution ID","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Batch status","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Batch_getBatchExecutionStatus_Response_200"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Batch not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/batch/summary":{"get":{"operationId":"batch_getBatchSummary","summary":"Get batch summary","description":"Returns a summary of active and recently completed batch executions for the current user.","tags":["batch"],"responses":{"200":{"description":"Batch summary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Batch_getBatchSummary_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/batch/{batchId}/records/{recordId}/cost":{"get":{"operationId":"batch_getPerRecordCostForABatch","summary":"Get per-record cost for a batch","description":"Returns the total cost for a specific record within a batch execution.","tags":["batch"],"parameters":[{"name":"batchId","in":"path","description":"Batch execution ID","required":true,"schema":{"type":"string"}},{"name":"recordId","in":"path","description":"Record ID","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Record cost","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Batch_getPerRecordCostForABatch_Response_200"}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Batch not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/batch/{batchId}/records/{recordId}/steps":{"get":{"operationId":"batch_getStepResultsForABatchRecord","summary":"Get step results for a batch record","description":"Returns per-record step results for a batch execution, ordered as a timeline.","tags":["batch"],"parameters":[{"name":"batchId","in":"path","description":"Batch execution ID","required":true,"schema":{"type":"string"}},{"name":"recordId","in":"path","description":"Record ID","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Step results","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Batch_getStepResultsForABatchRecord_Response_200"}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/batch/{id}/cost":{"get":{"operationId":"batch_getBatchExecutionTotalCost","summary":"Get batch execution total cost","description":"Returns the total cost across all records, flow steps, agent executions, and nested subagents, decomposed by how much the figure can be trusted.","tags":["batch"],"parameters":[{"name":"id","in":"path","description":"Batch execution ID","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Batch cost","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Batch_getBatchExecutionTotalCost_Response_200"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Batch not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/batch/{id}/ws":{"get":{"operationId":"batch_webSocketForRealTimeBatchUpdates","summary":"WebSocket for real-time batch updates","description":"Establishes a WebSocket connection for real-time progress updates on a batch execution.","tags":["batch"],"parameters":[{"name":"id","in":"path","description":"Batch execution ID","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response"},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Batch not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/client-tokens":{"get":{"operationId":"clientTokens_listClientTokens","summary":"List client tokens","description":"Get client tokens for the authenticated user's tenant. Optionally bounded with offset pagination: pass `limit` (1-200) to page; when `limit` is omitted the full list is returned (legacy shape, no `pagination` object).","tags":["clientTokens"],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"string"}},{"name":"offset","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"List of client tokens (with pagination metadata when `limit` is provided)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Client_Tokens_listClientTokens_Response_200"}}}},"400":{"description":"Invalid pagination parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]},"post":{"operationId":"clientTokens_createClientToken","summary":"Create client token","description":"Create a new client token for browser-to-API communication. Returns the plain token value once.","tags":["clientTokens"],"responses":{"201":{"description":"Created client token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Client_Tokens_createClientToken_Response_201"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Referenced flow not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"agentIds":{"type":"array","items":{"type":"string"},"default":[]},"allowedOrigins":{"type":"array","items":{"type":"string"},"description":"Allowed request origins for this token. Each entry is an exact origin (https://app.example.com), a wildcard subdomain (https://*.example.com), '*' for all origins, or the literal 'native' — a sentinel that admits requests carrying NO Origin header (native mobile apps). A token with 'native' has effectively no origin protection and relies on its capability scope."},"config":{"type":"object","additionalProperties":{"description":"Any type"},"default":{}},"defaultFlowId":{"type":"string"},"environment":{"$ref":"#/components/schemas/V1ClientTokensPostRequestBodyContentApplicationJsonSchemaEnvironment","default":"live"},"flowIds":{"type":"array","items":{"type":"string"},"default":[]},"maxMessagesPerSession":{"type":"number","format":"double","minimum":1,"maximum":1000,"default":100},"name":{"type":"string","minLength":1,"maxLength":255},"pinToVersion":{"type":"string","default":"latest","description":"Legacy widget-version mode: 'latest' or 'published'. It has never selected an agent version and still does not. An agent version id (agentver_...) is rejected on create; use targetVersionId to pin a version or targetAlias to follow a release alias. An update may echo back the value already stored."},"productSurfaceId":{"type":"string"},"rateLimitPerHour":{"type":"number","format":"double","minimum":1,"maximum":10000,"default":100},"rateLimitPerMinute":{"type":"number","format":"double","minimum":1,"maximum":1000,"default":10},"revealOnce":{"type":"boolean"},"sessionIdleTimeoutMinutes":{"type":"number","format":"double","minimum":1,"maximum":1440,"default":30},"targetAlias":{"type":["string","null"],"description":"Release alias this token follows. Re-resolved on every admission, so a deploy at that alias changes what the token runs. Mutually exclusive with targetVersionId."},"targetVersionId":{"type":["string","null"],"description":"Exact agent version this token runs. Never re-resolved. Mutually exclusive with targetAlias, and the token must carry exactly one agent id."}},"required":["allowedOrigins","name"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/client-tokens/{id}":{"get":{"operationId":"clientTokens_getClientToken","summary":"Get client token","description":"Get a client token by ID with conversation count.","tags":["clientTokens"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Client token details","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Client_Tokens_getClientToken_Response_200"}}}},"400":{"description":"Invalid client token ID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Client token not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]},"put":{"operationId":"clientTokens_updateClientToken","summary":"Update client token","description":"Update fields on an existing client token.","tags":["clientTokens"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Updated client token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Client_Tokens_updateClientToken_Response_200"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Client token or referenced flow not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"The token was revoked and cannot be reactivated (code CREDENTIAL_REVOKED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CredentialLifecycleError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"agentIds":{"type":"array","items":{"type":"string"}},"allowedOrigins":{"type":"array","items":{"type":"string"},"description":"Allowed request origins for this token. Each entry is an exact origin (https://app.example.com), a wildcard subdomain (https://*.example.com), '*' for all origins, or the literal 'native' — a sentinel that admits requests carrying NO Origin header (native mobile apps). A token with 'native' has effectively no origin protection and relies on its capability scope."},"config":{"type":"object","additionalProperties":{"description":"Any type"}},"defaultFlowId":{"type":"string"},"flowIds":{"type":"array","items":{"type":"string"}},"isActive":{"type":"boolean"},"maxMessagesPerSession":{"type":"number","format":"double","minimum":1,"maximum":1000},"name":{"type":"string","minLength":1,"maxLength":255},"pinToVersion":{"type":"string","description":"Legacy widget-version mode: 'latest' or 'published'. A NEW agent version id (agentver_...) is rejected; echoing back the value already stored is accepted and ignored, so a read-modify-write client can save unrelated fields. Use targetVersionId to pin a version."},"rateLimitPerHour":{"type":"number","format":"double","minimum":1,"maximum":10000},"rateLimitPerMinute":{"type":"number","format":"double","minimum":1,"maximum":1000},"sessionIdleTimeoutMinutes":{"type":"number","format":"double","minimum":1,"maximum":1440},"targetAlias":{"type":["string","null"]},"targetVersionId":{"type":["string","null"]}}}}}},"security":[{"BearerAuth":[]}]},"delete":{"operationId":"clientTokens_deleteClientToken","summary":"Delete client token","description":"Delete a client token by ID.","tags":["clientTokens"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Client token deleted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Client_Tokens_deleteClientToken_Response_200"}}}},"400":{"description":"Invalid client token ID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Client token not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/client-tokens/{id}/conversations":{"get":{"operationId":"clientTokens_listConversationsForClientToken","summary":"List conversations for client token","description":"List conversations associated with a client token using offset pagination.","tags":["clientTokens"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"string"}},{"name":"offset","in":"query","required":false,"schema":{"type":"string"}},{"name":"flow_id","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Paginated conversations","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Client_Tokens_listConversationsForClientToken_Response_200"}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Client token not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/client-tokens/{id}/regenerate":{"post":{"operationId":"clientTokens_regenerateClientToken","summary":"Regenerate client token","description":"Generate a new token value for an existing client token. Invalidates the previous token.","tags":["clientTokens"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Regenerated client token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Client_Tokens_regenerateClientToken_Response_200"}}}},"400":{"description":"Invalid client token ID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Client token not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"The token is inactive (code CREDENTIAL_INACTIVE) or revoked (code CREDENTIAL_REVOKED) and cannot be rotated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CredentialLifecycleError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/client-tokens/{id}/revoke":{"post":{"operationId":"clientTokens_revokeClientToken","summary":"Revoke client token","description":"Permanently revoke a client token. Unlike setting isActive to false, revocation is terminal: the token can never be reactivated or regenerated. Revoking an already-revoked token succeeds.","tags":["clientTokens"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Client token revoked","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Client_Tokens_revokeClientToken_Response_200"}}}},"400":{"description":"Invalid client token ID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Client token not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/client-tokens/{id}/token":{"get":{"operationId":"clientTokens_getClientTokenValue","summary":"Get client token value","description":"Get the plain token value. Returns 400 with a hint if the token was created before token values were stored — use POST /{id}/regenerate to create a fresh value.","tags":["clientTokens"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Token value","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Client_Tokens_getClientTokenValue_Response_200"}}}},"400":{"description":"Invalid ID, or token value not stored (legacy token)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetClientTokenValueRequestBadRequestError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Client token not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/client/agents/{agentId}/voice/prewarm":{"post":{"operationId":"clientRuntime_prewarmBrowserVoiceForAnAgent","summary":"Prewarm browser voice for an agent","description":"Signals intent to start a browser voice call (for example, the pointer entered the microphone button) so the WebSocket connect and first turn find warm state. Authenticated exactly like `/agents/{agentId}/speak`: send the client token as `Authorization: Bearer ct_…`; the token agent allowlist and origin allowlist apply. Returns 204 as soon as the caller is authenticated and warms in the background. The call never bills, reserves quota, or meters usage. Warming is rate-limited per client token and agent; a limited call still returns 204 and does nothing.","tags":["clientRuntime"],"parameters":[{"name":"agentId","in":"path","description":"The voice-enabled agent the call will open.","required":true,"schema":{"type":"string"}},{"name":"sessionId","in":"query","description":"The client session the call will resume, when the host already has one.","required":false,"schema":{"type":"string"}},{"name":"x-visitor-token","in":"header","description":"The visitor proof the call will present, sent the same way the voice WebSocket accepts it.","required":false,"schema":{"type":"string"}}],"responses":{"204":{"description":"Accepted. Warming, if admitted, continues in the background.","content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"401":{"description":"Missing or invalid client token, agent not allowed for the token, or origin not allowed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Malformed agent id","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/client/approve":{"post":{"operationId":"clientRuntime_answerAnEndUserApprovalGate_stream","summary":"Answer an end-user approval gate","description":"Session-authenticated approval for browser client-token sessions. Answers a paused approval whose gate the agent authored with `tools.approval.approver: 'end-user'`, then streams the continued run over Server-Sent Events in the same shape as `/v1/client/resume`. The decision is bound to the session that started the turn, single-use, and bound to the exact reviewed tool parameters; visitors cannot create persistent \"always allow\" grants. A gate with the default `owner` approver is refused with `403 APPROVAL_APPROVER_NOT_END_USER`; answer those with `POST /v1/dispatch/approve`. Does not count against execution limits.","tags":["clientRuntime"],"responses":{"200":{"description":"","content":{"text/event-stream":{"schema":{"$ref":"#/components/schemas/ExecutionStreamEvent"}}}},"400":{"description":"Validation error, or the approvalId does not match the pending approval","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Session not found or expired","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Client token inactive, origin mismatch, execution belongs to another session, or the gate needs the owner (`APPROVAL_APPROVER_NOT_END_USER`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No paused execution found for the executionId, or the approval expired","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"The approval was already resolved (`APPROVAL_ALREADY_RESOLVED`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Neutral service-unavailable response when the owner platform-key spend limit blocks an end-user continuation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"approvalId":{"type":"string","minLength":1,"description":"The `approvalId` from the `approval_start` event this decision answers."},"assistantMessageId":{"type":"string","maxLength":128,"description":"Id for the assistant message this resumed leg produces, so a re-send deduplicates by id. Optional; same contract as `/v1/client/resume`."},"decision":{"$ref":"#/components/schemas/V1ClientApprovePostRequestBodyContentApplicationJsonSchemaDecision"},"executionId":{"type":"string","minLength":1},"reason":{"type":"string","maxLength":2000,"description":"The visitor's own note on the decision, recorded with it. Optional."},"sessionId":{"type":"string","minLength":1},"streamResponse":{"type":"boolean","enum":[true]}},"required":["approvalId","decision","executionId","sessionId","streamResponse"]}}}}}},"/v1/client/chat":{"post":{"operationId":"clientRuntime_sendAClientChatMessage","summary":"Send a client chat message","description":"Send a message for a browser client-token chat session. The request streams flow/agent events over Server-Sent Events. `turnId` and `submitMode` are optional and let newer Persona clients suppress stale interrupted responses; older clients can omit both fields. Opt-in `steer` accepts exactly one new user message whose `id` equals `turnId` for visitor-owned native durable agents. A new execution streams SSE; steering an existing execution returns a 202 delivery receipt without replacing its response. `auto` takes the same shape as `steer` and lets a classifier choose while a turn runs: a message that belongs to the running work steers it (202 delivery receipt), and an independent one queues as the next turn (202 queued handle); with nothing running it is an ordinary turn with no route report. A routed or downgraded answer carries `X-Runtype-Busy-Message-Route` and `X-Runtype-Busy-Message-Source` (plus `-Probability` and `-Model` when the classifier answered), repeated as `busyMessageRoute` on JSON bodies. Where `auto` cannot route (another lane, another message shape) it behaves as `normal` and reports source `disabled`. Retry with the same turn and message IDs. Send `voice: { spoken: true }` when the user turn came from a live voice call and the reply will be spoken by a voice model; the turn then runs with a per-turn instruction to lead with a short, speakable answer, which is not stored in the conversation. Only the fields in the request body schema are supported. The schema has no `options` object, so run options such as `options.stepTimeoutMs` and `options.flowTimeoutMs` cannot be set on this route. To set them, call `POST /v1/dispatch` with an API key.","tags":["clientRuntime"],"responses":{"200":{"description":"SSE stream of chat execution events","content":{"text/event-stream":{"schema":{"$ref":"#/components/schemas/ExecutionStreamEvent"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Session not found or expired, or an `identityProof` was supplied that failed verification (`invalid_identity_proof`, fail-closed: the turn never runs). Identity-proof rejections carry `errorDescription` naming the reason.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SendAClientChatMessageRequestUnauthorizedError"}}}},"403":{"description":"Forbidden. Either the client token is inactive or the origin is not allowed, or the tenancy lock-down refused the execution: the agent requires an end-user scope and no valid `identityProof` was supplied (`end_user_scope_required`), or this session's conversation record belongs to a different signed-in end user (`conversation_scope_mismatch`; start a new conversation), or a Claude Managed target's conversation is not owned by the visitor making the request (`CLIENT_CONVERSATION_NOT_VISITOR_OWNED`; initialize with `durableRecovery: true` and send `X-Visitor-Token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Referenced flow or agent not found, or a saved agent with no runnable live version (AGENT_NOT_DEPLOYED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflict. Either the client tools registry fingerprint was not found (`client_tools_resend_required`; resend the full `clientTools[]` with the fingerprint), this turn was superseded by a newer interrupting turn before it could start (`turn_superseded`), or a Claude Managed target was refused because the caller has not opted into durable turns (`CLAUDE_MANAGED_DURABLE_TURNS_REQUIRED`; `hint` names the exact opt-in) or the session carries no conversation record (`CLAUDE_MANAGED_CONVERSATION_REQUIRED`). A steer refusal uses `STEER_UNAVAILABLE`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Daily execution limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"501":{"description":"Approval-gated execution is unsupported because Client Chat has no continuation channel that can deliver an owner-approved result back to the visitor (`APPROVAL_MODE_UNSUPPORTED`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"assistantMessageId":{"type":"string"},"clientTools":{"type":"array","items":{"$ref":"#/components/schemas/V1ClientChatPostRequestBodyContentApplicationJsonSchemaClientToolsItems"}},"clientToolsFingerprint":{"type":"string","maxLength":128},"delivery":{"$ref":"#/components/schemas/V1ClientChatPostRequestBodyContentApplicationJsonSchemaDelivery","description":"Set to `socket` to receive this turn on the client session socket named by `realtime` in the init response, instead of in this response. When the server honors it, the response is `202 {executionId, conversationId, delivery: \"socket\"}`. Otherwise the turn streams over Server-Sent Events as usual."},"identityProof":{"$ref":"#/components/schemas/V1ClientChatPostRequestBodyContentApplicationJsonSchemaIdentityProof","description":"Customer-native auth proof for the Identity Exchange. When present and the surface has a matching integration, the verified tenant/end-user replace any body-asserted tenant/endUser (which are never trusted for web-embedded callers). A proof that fails verification is rejected with 401 `invalid_identity_proof`."},"inputs":{"type":"object","additionalProperties":{"description":"Any type"}},"messages":{"type":"array","items":{"$ref":"#/components/schemas/V1ClientChatPostRequestBodyContentApplicationJsonSchemaMessagesItems"}},"metadata":{"type":"object","additionalProperties":{"description":"Any type"}},"sessionId":{"type":"string","minLength":1},"submitMode":{"$ref":"#/components/schemas/V1ClientChatPostRequestBodyContentApplicationJsonSchemaSubmitMode"},"turnId":{"type":"string","minLength":1,"maxLength":128},"voice":{"$ref":"#/components/schemas/V1ClientChatPostRequestBodyContentApplicationJsonSchemaVoice","description":"Voice context for this turn. Omit for typed chat; behavior is unchanged when absent."}},"required":["messages","sessionId"]}}}}}},"/v1/client/conversations":{"get":{"operationId":"clientRuntime_listTheVisitorsOwnConversations","summary":"List the visitor's own conversations","description":"List conversations belonging to the calling browser's anonymous visitor, newest first, cursor-paginated. Requires both a live `sessionId` and the `X-Visitor-Token` secret from `/client/init`; the site-wide client token alone can never reach this route. Every response carries `X-History-Identity-Status` (`not_provided` | `admitted`) reporting what the server did with a supplied `X-Identity-Proof`, so a widget can tell a verified action from a browser-scoped one. It is exposed via CORS; it grants no authority.","tags":["clientRuntime"],"parameters":[{"name":"sessionId","in":"query","description":"Client session id from /client/init.","required":true,"schema":{"type":"string"}},{"name":"targetId","in":"query","description":"Only return conversations for this flow or agent id. Pass the `targetId` returned by `/client/init`.","required":false,"schema":{"type":"string"}},{"name":"flowId","in":"query","description":"Deprecated alias of `targetId`. Sending both with different values is rejected 400; sending both with the same value is accepted.","required":false,"schema":{"type":"string"}},{"name":"cursor","in":"query","description":"Opaque cursor returned as `nextCursor` by a previous page. Omit for the first page.","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","description":"Page size as a decimal string. Defaults to 25, clamped to a maximum of 100. A non-numeric or non-positive value falls back to the default.","required":false,"schema":{"type":"string"}},{"name":"x-visitor-token","in":"header","description":"The browser's anonymous visitor secret (`cvt_…`) returned by `/client/init`. It is what scopes the request to one visitor's own conversations, so a request without it is refused. Sent as a header so it never lands in access logs or `Referer`.","required":true,"schema":{"type":"string"}},{"name":"x-identity-proof","in":"header","description":"Optional fresh hosted end-user identity proof. When admitted and already bound to the presented visitor, expands the request from this exact browser to sibling visitors for the same verified person. Without it, even a previously bound visitor remains exact-browser scoped.","required":false,"schema":{"type":"string","minLength":1,"maxLength":8192}}],"responses":{"200":{"description":"Conversations page","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Client_Runtime_listTheVisitorsOwnConversations_Response_200"}}}},"400":{"description":"Missing or malformed `sessionId`, an undecodable `cursor`, `targetId` or `flowId` supplied empty (`invalid_target_filter`), or the two supplied with different values (`conflicting_target_filter`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Session expired, or missing/invalid visitor token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Client token inactive or origin mismatch","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded for this client token or session. The response carries a `Retry-After` header with the advisory wait in seconds.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"operationId":"clientRuntime_deleteAllOfTheVisitorsOwnConversations","summary":"Delete all of the visitor's own conversations","description":"Permanently delete every conversation belonging to the calling visitor, with their transcripts. Intended for a widget's \"clear my history\" control and for host-site privacy-erasure hooks. Pass `targetId` to delete only the conversations a target-scoped UI actually listed; OMITTING it deliberately means every conversation in the authorized visitor scope, across all targets. Every response carries `X-History-Identity-Status` (`not_provided` | `admitted`) reporting what the server did with a supplied `X-Identity-Proof`, so a widget can tell a verified action from a browser-scoped one. It is exposed via CORS; it grants no authority.","tags":["clientRuntime"],"parameters":[{"name":"sessionId","in":"query","description":"Client session id from /client/init.","required":true,"schema":{"type":"string"}},{"name":"targetId","in":"query","description":"Only delete conversations for this flow or agent id, matching the list route's filter. Omit to delete the visitor's entire authorized history. A widget showing one target's history should always send this, so \"clear my history\" cannot remove conversations the visitor was never shown.","required":false,"schema":{"type":"string"}},{"name":"flowId","in":"query","description":"Deprecated alias of `targetId`. Sending both with different values is rejected 400; sending both with the same value is accepted.","required":false,"schema":{"type":"string"}},{"name":"x-visitor-token","in":"header","description":"The browser's anonymous visitor secret (`cvt_…`) returned by `/client/init`. It is what scopes the request to one visitor's own conversations, so a request without it is refused. Sent as a header so it never lands in access logs or `Referer`.","required":true,"schema":{"type":"string"}},{"name":"x-identity-proof","in":"header","description":"Optional fresh hosted end-user identity proof. When admitted and already bound to the presented visitor, expands the request from this exact browser to sibling visitors for the same verified person. Without it, even a previously bound visitor remains exact-browser scoped.","required":false,"schema":{"type":"string","minLength":1,"maxLength":8192}}],"responses":{"200":{"description":"Deleted. `deleted` counts the rows removed and is 0 when the visitor had no history in scope.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Client_Runtime_deleteAllOfTheVisitorsOwnConversations_Response_200"}}}},"400":{"description":"Missing or malformed `sessionId`, `targetId` or `flowId` supplied empty (`invalid_target_filter`), or the two supplied with different values (`conflicting_target_filter`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Session expired, or missing/invalid visitor token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Client token inactive or origin mismatch","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded for this client token or session. The response carries a `Retry-After` header with the advisory wait in seconds.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/client/conversations/{conversationId}/executions/{executionId}/cancel":{"post":{"operationId":"clientRuntime_stopADurableClientExecution","summary":"Stop a durable client execution","description":"Cancel the specified execution without starting a replacement. For a native agent, pending inputs become not applied; for a Claude Managed agent, the hosted session is interrupted and stays resumable. Requires the exact visitor and session bound to the conversation.","tags":["clientRuntime"],"parameters":[{"name":"conversationId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"executionId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"sessionId","in":"query","required":true,"schema":{"type":"string","minLength":1}},{"name":"x-visitor-token","in":"header","description":"The browser's anonymous visitor secret (`cvt_…`) returned by `/client/init`. It is what scopes the request to one visitor's own conversations, so a request without it is refused. Sent as a header so it never lands in access logs or `Referer`.","required":true,"schema":{"type":"string"}},{"name":"x-identity-proof","in":"header","description":"Optional fresh hosted end-user identity proof. When admitted and already bound to the presented visitor, expands the request from this exact browser to sibling visitors for the same verified person. Without it, even a previously bound visitor remains exact-browser scoped.","required":false,"schema":{"type":"string","minLength":1,"maxLength":8192}}],"responses":{"202":{"description":"Cancellation accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Client_Runtime_stopADurableClientExecution_Response_202"}}}},"401":{"description":"Missing or expired session or visitor credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Inactive client token or origin mismatch","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Execution or delivery not owned by this visitor conversation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Execution is already terminal or no longer cancellable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StopADurableClientExecutionRequestConflictError"}}}},"429":{"description":"Visitor request rate exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/client/conversations/{conversationId}/executions/{executionId}/deliveries/{deliveryId}":{"get":{"operationId":"clientRuntime_readALiveInputDeliveryReceipt","summary":"Read a live input delivery receipt","description":"Read whether a joined message is pending, applied, settled, or not applied. Requires the exact visitor and session bound to this conversation.","tags":["clientRuntime"],"parameters":[{"name":"conversationId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"executionId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"deliveryId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"sessionId","in":"query","required":true,"schema":{"type":"string","minLength":1}},{"name":"x-visitor-token","in":"header","description":"The browser's anonymous visitor secret (`cvt_…`) returned by `/client/init`. It is what scopes the request to one visitor's own conversations, so a request without it is refused. Sent as a header so it never lands in access logs or `Referer`.","required":true,"schema":{"type":"string"}},{"name":"x-identity-proof","in":"header","description":"Optional fresh hosted end-user identity proof. When admitted and already bound to the presented visitor, expands the request from this exact browser to sibling visitors for the same verified person. Without it, even a previously bound visitor remains exact-browser scoped.","required":false,"schema":{"type":"string","minLength":1,"maxLength":8192}}],"responses":{"200":{"description":"Durable input delivery receipt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientInputDeliveryReceipt"}}}},"401":{"description":"Missing or expired session or visitor credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Inactive client token or origin mismatch","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Execution or delivery not owned by this visitor conversation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Visitor request rate exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/client/conversations/{id}":{"get":{"operationId":"clientRuntime_readOneOfTheVisitorsOwnConversations","summary":"Read one of the visitor's own conversations","description":"Return a single conversation with its message transcript. Answers 404 (never 403) for a conversation the caller does not own, so the route cannot be used to probe for other visitors' conversations. Every response carries `X-History-Identity-Status` (`not_provided` | `admitted`) reporting what the server did with a supplied `X-Identity-Proof`, so a widget can tell a verified action from a browser-scoped one. It is exposed via CORS; it grants no authority.","tags":["clientRuntime"],"parameters":[{"name":"id","in":"path","description":"Conversation id from the list route.","required":true,"schema":{"type":"string"}},{"name":"sessionId","in":"query","description":"Client session id from /client/init.","required":true,"schema":{"type":"string"}},{"name":"messageCursor","in":"query","description":"Opaque cursor returned as `nextMessageCursor` by a previous detail response. Omit for the newest message page.","required":false,"schema":{"type":"string"}},{"name":"messageLimit","in":"query","description":"Message page size as a decimal string. Defaults to 25 and is clamped to 25 to bound media rehydration and Worker memory.","required":false,"schema":{"type":"string"}},{"name":"x-visitor-token","in":"header","description":"The browser's anonymous visitor secret (`cvt_…`) returned by `/client/init`. It is what scopes the request to one visitor's own conversations, so a request without it is refused. Sent as a header so it never lands in access logs or `Referer`.","required":true,"schema":{"type":"string"}},{"name":"x-identity-proof","in":"header","description":"Optional fresh hosted end-user identity proof. When admitted and already bound to the presented visitor, expands the request from this exact browser to sibling visitors for the same verified person. Without it, even a previously bound visitor remains exact-browser scoped.","required":false,"schema":{"type":"string","minLength":1,"maxLength":8192}}],"responses":{"200":{"description":"Conversation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Client_Runtime_readOneOfTheVisitorsOwnConversations_Response_200"}}}},"400":{"description":"Missing or malformed `sessionId`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Session expired, or missing/invalid visitor token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Client token inactive or origin mismatch","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No such conversation for this visitor","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded for this client token or session. The response carries a `Retry-After` header with the advisory wait in seconds.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"operationId":"clientRuntime_deleteOneOfTheVisitorsOwnConversations","summary":"Delete one of the visitor's own conversations","description":"Permanently delete a conversation and its stored transcript. Answers 404 (never 403) for a conversation the caller does not own. Every response carries `X-History-Identity-Status` (`not_provided` | `admitted`) reporting what the server did with a supplied `X-Identity-Proof`, so a widget can tell a verified action from a browser-scoped one. It is exposed via CORS; it grants no authority.","tags":["clientRuntime"],"parameters":[{"name":"id","in":"path","description":"Conversation id from the list route.","required":true,"schema":{"type":"string"}},{"name":"sessionId","in":"query","description":"Client session id from /client/init.","required":true,"schema":{"type":"string"}},{"name":"x-visitor-token","in":"header","description":"The browser's anonymous visitor secret (`cvt_…`) returned by `/client/init`. It is what scopes the request to one visitor's own conversations, so a request without it is refused. Sent as a header so it never lands in access logs or `Referer`.","required":true,"schema":{"type":"string"}},{"name":"x-identity-proof","in":"header","description":"Optional fresh hosted end-user identity proof. When admitted and already bound to the presented visitor, expands the request from this exact browser to sibling visitors for the same verified person. Without it, even a previously bound visitor remains exact-browser scoped.","required":false,"schema":{"type":"string","minLength":1,"maxLength":8192}}],"responses":{"200":{"description":"Deleted. `deleted` is always 1 on this route.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Client_Runtime_deleteOneOfTheVisitorsOwnConversations_Response_200"}}}},"400":{"description":"Missing or malformed `sessionId`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Session expired, or missing/invalid visitor token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Client token inactive or origin mismatch","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No such conversation for this visitor","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded for this client token or session. The response carries a `Retry-After` header with the advisory wait in seconds.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/client/conversations/{id}/display-projections":{"patch":{"operationId":"clientRuntime_finalizeTheVisibleTextOfStoredMessages","summary":"Finalize the visible text of stored messages","description":"Record what a human actually saw for messages this conversation already stores. A chat client can only compute an assistant message's final visible text after the stream closes and its own parsers, postprocessors, and plugins have run; this is the channel for sending that back, so the transcript reopens showing what the visitor read rather than the model-channel payload. It is projection-only: it can fill or replace `displayContent` and nothing else, never creating a message or touching model content, role, ordering, timestamps, count, ownership, or title. The batch applies all-or-nothing, and the write is guarded by a compare-and-swap on `conversationRevision`, so it can never overwrite a turn the chat path persisted concurrently. Replaying an identical projection is a no-op that performs no write and returns the same `conversationRevision`. A genuinely changed projection advances the revision and refreshes the list `preview`, but deliberately does NOT change `updatedAt` — a closing tab must not reorder the visitor's history. Authorization is exact: the live session must be bound to this conversation, on top of the visitor secret. Small and bounded on purpose, so a client can send it with `keepalive: true` on page exit.","tags":["clientRuntime"],"parameters":[{"name":"id","in":"path","description":"Conversation id — must be this session’s own.","required":true,"schema":{"type":"string"}},{"name":"sessionId","in":"query","description":"Client session id from /client/init.","required":true,"schema":{"type":"string"}},{"name":"x-visitor-token","in":"header","description":"The browser's anonymous visitor secret (`cvt_…`) returned by `/client/init`. It is what scopes the request to one visitor's own conversations, so a request without it is refused. Sent as a header so it never lands in access logs or `Referer`.","required":true,"schema":{"type":"string"}},{"name":"x-identity-proof","in":"header","description":"Optional fresh hosted end-user identity proof. When admitted and already bound to the presented visitor, expands the request from this exact browser to sibling visitors for the same verified person. Without it, even a previously bound visitor remains exact-browser scoped.","required":false,"schema":{"type":"string","minLength":1,"maxLength":8192}}],"responses":{"200":{"description":"Projections finalized (or already current).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Client_Runtime_finalizeTheVisibleTextOfStoredMessages_Response_200"}}}},"400":{"description":"Missing or malformed `sessionId`, or a body that exceeds the per-message / per-batch projection bounds","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Session expired, or missing/invalid visitor token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Client token inactive or origin mismatch","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"This session is not on that conversation, the visitor does not own it, or the batch named a message the conversation does not hold. One non-enumerating answer covers all three: the route never confirms which.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"The conversation changed while the projections were being written and the compare-and-swap kept losing (`conversation_modified`). Nothing was written. Non-fatal: retry, or ignore it and let the next chat turn re-carry the projections through the repair path.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded for this client token or session. The response carries a `Retry-After` header with the advisory wait in seconds.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"messages":{"type":"array","items":{"$ref":"#/components/schemas/V1ClientConversationsIdDisplayProjectionsPatchRequestBodyContentApplicationJsonSchemaMessagesItems"},"description":"Projections to finalize, applied atomically. Total `displayContent` across the batch is capped at 49152 characters so the request fits the browser keepalive budget."}},"required":["messages"]}}}}}},"/v1/client/feedback":{"post":{"operationId":"clientRuntime_submitFeedbackOnAMessage","summary":"Submit feedback on a message","description":"Record message-level (`upvote` / `downvote` / `copy`, requires `messageId`) or conversation-level (`csat` 1-5, `nps` 0-10, requires `rating`) feedback for a client-token session. Requires the client `token` (authenticated like `/init` and `/chat`): the token is verified, its origin allowlist is enforced, and the session lookup is scoped to the token. Idempotent per (session, type, message): a matching prior submission is updated. Expired-but-active sessions are accepted so post-conversation surveys still land.","tags":["clientRuntime"],"responses":{"200":{"description":"Existing feedback updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Client_Runtime_submitFeedbackOnAMessage_Response_200"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubmitFeedbackOnAMessageRequestBadRequestError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalError"}}}},"503":{"description":"Database temporarily unavailable; nothing was read or written. Retry after the `Retry-After` interval (seconds).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatabaseUnavailableError"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"comment":{"type":"string"},"messageId":{"type":"string"},"metadata":{"type":"object","additionalProperties":{"description":"Any type"}},"rating":{"type":"number","format":"double"},"sessionId":{"type":"string","minLength":1},"token":{"type":"string","minLength":1},"type":{"$ref":"#/components/schemas/V1ClientFeedbackPostRequestBodyContentApplicationJsonSchemaType"}},"required":["sessionId","token","type"]}}}}}},"/v1/client/init":{"post":{"operationId":"clientRuntime_initializeAClientSession","summary":"Initialize a client session","description":"Exchange a client token for a browser chat session. Validates the token + request `Origin`, resolves the target flow or agent, and returns the session id plus widget display config. Pass an existing `sessionId` for legacy resume, or a visitor-authorized `conversationId` returned by the history list to reopen a conversation across sessions or verified devices.","tags":["clientRuntime"],"parameters":[{"name":"personaVersion","in":"query","description":"Optional Persona SDK version for telemetry. Does not affect authorization or behavior.","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Session created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Client_Runtime_initializeAClientSession_Response_200"}}}},"400":{"description":"Validation error / flow required or not allowed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Invalid client token, or an `identityProof` was supplied that failed verification (`invalid_identity_proof`, fail-closed: nothing is bound). Identity-proof rejections carry `errorDescription` naming the reason.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InitializeAClientSessionRequestUnauthorizedError"}}}},"403":{"description":"Client token inactive or origin not allowed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Referenced flow, agent, or visitor-authorized conversation not found, or a saved agent with no runnable live version (AGENT_NOT_DEPLOYED). Conversations outside the visitor scope also answer 404.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Client_Runtime_initializeAClientSession_Request"}}}}}},"/v1/client/resume":{"post":{"operationId":"clientRuntime_resumeAPausedClientExecution_stream","summary":"Resume a paused client execution","description":"Session-authenticated sibling of `POST /v1/dispatch/resume` for browser client-token sessions. Resumes a paused local-tool (WebMCP / clientTools) execution by supplying `toolOutputs` keyed by the per-call `toolCallId` (or tool name, legacy). Optionally accepts a refreshed `clientTools[]` + `clientToolsFingerprint` snapshot (same diff-only protocol as `/client/chat`) so page tools registered after a mid-run navigation become callable on the next model turn; the refreshed set is re-validated against the surface WebMCP policy. Streams the continued flow/agent events over Server-Sent Events. Does not count against execution limits.","tags":["clientRuntime"],"responses":{"200":{"description":"","content":{"text/event-stream":{"schema":{"$ref":"#/components/schemas/ExecutionStreamEvent"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Session not found or expired","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Client token inactive, origin mismatch, or execution belongs to another user","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No paused execution found for the executionId","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"The client tools registry fingerprint was not found (`client_tools_resend_required`); resend the full `clientTools[]` with the fingerprint.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"The paused execution was armed by the retired legacy flow engine and cannot be resumed (LEGACY_PAUSE_UNRESUMABLE); re-run the flow","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Neutral service-unavailable response when the owner platform-key spend limit blocks an end-user continuation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"after":{"type":"string","maxLength":128,"default":""},"assistantMessageId":{"type":"string","maxLength":128,"description":"Id for the assistant message this resumed leg produces. The leg's completion is persisted to the conversation, so sending the id the client already uses locally makes a later re-send of that same message deduplicate exactly instead of by text. Optional and backward compatible."},"clientTools":{"type":"array","items":{"$ref":"#/components/schemas/V1ClientResumePostRequestBodyContentApplicationJsonSchemaClientToolsItems"}},"clientToolsFingerprint":{"type":"string","maxLength":128},"delivery":{"$ref":"#/components/schemas/V1ClientResumePostRequestBodyContentApplicationJsonSchemaDelivery","description":"Set to `socket` to receive the resumed turn on the client session socket. When the server honors it, the response is `202 {executionId, conversationId, delivery: \"socket\"}`. Otherwise the resumed turn streams as usual."},"executionId":{"type":"string","minLength":1},"messages":{"type":"array","items":{"$ref":"#/components/schemas/V1ClientResumePostRequestBodyContentApplicationJsonSchemaMessagesItems"}},"sessionId":{"type":"string","minLength":1},"streamResponse":{"type":"boolean","enum":[true]},"toolOutputs":{"type":"object","additionalProperties":{"description":"Any type"},"default":{}}},"required":["executionId","sessionId","streamResponse"]}}}}}},"/v1/client/visitor/reset":{"post":{"operationId":"clientRuntime_resetTheCurrentBrowserVisitor","summary":"Reset the current browser visitor","description":"Explicit widget shutdown/logout lifecycle. Revokes the presented browser visitor when it still resolves, without deleting conversation records. The response is idempotent so it cannot reveal whether a visitor secret was valid. Clear the locally stored secret after success; a later history-capable init creates a clean anonymous visitor. Every response carries `X-History-Identity-Status` (`not_provided` | `admitted`) reporting what the server did with a supplied `X-Identity-Proof`, so a widget can tell a verified action from a browser-scoped one. It is exposed via CORS; it grants no authority.","tags":["clientRuntime"],"parameters":[{"name":"sessionId","in":"query","description":"Live client session id from /client/init.","required":true,"schema":{"type":"string"}},{"name":"x-visitor-token","in":"header","description":"The visitor secret to revoke. Omit when local storage is already empty; reset remains idempotent.","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Visitor reset accepted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Client_Runtime_resetTheCurrentBrowserVisitor_Response_200"}}}},"400":{"description":"Missing or malformed `sessionId`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Session expired","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Client token inactive or origin mismatch","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded for this client token or session. The response carries a `Retry-After` header.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/collections":{"get":{"operationId":"collections_listCollections","summary":"List collections","description":"List record collections for the authenticated owner with cursor pagination. `includeCount=true` adds per-collection record counts.","tags":["collections"],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"string"}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"}},{"name":"includeCount","in":"query","required":false,"schema":{"type":"string"}},{"name":"view","in":"query","description":"Response representation. `full` (default) preserves complete values; `compact` shortens every string value longer than 100 characters to a 100-character preview followed by `…`.","required":false,"schema":{"$ref":"#/components/schemas/V1CollectionsGetParametersView"}}],"responses":{"200":{"description":"Paginated list of collections","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Collections_listCollections_Response_200"}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]},"post":{"operationId":"collections_createACollection","summary":"Create a collection","description":"Register a record type as a collection, optionally with a schema (constrained JSON Schema dialect). `validationMode` defaults to `off` — creating a collection changes no existing behavior.","tags":["collections"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Collections_createACollection_Response_201"}}}},"400":{"description":"Invalid slug, mode, or schema (details carry dialect issues)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateACollectionRequestBadRequestError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Slug already registered","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateACollectionRequestConflictError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"description":{"type":["string","null"],"maxLength":4000},"displayName":{"type":"string","minLength":1,"maxLength":255},"icon":{"type":["string","null"],"maxLength":64},"schema":{"type":["object","null"],"additionalProperties":{"description":"Any type"},"description":"Constrained JSON Schema dialect: root object with string/number/boolean/array/object properties, one nesting level, no $ref/oneOf/pattern"},"slug":{"type":"string","minLength":1,"maxLength":255},"validationMode":{"$ref":"#/components/schemas/V1CollectionsPostRequestBodyContentApplicationJsonSchemaValidationMode"}},"required":["displayName","slug"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/collections/ensure":{"post":{"operationId":"collections_ensureCollectionConfigAsCodeConverge","summary":"Ensure collection (config-as-code converge)","description":"Idempotently converge a repo-defined record collection (display fields, schema and validationMode) onto the platform. Identity is slug + account scope. Hash-only probes skip the payload in the steady state (a miss is a normal 200 `definitionRequired` response); full requests create the collection or update it when the canonical content hash differs. Schema changes follow the same rules as PATCH: they bump schemaVersion and append history, and a breaking change is rejected while the resulting mode is `enforce`. Set dryRun to plan without writing (CI drift gate), and onConflict: \"overwrite\" to converge over dashboard/API edits. Ensure never deletes a collection and never touches records.","tags":["collections"],"responses":{"200":{"description":"Converge result: unchanged | created | updated | definitionRequired (hash miss — retry with the full definition) | plan (dryRun)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionEnsureResponse"}}}},"400":{"description":"Invalid slug or schema, or a breaking schema change while enforcing (BREAKING_SCHEMA_CHANGE_REQUIRES_WARN_MODE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EnsureCollectionConfigAsCodeConvergeRequestBadRequestError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflict: external_modification (last write was not ensure; pass onConflict: \"overwrite\") or remote_changed (expectedRemoteHash guard)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionEnsureConflict"}}}},"422":{"description":"Submitted contentHash does not match the server-recomputed canonical hash","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionEnsureHashMismatch"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"contentHash":{"type":"string","pattern":"^[0-9a-f]{64}$"},"definition":{"$ref":"#/components/schemas/V1CollectionsEnsurePostRequestBodyContentApplicationJsonSchemaDefinition"},"dryRun":{"type":"boolean"},"expectedRemoteHash":{"type":"string","pattern":"^[0-9a-f]{64}$"},"onConflict":{"$ref":"#/components/schemas/V1CollectionsEnsurePostRequestBodyContentApplicationJsonSchemaOnConflict"},"slug":{"type":"string","minLength":1}},"required":["slug"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/collections/types.d.ts":{"get":{"operationId":"collections_generateTypeScriptTypesForSchematizedCollections","summary":"Generate TypeScript types for schematized collections","description":"Emit a TypeScript `.d.ts` module (one interface per schematized collection plus a `declare module '@runtypelabs/sdk'` augmentation of `RecordCollections`) so `client.records.from('<slug>')` types record metadata. Fetch it with `runtype records typegen`; commit and diff-check the output in CI to catch collection-schema drift.","tags":["collections"],"responses":{"200":{"description":"A TypeScript declaration module","content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/collections/{slug}":{"get":{"operationId":"collections_getACollection","summary":"Get a collection","description":"Get a collection by slug. `includeHistory=true` embeds the append-only schema version history.","tags":["collections"],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}},{"name":"includeHistory","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Collection","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Collections_getACollection_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]},"delete":{"operationId":"collections_deleteACollection","summary":"Delete a collection","description":"Delete the collection REGISTRATION only. Records of this type are not touched — they revert to schemaless behavior. Deleting records is a separate, explicit operation.","tags":["collections"],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Deleted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Collections_deleteACollection_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]},"patch":{"operationId":"collections_updateACollection","summary":"Update a collection","description":"Update display fields, validation mode, or the schema. Schema changes are classified additive vs breaking; breaking changes are rejected while the resulting mode is `enforce` (drop to `warn`, migrate, re-enforce). Every schema change bumps `schemaVersion` and appends a history row. When the mode transitions to `enforce`, the response includes `enforceCheck` — a bounded dry-run of existing records against the schema.","tags":["collections"],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Updated collection","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Collections_updateACollection_Response_200"}}}},"400":{"description":"Invalid input, immutable slug (SLUG_IMMUTABLE), or breaking change while enforcing (BREAKING_SCHEMA_CHANGE_REQUIRES_WARN_MODE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateACollectionRequestBadRequestError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateACollectionRequestNotFoundError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"description":{"type":["string","null"],"maxLength":4000},"displayName":{"type":"string","minLength":1,"maxLength":255},"icon":{"type":["string","null"],"maxLength":64},"schema":{"type":["object","null"],"additionalProperties":{"description":"Any type"},"description":"Constrained JSON Schema dialect: root object with string/number/boolean/array/object properties, one nesting level, no $ref/oneOf/pattern"},"slug":{"type":"string","minLength":1,"maxLength":255},"validationMode":{"$ref":"#/components/schemas/V1CollectionsSlugPatchRequestBodyContentApplicationJsonSchemaValidationMode"}}}}}},"security":[{"BearerAuth":[]}]}},"/v1/collections/{slug}/infer-schema":{"post":{"operationId":"collections_inferASchemaFromExistingRecords","summary":"Infer a schema from existing records","description":"Sample the type's most recently updated records and return a PROPOSED dialect-conformant schema with per-field confidence and sample values. Does not save anything — review the proposal, then PATCH the collection. Works for registered and unregistered slugs alike (register-then-infer or infer-then-register).","tags":["collections"],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Schema proposal","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Collections_inferASchemaFromExistingRecords_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"sample":{"type":"integer","minimum":1,"maximum":1000}}}}}},"security":[{"BearerAuth":[]}]}},"/v1/collections/{slug}/pull":{"get":{"operationId":"collections_pullCollectionDefinitionConfigAsCode","summary":"Pull collection definition (config-as-code)","description":"Return the canonical config-as-code definition and provenance for a collection — the absorb-drift direction of the ensure protocol. The contentHash is recomputed from the live collection, so it is accurate even immediately after a dashboard edit.","tags":["collections"],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Canonical definition + provenance","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionPullResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No collection with that slug in the account scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/collections/{slug}/validate-existing":{"post":{"operationId":"collections_dryRunExistingRecordsAgainstASchema","summary":"Dry-run existing records against a schema","description":"Run existing records of the type through a schema WITHOUT writing anything — powers the \"N of M records would fail\" preview before enabling `enforce`. Uses the request-body schema when provided (a proposal), otherwise the collection's saved schema. Capped at 10,000 checked rows; `truncated` reports whether the cap was hit.","tags":["collections"],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Dry-run result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Collections_dryRunExistingRecordsAgainstASchema_Response_200"}}}},"400":{"description":"No schema to validate against, or the proposed schema is invalid","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DryRunExistingRecordsAgainstASchemaRequestBadRequestError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Collection not found (when no proposed schema is supplied)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"schema":{"type":"object","additionalProperties":{"description":"Any type"},"description":"Constrained JSON Schema dialect: root object with string/number/boolean/array/object properties, one nesting level, no $ref/oneOf/pattern"}}}}}},"security":[{"BearerAuth":[]}]}},"/v1/context-templates":{"get":{"operationId":"contextTemplates_listContextTemplates","summary":"List context templates","description":"Get all context templates for the authenticated user with optional type/name filtering and cursor pagination.","tags":["contextTemplates"],"parameters":[{"name":"type","in":"query","required":false,"schema":{"type":"string"}},{"name":"name","in":"query","required":false,"schema":{"type":"string"}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"string"}},{"name":"view","in":"query","description":"Response representation. `full` (default) preserves complete values; `compact` shortens every string value longer than 100 characters to a 100-character preview followed by `…`.","required":false,"schema":{"$ref":"#/components/schemas/V1ContextTemplatesGetParametersView"}}],"responses":{"200":{"description":"Paginated list of context templates","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Context_Templates_listContextTemplates_Response_200"}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]},"post":{"operationId":"contextTemplates_createContextTemplate","summary":"Create context template","description":"Create a new context template. The config is validated based on the template type.","tags":["contextTemplates"],"responses":{"201":{"description":"Created context template","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Context_Templates_createContextTemplate_Response_201"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":{"description":"Any type"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/context-templates/{id}":{"get":{"operationId":"contextTemplates_getContextTemplate","summary":"Get context template","description":"Get a specific context template by ID.","tags":["contextTemplates"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Context template","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Context_Templates_getContextTemplate_Response_200"}}}},"400":{"description":"Invalid context template ID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Context template not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]},"put":{"operationId":"contextTemplates_updateContextTemplate","summary":"Update context template","description":"Update a context template. When config is provided it is validated based on the template type.","tags":["contextTemplates"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Updated context template","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Context_Templates_updateContextTemplate_Response_200"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Context template not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":{"description":"Any type"}}}}},"security":[{"BearerAuth":[]}]},"delete":{"operationId":"contextTemplates_deleteContextTemplate","summary":"Delete context template","description":"Delete a context template by ID.","tags":["contextTemplates"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Context template deleted","content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"400":{"description":"Invalid context template ID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Context template not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/conversations":{"get":{"operationId":"conversations_listConversations","summary":"List conversations","tags":["conversations"],"parameters":[{"name":"source","in":"query","required":false,"schema":{"$ref":"#/components/schemas/V1ConversationsGetParametersSource"}},{"name":"surface_id","in":"query","required":false,"schema":{"type":"string"}},{"name":"client_token_id","in":"query","required":false,"schema":{"type":"string"}},{"name":"ownerId","in":"query","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Conversations list","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Conversations_listConversations_Response_200"}}}},"400":{"description":"Invalid cursor: it was not issued by this endpoint, or the conversation a legacy id cursor names no longer exists. Restart from the first page.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]},"post":{"operationId":"conversations_createAConversation","summary":"Create a conversation","tags":["conversations"],"responses":{"200":{"description":"A conversation with this `source.system` and `source.externalId` was already imported. Nothing was created and the existing conversation is returned with `imported: false`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Conversations_createAConversation_Response_200"}}}},"400":{"description":"Validation error. `code: CONVERSATION_TRANSCRIPT_INVALID` when `messages` breaks the tool-pairing discipline; `details.issues` lists each offending message index.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateAConversationRequestBadRequestError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"The requested agentId names no agent the caller owns","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Metadata violates a registered `conversation` collection schema (enforce mode)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecordSchemaValidationError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"The type's collection schema could not be loaded, so the write was refused rather than left unvalidated; retry","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionLookupFailedError"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"agentId":{"type":"string","minLength":1,"maxLength":255,"description":"Agent (agent_...) this conversation belongs to, stored as metadata.agentId. Must name an agent the caller owns."},"messages":{"type":"array","items":{"$ref":"#/components/schemas/ConversationTranscriptMessage"},"default":[],"description":"Full-fidelity transcript. A tool message must carry toolResults answering an assistant toolCalls entry issued earlier in the array; ids and createdAt are minted when omitted."},"metadata":{"type":"object","additionalProperties":{"description":"Any type"},"default":{}},"modelId":{"type":"string","maxLength":255},"ownerId":{"type":["string","null"],"minLength":1,"maxLength":255,"description":"Owner key for this conversation, stored in the indexed owner_id column and filterable via ?ownerId=. Overrides a nested metadata.ownerId. Null means no owner."},"source":{"$ref":"#/components/schemas/ConversationSource"},"systemPrompt":{"type":"string"},"title":{"type":"string","maxLength":500,"default":"New Chat"}}}}}},"security":[{"BearerAuth":[]}]}},"/v1/conversations/{id}":{"get":{"operationId":"conversations_getConversationWithMessages","summary":"Get conversation with messages","tags":["conversations"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Conversation detail","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Conversations_getConversationWithMessages_Response_200"}}}},"400":{"description":"Invalid conversation ID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Conversation not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]},"put":{"operationId":"conversations_updateAConversation","summary":"Update a conversation","tags":["conversations"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Conversation updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Conversations_updateAConversation_Response_200"}}}},"400":{"description":"Validation error. `code: CONVERSATION_TRANSCRIPT_INVALID` when `messages` breaks the tool-pairing discipline; `details.issues` lists each offending message index.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateAConversationRequestBadRequestError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Conversation not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"`messagesMode: \"append\"` lost the compare-and-swap on the stored transcript (`CONVERSATION_MODIFIED`) because a concurrent write moved it. Nothing was written; re-read the conversation and retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConversationModifiedError"}}}},"422":{"description":"Metadata violates a registered `conversation` collection schema (enforce mode)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecordSchemaValidationError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"The type's collection schema could not be loaded, so the write was refused rather than left unvalidated; retry","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionLookupFailedError"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"agentId":{"type":["string","null"],"minLength":1,"maxLength":255,"description":"Null clears metadata.agentId; omit to leave it unchanged."},"messages":{"type":"array","items":{"$ref":"#/components/schemas/ConversationTranscriptMessage"},"description":"Full-fidelity transcript. A tool message must carry toolResults answering an assistant toolCalls entry issued earlier in the array; ids and createdAt are minted when omitted."},"messagesMode":{"$ref":"#/components/schemas/V1ConversationsIdPutRequestBodyContentApplicationJsonSchemaMessagesMode","default":"replace","description":"How to apply `messages`. `replace` (the default) swaps the whole transcript. `append` adds them to the end, skipping any message whose id is already stored, so a chunked import can retry a chunk safely; the combined transcript is validated and must satisfy the same tool-pairing discipline."},"metadata":{"type":"object","additionalProperties":{"description":"Any type"}},"modelId":{"type":"string","maxLength":255},"ownerId":{"type":["string","null"],"minLength":1,"maxLength":255,"description":"Reassigns the owner (indexed owner_id column, filterable via ?ownerId=). Overrides a nested metadata.ownerId. Null clears the owner; omit to leave it unchanged."},"source":{"$ref":"#/components/schemas/ConversationSource"},"systemPrompt":{"type":"string"},"title":{"type":"string","maxLength":500}}}}}},"security":[{"BearerAuth":[]}]},"delete":{"operationId":"conversations_deleteAConversation","summary":"Delete a conversation","tags":["conversations"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Conversation deleted","content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"400":{"description":"Invalid conversation ID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Conversation not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/data-connections":{"get":{"operationId":"dataConnections_listDataConnections","summary":"List data connections","description":"List all data connections for the authenticated user/org.","tags":["dataConnections"],"parameters":[{"name":"category","in":"query","description":"Filter by integration category","required":false,"schema":{"type":"string"}},{"name":"status","in":"query","description":"Filter by connection status","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"List of connections","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Data_Connections_listDataConnections_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/data-connections/connect-session":{"post":{"operationId":"dataConnections_createConnectSession","summary":"Create connect session","description":"Create a connect session that opens the provider hosted connect UI.","tags":["dataConnections"],"responses":{"200":{"description":"Connect session details","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Data_Connections_createConnectSession_Response_200"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"categories":{"type":"array","items":{"type":"string"}},"label":{"type":"string"}}}}}},"security":[{"BearerAuth":[]}]}},"/v1/data-connections/sync":{"post":{"operationId":"dataConnections_syncConnections","summary":"Sync connections","description":"Sync connections from StackOne into the local DB. Called by the dashboard after the Connect popup closes.","tags":["dataConnections"],"responses":{"200":{"description":"Sync result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Data_Connections_syncConnections_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/data-connections/{id}":{"get":{"operationId":"dataConnections_getDataConnection","summary":"Get data connection","description":"Get a single data connection by ID.","tags":["dataConnections"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Connection details","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Data_Connections_getDataConnection_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Connection not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]},"delete":{"operationId":"dataConnections_deleteDataConnection","summary":"Delete data connection","description":"Delete a data connection by ID.","tags":["dataConnections"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Connection deleted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Data_Connections_deleteDataConnection_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Connection not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]},"patch":{"operationId":"dataConnections_updateConnectionStatus","summary":"Update connection status","description":"Update a data connection status.","tags":["dataConnections"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Updated connection","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Data_Connections_updateConnectionStatus_Response_200"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Connection not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"$ref":"#/components/schemas/V1DataConnectionsIdPatchRequestBodyContentApplicationJsonSchemaStatus"}},"required":["status"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/data-connections/{id}/tools":{"get":{"operationId":"dataConnections_listConnectionTools","summary":"List connection tools","description":"List available tools for a specific data connection.","tags":["dataConnections"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Connection tools","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Data_Connections_listConnectionTools_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Connection not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/decision-models":{"get":{"operationId":"decisionModels_listDecisionModels","summary":"List decision models","description":"List supported decision-only models, their native routes, question constraints, pricing and credential requirements. This static catalog does not verify organization credentials, provider policy, account eligibility or spending readiness. Execution performs those checks. These models are not chat models.","tags":["decisionModels"],"responses":{"200":{"description":"Supported decision model catalog; null pricing or context windows mean unknown.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Decision_Models_listDecisionModels_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/runtime/judgments":{"post":{"operationId":"decisionModels_askForAJudgmentHostedDecisionProvider","summary":"Ask for a judgment (hosted DecisionProvider)","description":"The runtime-family judgment contract consumed by `@runtypelabs/runtime`’s HostedDecisionProvider, so a self-hosted runtime on platform or hybrid keys judges through Runtype with a Self-hosted Runtime key (`RUNTIME:EXECUTE`). Answers like `builtin:decision_judge`: with `questionSetId` the published question set supplies the questions (configured mode, and `questions` is refused); without it the call supplies `questions` (ad hoc mode). Billed and recorded like a decision tool call. Requires an Enterprise plan: ineligible accounts receive 403 (code `BYOC_PLAN_REQUIRED`).","tags":["decisionModels"],"responses":{"200":{"description":"The answers and the judgment metadata","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RuntimeJudgmentResponse"}}}},"400":{"description":"Invalid state, questions or configuration (see `code`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AskForAJudgmentHostedDecisionProviderRequestBadRequestError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Monthly spend limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Not an API key, the key lacks an execute permission, or the account is not on an Enterprise plan (code `BYOC_PLAN_REQUIRED`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"The question set is missing, unpublished or not owned by the caller (code `QUESTION_SET_UNRESOLVED`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AskForAJudgmentHostedDecisionProviderRequestNotFoundError"}}}},"422":{"description":"The decision model is not served or no credential can pay for it (see `code`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AskForAJudgmentHostedDecisionProviderRequestUnprocessableEntityError"}}}},"429":{"description":"Daily execution limit or rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Judgment failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RuntimeJudgmentRequest"}}}},"security":[{"BearerAuth":[]}]}},"/v1/delegate-tasks":{"get":{"operationId":"delegateTasks_listDelegateTasks","summary":"List delegate tasks","description":"Your organization's delegated tasks, newest first. API keys need `DELEGATE_TASKS:READ`.","tags":["delegateTasks"],"parameters":[{"name":"status","in":"query","required":false,"schema":{"$ref":"#/components/schemas/V1DelegateTasksGetParametersStatus"}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"One page of tasks","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Delegate_tasks_listDelegateTasks_Response_200"}}}},"400":{"description":"Invalid limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Missing API key scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Feature disabled, or no such task in this organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"The operator agent is not available on this deployment","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]},"post":{"operationId":"delegateTasks_delegateATaskToTheRuntypeOperatorAgent","summary":"Delegate a task to the Runtype operator agent","description":"Start a task the operator agent works through in your organization: it reads and changes agents, flows, records, tools, evals and surfaces with the same authority as the caller. With `waitSeconds` the response waits up to that long for the task to finish or to stop on a question (`input_required`) before answering; otherwise it returns the queued task at once. An identical delegation from the same caller that is still running is returned again (200, `deduplicated: true`) instead of starting a second one. API keys need `DELEGATE_TASKS:WRITE`.","tags":["delegateTasks"],"responses":{"200":{"description":"The still-running task this request duplicated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Delegate_tasks_delegateATaskToTheRuntypeOperatorAgent_Response_200"}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Missing API key scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Feature disabled, or no such task in this organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"`context` is larger than 16 KB of JSON","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"The operator agent is not available on this deployment","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"allowDestructive":{"type":"boolean"},"allowSimulationRun":{"type":"boolean","description":"Permit starting simulation runs, each with a stated `maxSpendUsd` of at most $25, and no other gated operation. `allowDestructive` also permits them."},"attachments":{"type":"array","items":{"$ref":"#/components/schemas/V1DelegateTasksPostRequestBodyContentApplicationJsonSchemaAttachmentsItems"},"description":"One image for the worker to read on its first turn. `otto` tasks only."},"clientName":{"type":"string","maxLength":64},"clientVersion":{"type":"string","maxLength":64},"context":{"description":"Any type"},"instruction":{"type":"string","minLength":1,"maxLength":20000},"maxToolCalls":{"type":"integer","minimum":1,"maximum":200},"priority":{"$ref":"#/components/schemas/V1DelegateTasksPostRequestBodyContentApplicationJsonSchemaPriority","description":"Execution speed. `standard` (the default) runs at normal speed; `fast` runs at a higher speed for tasks that need it. Applies when creating a task."},"target":{"$ref":"#/components/schemas/V1DelegateTasksPostRequestBodyContentApplicationJsonSchemaTarget","description":"Who works the task. Defaults to `operator`; `otto` hands it to Otto, the account's saved product-engineer agent, and needs the `delegate-to-otto` account flag."},"waitSeconds":{"type":"integer","minimum":0,"maximum":240}},"required":["instruction"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/delegate-tasks/{id}":{"get":{"operationId":"delegateTasks_getADelegateTask","summary":"Get a delegate task","description":"The task with the journal events past `after`. With `wait` the response waits up to that many seconds for a new event or a terminal status before answering, which is how a client polls without a tight loop.","tags":["delegateTasks"],"parameters":[{"name":"id","in":"path","description":"The task id (`dlg_…`).","required":true,"schema":{"type":"string"}},{"name":"wait","in":"query","required":false,"schema":{"type":["integer","null"],"minimum":0,"maximum":240}},{"name":"after","in":"query","required":false,"schema":{"type":["integer","null"],"minimum":0}}],"responses":{"200":{"description":"The task and its new events","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Delegate_tasks_getADelegateTask_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Missing API key scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Feature disabled, or no such task in this organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"The operator agent is not available on this deployment","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/delegate-tasks/{id}/attachments/{index}":{"get":{"operationId":"delegateTasks_readAnImageADelegateTaskStartedWith","summary":"Read an image a delegate task started with","description":"The image at this position of the task's `attachments`. API keys need `DELEGATE_TASKS:READ`.","tags":["delegateTasks"],"parameters":[{"name":"id","in":"path","description":"The task id (`dlg_…`).","required":true,"schema":{"type":"string"}},{"name":"index","in":"path","required":false,"schema":{"type":["integer","null"],"minimum":0}}],"responses":{"200":{"description":"The image","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Delegate_tasks_readAnImageADelegateTaskStartedWith_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Missing API key scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Feature disabled, or no such task in this organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"The operator agent is not available on this deployment","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/delegate-tasks/{id}/cancel":{"post":{"operationId":"delegateTasks_cancelADelegateTask","summary":"Cancel a delegate task","description":"Stop the task after its current tool round. API keys need `DELEGATE_TASKS:WRITE`.","tags":["delegateTasks"],"parameters":[{"name":"id","in":"path","description":"The task id (`dlg_…`).","required":true,"schema":{"type":"string"}}],"responses":{"202":{"description":"Cancellation requested","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Delegate_tasks_cancelADelegateTask_Response_202"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Missing API key scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Feature disabled, or no such task in this organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"The task has already settled","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"The operator agent is not available on this deployment","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/delegate-tasks/{id}/events":{"get":{"operationId":"delegateTasks_streamADelegateTask","summary":"Stream a delegate task","description":"Unified execution Server-Sent Events, replayed then tailed until the task settles. Each frame carries its seq as the SSE id; reconnect with `after=<last id>` or Last-Event-ID. Stream cursors differ from JSON journal cursors. Reads a Code Mode script makes are not streamed; the JSON journal keeps them as events marked `scriptRead: true`.","tags":["delegateTasks"],"parameters":[{"name":"id","in":"path","description":"The task id (`dlg_…`).","required":true,"schema":{"type":"string"}},{"name":"after","in":"query","required":false,"schema":{"type":["integer","null"],"minimum":0}}],"responses":{"200":{"description":"Server-Sent Events stream (replay followed by a live tail)","content":{"text/event-stream":{"schema":{"$ref":"#/components/schemas/ExecutionStreamEvent"}}}},"400":{"description":"Invalid stream cursor","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Missing API key scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Feature disabled, or no such task in this organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"The operator agent is not available on this deployment","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/delegate-tasks/{id}/messages":{"post":{"operationId":"delegateTasks_sendAMessageToADelegateTask","summary":"Send a message to a delegate task","description":"Answer a question the task asked (status `input_required`) or add a follow-up instruction to a running task. Only the user who started the task may message it: from their own session, or with the exact API key that started it (another key of the same user is refused, because the task keeps acting with the starting key's authority). API keys need `DELEGATE_TASKS:WRITE`.","tags":["delegateTasks"],"parameters":[{"name":"id","in":"path","description":"The task id (`dlg_…`).","required":true,"schema":{"type":"string"}}],"responses":{"202":{"description":"Accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Delegate_tasks_sendAMessageToADelegateTask_Response_202"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Missing API key scope, or the caller is not the principal that started the task","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Feature disabled, or no such task in this organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"The task has already settled (`DELEGATE_TASK_SETTLED`), no longer waits on the question named by `answersQuestionSeq` (`DELEGATE_TASK_QUESTION_ANSWERED`), or is an `otto` task mid-turn, which takes no message until it settles or asks (`DELEGATE_TASK_BUSY`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"The operator agent is not available on this deployment","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"answersQuestionSeq":{"type":"integer","minimum":0,"description":"Deliver the message only while the task still waits on the question journaled at this seq (the `seq` of its `question` event). Otherwise the call answers 409 `DELEGATE_TASK_QUESTION_ANSWERED` and delivers nothing, so an answer is safe to retry."},"message":{"type":"string","minLength":1,"maxLength":20000}},"required":["message"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/devices":{"get":{"operationId":"devices_listPairedDevices","summary":"List paired devices","tags":["devices"],"responses":{"200":{"description":"Owned devices and relay status","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Devices_listPairedDevices_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/devices/loopback":{"post":{"operationId":"devices_registerThisComputerAsALocalLoopbackDeviceDevelopmentOnly","summary":"Register this computer as a local loopback device (development only)","tags":["devices"],"responses":{"201":{"description":"Loopback device ready","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Devices_registerThisComputerAsALocalLoopbackDeviceDevelopmentOnly_Response_201"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"security":[{"BearerAuth":[]}]}},"/v1/devices/pair":{"post":{"operationId":"devices_claimAOneTimePairingCodeFromAMac","summary":"Claim a one-time pairing code from a Mac","tags":["devices"],"responses":{"201":{"description":"Device paired","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Devices_claimAOneTimePairingCodeFromAMac_Response_201"}}}},"400":{"description":"Invalid pairing request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Code already used or key already paired","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many device authentication attempts","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"appVersion":{"type":"string","minLength":1,"maxLength":64},"code":{"type":"string","minLength":32,"maxLength":128},"name":{"type":"string","minLength":1,"maxLength":120},"platform":{"$ref":"#/components/schemas/V1DevicesPairPostRequestBodyContentApplicationJsonSchemaPlatform"},"publicKey":{"type":"string","pattern":"^[A-Za-z0-9_-]{43}$"}},"required":["appVersion","code","name","platform","publicKey"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/devices/pairing-sessions":{"post":{"operationId":"devices_createAOneTimeDevicePairingSession","summary":"Create a one-time device pairing session","tags":["devices"],"responses":{"201":{"description":"Pairing session created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Devices_createAOneTimeDevicePairingSession_Response_201"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"security":[{"BearerAuth":[]}]}},"/v1/devices/{id}":{"get":{"operationId":"devices_getAPairedDevice","summary":"Get a paired device","tags":["devices"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Device and relay status","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Devices_getAPairedDevice_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/devices/{id}/connection-token":{"post":{"operationId":"devices_exchangeASignedDeviceChallengeForAShortLivedRelayToken","summary":"Exchange a signed device challenge for a short-lived relay token","tags":["devices"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Short-lived relay credentials","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Devices_exchangeASignedDeviceChallengeForAShortLivedRelayToken_Response_200"}}}},"401":{"description":"Invalid signature","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Challenge replayed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"Device revoked","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many device authentication attempts","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Relay not configured","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"nonce":{"type":"string","minLength":16,"maxLength":128},"signature":{"type":"string","pattern":"^[A-Za-z0-9_-]{86}$"},"timestamp":{"type":"integer","exclusiveMinimum":0}},"required":["nonce","signature","timestamp"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/devices/{id}/revoke":{"post":{"operationId":"devices_revokeAPairedDevice","summary":"Revoke a paired device","tags":["devices"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Device revoked","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Devices_revokeAPairedDevice_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Revocation persisted but relay disconnect was not confirmed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/dispatch":{"post":{"operationId":"dispatch_executeAFlowOrAgent","summary":"Execute a flow or agent","description":"Main dispatch endpoint for flow and agent execution with record resolution. Supports streaming via SSE or synchronous JSON responses. Send the RFC 7240 `Prefer: respond-async` header to receive a durable execution handle immediately, then poll its status URL for completion. A saved agent may run on the durable session lane; the admission headers `x-runtype-concurrency` (reject, supersede, queue, steer), `x-runtype-coalesce` (true) and `idempotency-key` then apply exactly as on `POST /v1/agents/{id}/execute`, and are ignored for in-process execution except steer, which fails explicitly on unsupported lanes. `x-runtype-concurrency: auto` sends the same user-message deltas as steer and lets a classifier choose: while a turn runs, a message that belongs to it steers and an independent one queues as the next turn; with nothing running it is an ordinary turn with no route report. A routed or downgraded answer carries `X-Runtype-Busy-Message-Route` (steer or queue) and `X-Runtype-Busy-Message-Source` (classifier, shadow, abstained, timeout, error, unanswered, circuit_open, or disabled), plus `X-Runtype-Busy-Message-Probability` and `X-Runtype-Busy-Message-Model` when the classifier answered; JSON bodies repeat them as `busyMessageRoute`. Where auto cannot route (in-process execution, stored history, a flow, no conversationId, coalesce, Prefer: respond-async) it keeps the default admission and reports source `disabled`. Any other x-runtype-concurrency value is refused with 400 INVALID_CONCURRENCY_MODE. Steer accepts only new user-message deltas, preserves the active execution configuration and authority, and returns a deliveryId with a deliveryStatusUrl. Prefer: respond-async with steer returns a native delivery receipt without queuing an HTTP replay.","tags":["dispatch"],"responses":{"200":{"description":"Execution result (SSE stream or JSON)","content":{"text/event-stream":{"schema":{"$ref":"#/components/schemas/ExecutionStreamEvent"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Saved flow not found (FLOW_NOT_FOUND), a version selector that names no pointer (alias_not_found, alias_archived, alias_expired, version_not_found), or a saved agent with no runnable live version (AGENT_NOT_DEPLOYED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"The durable conversation is busy (CONVERSATION_BUSY names the occupant execution and its phase; honor Retry-After or send x-runtype-concurrency: steer)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConversationBusyError"}}}},"422":{"description":"The dispatch cannot run: a persisted-flow hash miss (FLOW_DEFINITION_REQUIRED, retry with the full definition), a shaped-wrong definition write (FLOW_DEFINITION_WRITE_REJECTED), no flow definition (FLOW_DEFINITION_MISSING), an unresolvable record or definition (FLOW_RECORD_UNRESOLVED, FLOW_DEFINITION_UNRESOLVED), or a capability the runtime lane cannot host (RUNTIME_LANE_INELIGIBLE, with `reasons`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExecuteAFlowOrAgentRequestInternalServerError"}}}},"503":{"description":"Asynchronous execution unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Dispatch_executeAFlowOrAgent_Request"}}}},"security":[{"BearerAuth":[]}]}},"/v1/dispatch/approve":{"post":{"operationId":"dispatch_approveOrDenyAPendingApproval_stream","summary":"Approve or deny a pending approval","description":"Submits an approval decision for a paused execution awaiting human-in-the-loop approval.","tags":["dispatch"],"responses":{"200":{"description":"","content":{"text/event-stream":{"schema":{"$ref":"#/components/schemas/ExecutionStreamEvent"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Platform key spend limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DispatchApprovalContinuationJsonResponse"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Paused execution not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Execution is not awaiting this approval or cannot be resumed here","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"The paused execution was armed by the retired legacy flow engine and cannot be resumed (LEGACY_PAUSE_UNRESUMABLE); re-run the flow","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalError"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"approvalId":{"type":"string","minLength":1},"decision":{"$ref":"#/components/schemas/V1DispatchApprovePostRequestBodyContentApplicationJsonSchemaDecision"},"executionId":{"type":"string","minLength":1},"reason":{"type":"string"},"remember":{"type":"boolean"},"streamResponse":{"type":"boolean","enum":[true]}},"required":["approvalId","decision","executionId","streamResponse"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/dispatch/continue":{"post":{"operationId":"dispatch_continueAPausedExecution_stream","summary":"Continue a paused execution","description":"Unified continuation endpoint that handles both tool-output resumption and approval decisions.","tags":["dispatch"],"responses":{"200":{"description":"","content":{"text/event-stream":{"schema":{"$ref":"#/components/schemas/ExecutionStreamEvent"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Platform key spend limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DispatchContinuationJsonResponse"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Paused execution not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Execution is not awaiting this approval or cannot be resumed here","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"The paused execution was armed by the retired legacy flow engine and cannot be resumed (LEGACY_PAUSE_UNRESUMABLE); re-run the flow","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalError"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"continuation":{"$ref":"#/components/schemas/V1DispatchContinuePostRequestBodyContentApplicationJsonSchemaContinuation"},"executionId":{"type":"string","minLength":1},"streamResponse":{"type":"boolean","enum":[true]}},"required":["continuation","executionId","streamResponse"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/dispatch/resume":{"post":{"operationId":"dispatch_resumeAPausedExecution_stream","summary":"Resume a paused execution","description":"Resumes a paused flow or agent execution by providing tool outputs. Does not count against execution limits. A saved-agent dispatch that ran on the durable lane pauses under its `aex_` execution id; resuming it hands the outputs to the durable session, answers `{ executionId, status: \"running\" }` (or a streamed `await` with `awaitReason: \"detached\"`), and ignores `messages`. Follow the run through `GET /v1/executions/{executionId}/events`.","tags":["dispatch"],"responses":{"200":{"description":"","content":{"text/event-stream":{"schema":{"$ref":"#/components/schemas/ExecutionStreamEvent"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Platform key spend limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DispatchToolOutputContinuationJsonResponse"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Paused execution not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"The durable execution is not awaiting tool output or cannot be resumed here","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"The paused execution was armed by the retired legacy flow engine and cannot be resumed (LEGACY_PAUSE_UNRESUMABLE); re-run the flow","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalError"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"executionId":{"type":"string","minLength":1,"description":"The execution ID to resume"},"messages":{"type":"array","items":{"$ref":"#/components/schemas/V1DispatchResumePostRequestBodyContentApplicationJsonSchemaMessagesItems"},"description":"Optional conversation override for the resumed leg. It REPLACES the stored conversation rather than being appended to it, so send the full conversation you want the model to see, not just the new turn. Omit it to keep the stored conversation unchanged. A `system` message must come first, as in any conversation. Prior tool turns use the `/v1/dispatch` message shape: an assistant message with `toolCalls`, answered by a `tool` message with `toolResults`. Note this is the flow client-tool continuation contract; an agent checkpoint resume (`options.resumeFrom` on `/v1/dispatch`) instead APPENDS its `messages` after the snapshot history — send only new input there."},"streamResponse":{"type":"boolean","enum":[true],"description":"Whether to stream the response via SSE"},"toolOutputs":{"type":"object","additionalProperties":{"description":"Any type"},"default":{},"description":"Local tool outputs for the paused execution. Key each output by the per-call `toolCallId` from the `flow_await` / `agent_await` event (preferred, and required to disambiguate parallel calls to the same tool), or by tool name (legacy; collapses same-tool parallel calls onto one slot)."}},"required":["executionId","streamResponse"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/docs/search":{"post":{"operationId":"documentation_searchDocumentation","summary":"Search documentation","description":"Semantic search over the published Runtype documentation corpus. Returns a synthesized answer with citations. Use this for prose/how-to questions; for deterministic schemas and build guidance use the /v1/documentation endpoints.","tags":["documentation"],"responses":{"200":{"description":"Documentation search result (MCP content blocks)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Documentation_searchDocumentation_Response_200"}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Upstream documentation search failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","minLength":1,"description":"Natural-language documentation question."}},"required":["query"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/documentation":{"get":{"operationId":"documentation_getPlatformDocumentation","summary":"Get platform documentation","description":"Retrieve platform documentation, schemas, and reference material by topic, template ID, or vendor slug.","tags":["documentation"],"parameters":[{"name":"topic","in":"query","required":false,"schema":{"type":"string"}},{"name":"templateId","in":"query","required":false,"schema":{"type":"string"}},{"name":"vendor","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Platform documentation content","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Documentation_getPlatformDocumentation_Response_200"}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/documentation/build-instructions":{"post":{"operationId":"documentation_getBuildInstructions","summary":"Get build instructions","description":"Retrieve build instructions and platform guidance for a given task.","tags":["documentation"],"responses":{"200":{"description":"Build instructions content","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Documentation_getBuildInstructions_Response_200"}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"description":{"type":"string"},"focus":{"type":"string","description":"Comma-separated build-product focus areas whose full guides are inlined, e.g. \"embed,agent-design\"."},"name":{"type":"string"},"task":{"type":"string","description":"One of: build-product, generate-flow, explain-capabilities"},"template":{"type":"string"}}}}}},"security":[{"BearerAuth":[]}]}},"/v1/end-user-auth/consume":{"post":{"operationId":"endUserAuth_exchangeASignInTokenForEndUserCredentials","summary":"Exchange a sign-in token for end-user credentials","tags":["endUserAuth"],"responses":{"200":{"description":"End-user access + refresh tokens","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EndUserTokenGrant"}}}},"400":{"description":"Invalid request body","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Invalid or expired sign-in token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EndUserAuthConsumeRequest"}}}}}},"/v1/end-user-auth/jwks":{"get":{"operationId":"endUserAuth_jwksForRuntypeIssuedEndUserJwTs","summary":"JWKS for Runtype-issued end-user JWTs","description":"The public keys that verify end-user access tokens minted by the hosted identity flow. Identity Exchange integrations for hosted tenants point their jwksUri here.","tags":["endUserAuth"],"responses":{"200":{"description":"JSON Web Key Set","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EndUserAuthJwks"}}}},"500":{"description":"Signing key not configured","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/end-user-auth/refresh":{"post":{"operationId":"endUserAuth_rotateAnEndUserRefreshToken","summary":"Rotate an end-user refresh token","description":"Exchanges a refresh token for a fresh access + refresh token pair. Refresh tokens are single-use; reusing a rotated-out token revokes its whole session family.","tags":["endUserAuth"],"responses":{"200":{"description":"End-user access + refresh tokens","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EndUserTokenGrant"}}}},"400":{"description":"Invalid request body","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Invalid refresh token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EndUserAuthRefreshRequest"}}}}}},"/v1/end-user-auth/request-link":{"post":{"operationId":"endUserAuth_requestAnEndUserSignInEmail","summary":"Request an end-user sign-in email","description":"Emails a one-time sign-in token to an end user of the given customer organization. Enumeration-safe: the response is identical whether or not the email is known.","tags":["endUserAuth"],"responses":{"202":{"description":"Accepted (sent if the address is eligible)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EndUserAuthRequestLinkResponse"}}}},"400":{"description":"Invalid request body","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many sign-in requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EndUserAuthRequestLinkRequest"}}}}}},"/v1/end-user-integrations/{provider}/connect":{"post":{"operationId":"endUserIntegrations_beginEndUserOAuthConnection","summary":"Begin end-user OAuth connection","description":"Verifies the end user’s identity proof, projects a durable end-user identity, and returns the third-party authorize URL with a single-use state. Builder-authenticated; the end-user identity comes only from the verified proof.","tags":["endUserIntegrations"],"parameters":[{"name":"provider","in":"path","description":"OAuth connector provider slug, e.g. `github`.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Authorize URL issued","content":{"application/json":{"schema":{"$ref":"#/components/schemas/End-User_Integrations_beginEndUserOAuthConnection_Response_200"}}}},"400":{"description":"Invalid request body or redirect","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized, or identity proof verification failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden, or the proof did not reach verified end-user assurance","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Unknown connector provider","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"501":{"description":"Connector is not configured on this deployment","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"identityProof":{"type":"string","minLength":1,"description":"The end user's customer-native Identity-Exchange proof (a JWT). Verified server-side against the builder’s configured identity integrations; the verified subject becomes the end-user identity. Never a body-asserted id."},"redirectAfter":{"type":"string","format":"uri","description":"Where to redirect the end user after the OAuth callback completes. Must be a safe http(s)/app-scheme URL (open-redirect schemes are rejected)."}},"required":["identityProof"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/eval/analyze-steps":{"post":{"operationId":"evals_analyzeStepResults","summary":"Analyze step results","description":"Analyze step results for keyword/phrase occurrences across evals.","tags":["evals"],"responses":{"200":{"description":"Analysis returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Evals_analyzeStepResults_Response_200"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalError"}}}},"503":{"description":"Database temporarily unavailable; nothing was read or written. Retry after the `Retry-After` interval (seconds).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatabaseUnavailableError"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"caseSensitive":{"type":"boolean"},"evalGroupId":{"type":"string"},"searchTerms":{"type":"array","items":{"type":"string"}},"stepIds":{"type":"array","items":{"type":"string"}}},"required":["evalGroupId","searchTerms","stepIds"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/eval/batches":{"get":{"operationId":"evals_listEvalBatches","summary":"List eval batches","description":"List all eval batches for the current user with optional filtering and pagination.","tags":["evals"],"parameters":[{"name":"limit","in":"query","description":"Number of results (default 50, max 100)","required":false,"schema":{"type":"string"}},{"name":"offset","in":"query","description":"Pagination offset","required":false,"schema":{"type":"string"}},{"name":"status","in":"query","description":"Filter by status (queued|processing|completed|failed)","required":false,"schema":{"type":"string"}},{"name":"origin","in":"query","description":"Filter by run origin: \"suite\" = runs linked to an eval suite (CI gates, suite Run button); \"adhoc\" = suite-less runs (ad-hoc config comparisons, legacy evals).","required":false,"schema":{"$ref":"#/components/schemas/V1EvalBatchesGetParametersOrigin"}},{"name":"evalSuiteId","in":"query","description":"Filter to runs of a specific eval suite. Server-side, so a suite with sparse runs is not crowded out of the page by other suites.","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Eval batches returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Evals_listEvalBatches_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalError"}}}},"503":{"description":"Database temporarily unavailable; nothing was read or written. Retry after the `Retry-After` interval (seconds).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatabaseUnavailableError"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/eval/compare":{"post":{"operationId":"evals_compareEvals","summary":"Compare evals","description":"Compare aggregate metrics across eval batches in a group.","tags":["evals"],"responses":{"200":{"description":"Comparison returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Evals_compareEvals_Response_200"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalError"}}}},"503":{"description":"Database temporarily unavailable; nothing was read or written. Retry after the `Retry-After` interval (seconds).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatabaseUnavailableError"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"evalGroupId":{"type":"string"},"stepIds":{"type":"array","items":{"type":"string"}}},"required":["evalGroupId"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/eval/compare-record":{"post":{"operationId":"evals_compareRecordAcrossEvals","summary":"Compare record across evals","description":"Compare results for a specific record across eval batches in a group.","tags":["evals"],"responses":{"200":{"description":"Record comparison returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Evals_compareRecordAcrossEvals_Response_200"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalError"}}}},"503":{"description":"Database temporarily unavailable; nothing was read or written. Retry after the `Retry-After` interval (seconds).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatabaseUnavailableError"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"evalGroupId":{"type":"string"},"recordId":{"type":"string"},"stepIds":{"type":"array","items":{"type":"string"}}},"required":["evalGroupId","recordId"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/eval/default-suites":{"post":{"operationId":"evals_ensureDefaultEvalSuites","summary":"Ensure default eval suites","description":"Give each named flow and agent that has no eval suite an empty default suite named `<name> eval`. Idempotent: a target that already has any suite is left alone. Unknown or unowned ids are skipped.","tags":["evals"],"responses":{"200":{"description":"Default suites ensured","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Evals_ensureDefaultEvalSuites_Response_200"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"agentIds":{"type":"array","items":{"type":"string"}},"flowIds":{"type":"array","items":{"type":"string"}}}}}}},"security":[{"BearerAuth":[]}]}},"/v1/eval/ensure":{"post":{"operationId":"evals_ensureEvalSuiteConfigAsCodeConverge","summary":"Ensure eval suite (config-as-code converge)","description":"Idempotently converge a repo-defined eval suite (target + cases + graders) onto the platform. Identity is the suite name + account scope; the target flow/agent is resolved by name. Hash-only probes skip the payload in the steady state (a miss is a normal 200 `definitionRequired` response, not an error); full requests create the suite or replace the cases ensure owns when the canonical content hash differs. Cases saved from runs, added in the dashboard, or owned by a product are never replaced. Set dryRun to plan without writing (CI drift gate), and onConflict: \"overwrite\" to converge over dashboard/API edits. Non-executing: never runs the eval. The response always carries the server-computed canonical hash.","tags":["evals"],"responses":{"200":{"description":"Converge result: unchanged | created | updated | definitionRequired (hash miss — retry with the full definition) | plan (dryRun)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvalEnsureResponse"}}}},"400":{"description":"Validation error (bad definition, unresolved target, divergent per-case graders, or virtual)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflict: external_modification (last write was not ensure; pass onConflict: \"overwrite\") or remote_changed (expectedRemoteHash guard)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvalEnsureConflict"}}}},"422":{"description":"Submitted contentHash does not match the server-recomputed canonical hash","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"contentHash":{"type":"string","pattern":"^[0-9a-f]{64}$"},"definition":{"$ref":"#/components/schemas/V1EvalEnsurePostRequestBodyContentApplicationJsonSchemaDefinition"},"dryRun":{"type":"boolean"},"expectedRemoteHash":{"type":"string","pattern":"^[0-9a-f]{64}$"},"name":{"type":"string","minLength":1},"onConflict":{"$ref":"#/components/schemas/V1EvalEnsurePostRequestBodyContentApplicationJsonSchemaOnConflict"}},"required":["name"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/eval/executions/{executionId}/capture-preview":{"get":{"operationId":"evals_previewTraceToEvalCaptureForARun","summary":"Preview trace-to-eval capture for a run","description":"Dry-run of POST /eval/suites/{id}/cases/from-execution: reconstructs the agent execution exactly as capture would (same reader, same message math) and returns its recorded actions with the fork index each one maps to, plus whether the case would be fully replayable. Reads only — nothing is written. Restricted to agent executions the caller owns.","tags":["evals"],"parameters":[{"name":"executionId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Capture preview","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CaptureExecutionPreview"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/eval/graders/decompose":{"post":{"operationId":"evals_decomposeGraderCriteria","summary":"Decompose grader criteria","description":"Split one plain-language AI-grader criterion carrying several obligations into focused, independently judgeable sub-checks. Authoring assist only: review the proposal, then save each accepted sub-check as its own AI grader (kind \"ai\") on the suite. Nothing is persisted by this endpoint.","tags":["evals"],"responses":{"200":{"description":"Proposed sub-checks","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DecomposeCriteriaResponse"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"The decomposition model did not return a usable proposal","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DecomposeCriteriaRequest"}}}},"security":[{"BearerAuth":[]}]}},"/v1/eval/group/{groupId}":{"get":{"operationId":"evals_getEvalGroup","summary":"Get eval group","description":"Get all eval batches in a group for comparison.","tags":["evals"],"parameters":[{"name":"groupId","in":"path","description":"Eval group ID","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Eval group returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Evals_getEvalGroup_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalError"}}}},"503":{"description":"Database temporarily unavailable; nothing was read or written. Retry after the `Retry-After` interval (seconds).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatabaseUnavailableError"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/eval/proposals":{"get":{"operationId":"evals_listEvalCaseProposalsForSeveralSuites","summary":"List eval case proposals for several suites","description":"The review queue of several suites in one read: for each named suite the caller owns, its newest proposals and its total, the page `GET /suites/{id}/proposals` answers at offset 0. A suite the caller does not own, or that does not exist, is left out.","tags":["evals"],"parameters":[{"name":"suiteIds","in":"query","description":"Comma-separated eval suite ids, at most 50.","required":true,"schema":{"type":"string"}},{"name":"status","in":"query","description":"Filter by status. Omit for all; the queue UI uses \"proposed\".","required":false,"schema":{"$ref":"#/components/schemas/V1EvalProposalsGetParametersStatus"}},{"name":"limit","in":"query","description":"Proposals per suite (default 20, max 50)","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Proposals returned, one entry per owned suite in the order named","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuiteEvalCaseProposalsList"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/eval/pull":{"get":{"operationId":"evals_pullEvalSuiteDefinitionConfigAsCode","summary":"Pull eval suite definition (config-as-code)","description":"Return the canonical config-as-code definition and provenance for an eval suite by name — the absorb-drift direction of the ensure protocol. The definition carries the cases ensure owns (or, for a suite ensure never wrote, its unowned cases), and the contentHash is recomputed from that live state.","tags":["evals"],"parameters":[{"name":"name","in":"query","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Canonical definition + provenance","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvalPullResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No eval suite with that name in the account scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/eval/run":{"post":{"operationId":"evals_runEvalSuiteSynchronously","summary":"Run eval suite synchronously","description":"Run every case of an eval suite against its target flow/agent and grade the outputs with the suite graders, returning the suite score + per-case gate outcomes in one response. Powers the `runtype eval` CI gate. Saved-suite runs persist by default: the run gets a durable id (`runId`) and per-case scores queryable via GET /eval/runs/{runId}/scores; pass `virtual: true` to skip persistence. Inline definition runs are always ephemeral. Bounded — suites over the case limit must use the batch path (/eval/submit). Flow and standard-agent targets are supported (in both saved and inline/virtual modes); external and claude_managed agent targets are not.","tags":["evals"],"responses":{"200":{"description":"Suite score + per-case grader outcomes","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEvalResponse"}}}},"400":{"description":"Validation error (bad definition, unresolved/unsupported target, too many cases)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Daily eval limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvalQuotaExceededError"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Suite or target not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalError"}}}},"503":{"description":"Database temporarily unavailable; nothing was read or written. Retry after the `Retry-After` interval (seconds).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatabaseUnavailableError"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"agent":{"$ref":"#/components/schemas/V1EvalRunPostRequestBodyContentApplicationJsonSchemaAgent","description":"Version selector for an Agent target. Supply at most one of alias or versionId; the run resolves it once and every case executes that version."},"definition":{"$ref":"#/components/schemas/V1EvalRunPostRequestBodyContentApplicationJsonSchemaDefinition"},"modelOverride":{"type":"string","minLength":1,"description":"Run every case against this model instead of the target’s configured one, without editing the suite, the flow, or the agent. Re-run the same suite once per candidate model and compare the scores to choose a model on graded evidence. Applies to flow and agent targets alike."},"strict":{"type":"boolean","description":"Strict mode (the `runtype eval --strict` gate): a soft grader miss fails its case like a gate miss. Default false — soft misses are reported per-outcome but do not fail the suite."},"suiteId":{"type":"string","minLength":1},"virtual":{"type":"boolean","description":"Skip persistence for a saved-suite run: no run row, no persisted scores. Saved-suite runs persist by default; inline definition runs are always ephemeral regardless of this flag."}}}}}},"security":[{"BearerAuth":[]}]}},"/v1/eval/runs/{batchId}/scores":{"get":{"operationId":"evals_getPersistedGraderScoresForAnEvalRun","summary":"Get persisted grader scores for an eval run","description":"Return the persisted per-case grader scores for a run (a `batchExecutions` row) — the read side of eval score persistence. Grader outcomes use the same shape as the synchronous POST /eval/run response, so live and historical results render identically. Runs land here from persisted saved-suite runs (POST /eval/run) and completed suite-linked batch runs. Returns an empty case list for a run with no persisted scores (ephemeral/virtual runs, ad-hoc comparisons, legacy evals).","tags":["evals"],"parameters":[{"name":"batchId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Per-case grader scores for the run","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvalRunScoresResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Run not found in this account scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/eval/scores/{scoreId}/review":{"post":{"operationId":"evals_reviewAnAiGraderVerdict","summary":"Review an AI-grader verdict","description":"Record a lightweight human review of one AI-grader verdict (\"the grader got this right / wrong\"). Reviews accumulate into the suite's judge-trust display (\"agrees with you N of M times\") returned on GET /eval/suites/{id}. Only AI-grader score rows are reviewable; check graders are deterministic. Pass verdict null to clear an earlier review.","tags":["evals"],"parameters":[{"name":"scoreId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Review recorded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvalScoreReviewed"}}}},"400":{"description":"Not an AI-grader score row","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Score not found in this account scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"$ref":"#/components/schemas/V1EvalScoresScoreIdReviewPostRequestBodyContentApplicationJsonSchemaVerdict","description":"Did the grader get this one right? \"agree\" / \"disagree\"; null clears an earlier review."}},"required":["verdict"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/eval/stream":{"post":{"operationId":"evals_streamEvalExecution","summary":"Stream eval execution","description":"Execute virtual eval with record/messages input and stream results via multiplexed SSE. All eval configs execute simultaneously in parallel.","tags":["evals"],"responses":{"200":{"description":"SSE stream of eval results","content":{"text/event-stream":{"schema":{"$ref":"#/components/schemas/ExecutionStreamEvent"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvalQuotaExceededError"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalError"}}}},"503":{"description":"Database temporarily unavailable; nothing was read or written. Retry after the `Retry-After` interval (seconds).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatabaseUnavailableError"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"evalConfigs":{"type":"array","items":{"$ref":"#/components/schemas/EvalConfigRequest"}}}}}}},"security":[{"BearerAuth":[]}]}},"/v1/eval/submit":{"post":{"operationId":"evals_submitEval","summary":"Submit eval","description":"Submit a flow or agent eval. Hosted targets support overrides and multi-model requests; delegated external agents support one baseline config without overrides and not /eval/stream.","tags":["evals"],"responses":{"200":{"description":"Eval submitted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Evals_submitEval_Response_200"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvalQuotaExceededError"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"The target cannot run: RUNTIME_LANE_INELIGIBLE (with `reasons`) for a flow, or flow plus eval overrides, the batch host cannot run, before any eval quota is reserved; or an unsupported agent target.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubmitEvalRequestUnprocessableEntityError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalError"}}}},"503":{"description":"Database temporarily unavailable; nothing was read or written. Retry after the `Retry-After` interval (seconds).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatabaseUnavailableError"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"agent":{"$ref":"#/components/schemas/V1EvalSubmitPostRequestBodyContentApplicationJsonSchemaAgent","description":"Version selector for an agentId target. Supply at most one of alias or versionId; the run resolves it once and every case executes that version."},"evalConfig":{"$ref":"#/components/schemas/EvalConfigRequest"},"evalConfigs":{"type":"array","items":{"$ref":"#/components/schemas/EvalConfigRequest"}},"inputs":{"type":["object","null"],"additionalProperties":{"description":"Any type"},"description":"Flow input variables applied to every record execution, as on POST /batch/flow: they override same-named record metadata at the top level and leave _record.metadata unchanged. Flow targets only."}}}}}},"security":[{"BearerAuth":[]}]}},"/v1/eval/suites":{"get":{"operationId":"evals_listEvalSuites","summary":"List eval suites","description":"List eval suites in the account scope with case counts and each suite’s latest run + score. Filter by target with flowId/agentId.","tags":["evals"],"parameters":[{"name":"flowId","in":"query","description":"Filter to suites targeting this flow","required":false,"schema":{"type":"string"}},{"name":"agentId","in":"query","description":"Filter to suites targeting this agent","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","description":"Number of results (default 50, max 100)","required":false,"schema":{"type":"string"}},{"name":"offset","in":"query","description":"Pagination offset","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Eval suites returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvalSuiteListResponse"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]},"post":{"operationId":"evals_createEvalSuite","summary":"Create eval suite","description":"Create an eval suite (named test cases + graders) attached to one flow or agent, optionally with initial cases. Suites created here are dashboard/API-managed; config-as-code suites converge via POST /eval/ensure instead.","tags":["evals"],"responses":{"201":{"description":"Suite created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvalSuiteDetail"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"agentId":{"type":"string","minLength":1},"cases":{"type":"array","items":{"$ref":"#/components/schemas/V1EvalSuitesPostRequestBodyContentApplicationJsonSchemaCasesItems"}},"description":{"type":"string"},"flowId":{"type":"string","minLength":1},"graders":{"type":"array","items":{"$ref":"#/components/schemas/V1EvalSuitesPostRequestBodyContentApplicationJsonSchemaGradersItems"},"default":[],"description":"Ordered grader configs applied to every case (suite-level graders)."},"identityDefaults":{"$ref":"#/components/schemas/V1EvalSuitesPostRequestBodyContentApplicationJsonSchemaIdentityDefaults","description":"Default identity (endUser / tenant) every case runs as unless the case sets its own. Required (or per-case identity) when the agent sets config.tenancyStrategy. No credentials: the identity is asserted by the suite author."},"isDefault":{"type":"boolean","description":"Make this the default eval for its target (clears the flag on any other suite for the same target)."},"name":{"type":"string","minLength":1},"recordedToolMode":{"$ref":"#/components/schemas/V1EvalSuitesPostRequestBodyContentApplicationJsonSchemaRecordedToolMode","description":"How captured (saved_from_run) cases replay. \"next_step\" (default) captures the first tool intent and stops; \"continue\" serves recorded toolMocks and runs past the first action."},"recordedToolUnmatchedPolicy":{"$ref":"#/components/schemas/V1EvalSuitesPostRequestBodyContentApplicationJsonSchemaRecordedToolUnmatchedPolicy","description":"For \"continue\"-mode replays, what to do when a tool call has no matching mock: \"fail\" (default, divergence is the signal) or \"stub\" (canned success so the run keeps going). A replay never reaches the real tool."}},"required":["name"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/eval/suites/{id}":{"get":{"operationId":"evals_getEvalSuite","summary":"Get eval suite","description":"Get an eval suite including its cases and latest run + score.","tags":["evals"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Eval suite returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvalSuiteDetail"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]},"delete":{"operationId":"evals_deleteEvalSuite","summary":"Delete eval suite","description":"Delete an eval suite and its cases. Past runs and their persisted scores survive (scores keep the case name snapshot).","tags":["evals"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Suite deleted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Evals_deleteEvalSuite_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]},"patch":{"operationId":"evals_updateEvalSuite","summary":"Update eval suite","description":"Update a suite’s Definition (name, description, graders) or state (default flag, baseline run pin). The target is immutable — create a new suite to evaluate a different flow/agent. Definition edits stamp provenance; a graders change invalidates the config-as-code content hash so the next ensure re-converges.","tags":["evals"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Suite updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvalSuiteSummary"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"baselineBatchExecutionId":{"type":["string","null"],"description":"Pin a run of this suite as the comparison baseline; null clears the pin."},"description":{"type":["string","null"]},"graders":{"type":"array","items":{"$ref":"#/components/schemas/V1EvalSuitesIdPatchRequestBodyContentApplicationJsonSchemaGradersItems"}},"identityDefaults":{"oneOf":[{"$ref":"#/components/schemas/V1EvalSuitesIdPatchRequestBodyContentApplicationJsonSchemaIdentityDefaults"},{"type":"null"}],"description":"Default identity (endUser / tenant) every case runs as unless the case sets its own; replaces the stored value. null clears it."},"isDefault":{"type":"boolean"},"name":{"type":"string","minLength":1},"recordedToolMode":{"$ref":"#/components/schemas/V1EvalSuitesIdPatchRequestBodyContentApplicationJsonSchemaRecordedToolMode","description":"How captured (saved_from_run) cases replay. \"next_step\" captures the first tool intent and stops; \"continue\" serves recorded toolMocks and runs past the first action. null resets to the default (next_step)."},"recordedToolUnmatchedPolicy":{"$ref":"#/components/schemas/V1EvalSuitesIdPatchRequestBodyContentApplicationJsonSchemaRecordedToolUnmatchedPolicy","description":"For \"continue\"-mode replays, the unmatched-call policy: \"fail\" (divergence is the signal) or \"stub\" (canned success). null resets to the default (fail)."}}}}}},"security":[{"BearerAuth":[]}]}},"/v1/eval/suites/{id}/cases":{"post":{"operationId":"evals_addEvalCases","summary":"Add eval cases","description":"Add one or more test cases to an eval suite. Cases are server-authoritative data: adding them does not affect the suite’s config-as-code provenance.","tags":["evals"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"201":{"description":"Cases created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvalCasesCreated"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"cases":{"type":"array","items":{"$ref":"#/components/schemas/V1EvalSuitesIdCasesPostRequestBodyContentApplicationJsonSchemaCasesItems"}}},"required":["cases"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/eval/suites/{id}/cases/from-execution":{"post":{"operationId":"evals_captureAnEvalCaseFromARun","summary":"Capture an eval case from a run","description":"Fork an agent execution into a test case: freeze its conversation history up to a fork point, attach every recorded tool result as an editable mock, and save it with origin \"saved_from_run\". Capture only — reads the run and writes a case; it never re-executes anything. Restricted to agent executions the caller owns.","tags":["evals"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"201":{"description":"Case captured","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CapturedEvalCase"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"executionId":{"type":"string","minLength":1,"description":"Runtime execution id (from a log/trace row) of the agent run to fork from."},"expected":{"$ref":"#/components/schemas/V1EvalSuitesIdCasesFromExecutionPostRequestBodyContentApplicationJsonSchemaExpected","description":"What \"good\" looks like for the graded next step (optional; e.g. pre-filled from a 👍)."},"forkMessageIndex":{"type":"integer","minimum":0,"description":"Where to fork the frozen history (index into the reconstructed message array). Defaults to just before the last recorded tool-call action, so the run’s final action is the graded next step."},"name":{"type":"string","minLength":1,"description":"Case name. Defaults to \"Saved from run <executionId>\"."},"notes":{"type":"string"}},"required":["executionId"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/eval/suites/{id}/cases/{caseId}":{"delete":{"operationId":"evals_deleteEvalCase","summary":"Delete eval case","description":"Delete a test case. Persisted scores from past runs survive with the case name snapshot (caseId nulls out).","tags":["evals"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"caseId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Case deleted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Evals_deleteEvalCase_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]},"patch":{"operationId":"evals_updateEvalCase","summary":"Update eval case","description":"Edit, enable, or disable a test case.","tags":["evals"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"caseId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Case updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvalCase"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"enabled":{"type":"boolean"},"expected":{"oneOf":[{"$ref":"#/components/schemas/V1EvalSuitesIdCasesCaseIdPatchRequestBodyContentApplicationJsonSchemaExpected"},{"type":"null"}]},"graders":{"type":["array","null"],"items":{"$ref":"#/components/schemas/V1EvalSuitesIdCasesCaseIdPatchRequestBodyContentApplicationJsonSchemaGradersItems"},"description":"Per-case graders that REPLACE the suite graders for this case. null clears the override so the case uses the suite graders again."},"input":{"$ref":"#/components/schemas/V1EvalSuitesIdCasesCaseIdPatchRequestBodyContentApplicationJsonSchemaInput"},"name":{"type":"string","minLength":1},"notes":{"type":["string","null"]}}}}}},"security":[{"BearerAuth":[]}]}},"/v1/eval/suites/{id}/coverage":{"get":{"operationId":"evals_getEvalSuiteCoverage","summary":"Get eval suite coverage","description":"The coverage meter: which of the target’s tools and instruction clauses the suite’s cases and graders already exercise. Tools come structurally from the definition; instruction clauses come from a cached, definition-hash-invalidated inventory pass. Write-gated because a cache miss spends model tokens.","tags":["evals"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Coverage report","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvalCoverage"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/eval/suites/{id}/generate-cases":{"post":{"operationId":"evals_generateEvalCaseProposals","summary":"Generate eval case proposals","description":"Propose test cases from the target’s definition, fanned out over an explicit diversity matrix (category × persona) and filtered for gradeability. Generated cases land as PROPOSALS for review — never directly in the suite. One daily-eval quota slot per call.","tags":["evals"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"201":{"description":"Proposals created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvalCasesGenerated"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Daily eval limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvalQuotaExceededError"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Per-suite daily proposal cap reached","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"The generation model did not return usable cases","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":12,"description":"How many cases to propose (default 8; 3 for gap-targeted generation)."},"gap":{"$ref":"#/components/schemas/V1EvalSuitesIdGenerateCasesPostRequestBodyContentApplicationJsonSchemaGap","description":"Generate for one coverage gap: cases exercising this tool or probing this instruction clause (proposals land with source \"coverage_gap\"). Provide exactly one of toolName/instruction."},"hint":{"type":"string","maxLength":2000,"description":"Focus hint, e.g. \"angry customers\" or \"non-English input\"."}}}}}},"security":[{"BearerAuth":[]}]}},"/v1/eval/suites/{id}/proposals":{"get":{"operationId":"evals_listEvalCaseProposals","summary":"List eval case proposals","description":"List a suite’s machine-proposed cases (the review queue). Every generation source — definition-seeded generation, coverage gaps, trace mining, feedback — lands here; nothing enters the suite without an accept.","tags":["evals"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"status","in":"query","description":"Filter by status. Omit for all; the queue UI uses \"proposed\".","required":false,"schema":{"$ref":"#/components/schemas/V1EvalSuitesIdProposalsGetParametersStatus"}},{"name":"limit","in":"query","description":"Number of results (default 50, max 100)","required":false,"schema":{"type":"string"}},{"name":"offset","in":"query","description":"Pagination offset","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Proposals returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvalCaseProposalList"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/eval/suites/{id}/proposals/{proposalId}/accept":{"post":{"operationId":"evals_acceptAnEvalCaseProposal","summary":"Accept an eval case proposal","description":"Materialize a proposal as a test case (origin \"generated\", or \"saved_from_run\" for trace-sourced proposals) and backlink it. Pass an edited body to save your version instead — recorded as \"edited_accepted\"; the machine original stays for audit.","tags":["evals"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"proposalId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Proposal accepted; case created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvalCaseProposalAccepted"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Already resolved","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"case":{"$ref":"#/components/schemas/V1EvalSuitesIdProposalsProposalIdAcceptPostRequestBodyContentApplicationJsonSchemaCase","description":"Reviewer-edited case body. Omit to accept the proposal verbatim; provide it to save an edited version (recorded as \"edited_accepted\"; the machine original stays on the proposal for audit)."}}}}}},"security":[{"BearerAuth":[]}]}},"/v1/eval/suites/{id}/proposals/{proposalId}/reject":{"post":{"operationId":"evals_rejectAnEvalCaseProposal","summary":"Reject an eval case proposal","description":"Reject a proposal. The row survives as audit and as a dedup signal for future generation passes.","tags":["evals"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"proposalId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Proposal rejected","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Evals_rejectAnEvalCaseProposal_Response_200"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Already resolved","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/eval/suites/{id}/run":{"post":{"operationId":"evals_runEvalSuite","summary":"Run eval suite","description":"Run every enabled case of the suite against its target and grade the outputs with the suite graders. Suites within the synchronous case limit (50) run inline and return the full scored result; larger suites are queued as a durable run (202) that is graded when it completes — poll GET /eval/runs/{runId}/scores. Both paths persist per-case scores to the same run history.","tags":["evals"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Suite ran synchronously — score + per-case grader outcomes","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEvalResponse"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Daily eval limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvalQuotaExceededError"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found, a version selector that names no pointer (alias_not_found, alias_archived, alias_expired, version_not_found), or a saved agent with no runnable live version (AGENT_NOT_DEPLOYED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"A durable run of a flow target the batch host cannot run (RUNTIME_LANE_INELIGIBLE, with `reasons`). Nothing is queued and no eval run is counted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchLaneRefusalError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalError"}}}},"503":{"description":"Database temporarily unavailable; nothing was read or written. Retry after the `Retry-After` interval (seconds).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatabaseUnavailableError"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"agent":{"$ref":"#/components/schemas/EvalAgentSelector"},"mode":{"$ref":"#/components/schemas/V1EvalSuitesIdRunPostRequestBodyContentApplicationJsonSchemaMode","description":"Force the execution path. Default: sync for suites within the synchronous case limit (50), batch above it."},"modelOverride":{"type":"string","minLength":1,"description":"Run every case against this model instead of the target’s configured one, without editing the suite or its target. Re-run the same suite once per candidate model and compare scores to pick a model on graded evidence. Applies to both flow and agent targets."},"strict":{"type":"boolean","description":"Strict grading: a soft grader miss fails its case like a gate miss."}}}}}},"security":[{"BearerAuth":[]}]}},"/v1/eval/{id}/results":{"get":{"operationId":"evals_getEvalResults","summary":"Get eval results","description":"Get detailed results for a specific eval batch including step results and tool calls.","tags":["evals"],"parameters":[{"name":"id","in":"path","description":"Batch execution ID","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Eval results returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Evals_getEvalResults_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalError"}}}},"503":{"description":"Database temporarily unavailable; nothing was read or written. Retry after the `Retry-After` interval (seconds).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatabaseUnavailableError"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/events":{"get":{"operationId":"events_pollProductEvents","summary":"Poll product events","description":"Reads your organization's product events in cursor order. Omit `after` to start from now: the response carries no events and the current cursor. Pass the returned `cursor` back as `after` on the next call. `waitMs` holds the request open until an event arrives or the wait ends (at most 50000 ms). Events are kept for seven days.","tags":["events"],"parameters":[{"name":"name","in":"query","description":"One event type from `GET /v1/events/types`; omit for every type","required":false,"schema":{"type":"string","minLength":1,"maxLength":80}},{"name":"after","in":"query","description":"Decimal cursor; events after it are returned","required":false,"schema":{"type":"string","pattern":"^(0|[1-9]\\d{0,18})$"}},{"name":"maxAgeMs","in":"query","description":"Skip events older than this many milliseconds","required":false,"schema":{"type":["integer","null"],"minimum":0,"maximum":604800000}},{"name":"maxEvents","in":"query","description":"Page size, default 50","required":false,"schema":{"type":"integer","minimum":1,"maximum":200}},{"name":"waitMs","in":"query","description":"Long-poll: wait up to this long for a matching event","required":false,"schema":{"type":["integer","null"],"minimum":0,"maximum":50000}},{"name":"agentId","in":"query","description":"Only events for this agent","required":false,"schema":{"type":"string","minLength":1,"maxLength":255}},{"name":"flowId","in":"query","description":"Only events for this flow","required":false,"schema":{"type":"string","minLength":1,"maxLength":255}},{"name":"productId","in":"query","description":"Only events inside this product","required":false,"schema":{"type":"string","minLength":1,"maxLength":255}},{"name":"surfaceId","in":"query","description":"Only events on this surface","required":false,"schema":{"type":"string","minLength":1,"maxLength":255}},{"name":"scheduleId","in":"query","description":"Only events for this schedule","required":false,"schema":{"type":"string","minLength":1,"maxLength":255}},{"name":"suiteId","in":"query","description":"Only events for this eval suite","required":false,"schema":{"type":"string","minLength":1,"maxLength":255}},{"name":"simulationId","in":"query","description":"Only events for this simulation","required":false,"schema":{"type":"string","minLength":1,"maxLength":255}},{"name":"taskId","in":"query","description":"Only events for this delegated task","required":false,"schema":{"type":"string","minLength":1,"maxLength":255}},{"name":"requestId","in":"query","description":"Only events for this API key request","required":false,"schema":{"type":"string","minLength":1,"maxLength":255}},{"name":"key","in":"query","description":"Signal events only: keep occurrences for this signal key","required":false,"schema":{"type":"string","minLength":1,"maxLength":64}},{"name":"onlyRegressions","in":"query","description":"Eval runs only: keep runs whose pass rate dropped","required":false,"schema":{"$ref":"#/components/schemas/V1EventsGetParametersOnlyRegressions"}},{"name":"minIntervalMs","in":"query","description":"Execution failures and fired signals only: coalesce repeats within this window","required":false,"schema":{"type":["integer","null"],"minimum":0,"maximum":86400000}}],"responses":{"200":{"description":"Events after the cursor","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductEventPollResult"}}}},"400":{"description":"Unknown event name or filter arguments it does not accept","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductEventError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Organization workspace required, or the API key lacks every scope the event requires","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PollProductEventsRequestForbiddenError"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/events/types":{"get":{"operationId":"events_listEventTypes","summary":"List event types","description":"The product events you can poll, each with the filter arguments it accepts and the shape of its `data`. An API key sees only the events its scopes cover (each event's `requiredScopes`), plus `runtype.api_key_request.decided` for the key requests it filed; read it by name when the key holds no other event scope.","tags":["events"],"responses":{"200":{"description":"Event catalog","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Events_listEventTypes_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/executions/{executionId}/deliveries/{deliveryId}":{"get":{"operationId":"executions_inspectADurableInputDelivery","summary":"Inspect a durable input delivery","description":"Read the delivery independently of its host execution. Applied means durably incorporated into context, not model compliance. Settled shares the host outcome; not_applied means the host ended before consuming this input. Receipts are retained within the session retry window.","tags":["executions"],"parameters":[{"name":"executionId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"deliveryId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Input delivery receipt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InputDeliveryReceipt"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Delivery not found or expired","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/executions/{executionId}/events":{"get":{"operationId":"executions_streamExecutionEvents","summary":"Stream execution events","description":"Execution-scoped alias of `GET /v1/agents/{id}/executions/{executionId}/events`: reconnect to a durable turn and replay-and-tail its Server-Sent Events without already knowing which agent ran it. The agent is resolved from the execution's own persisted record, so a run started through `/v1/dispatch` reconnects by execution id alone; a record with no agent (an inline definition, which addresses no durable session) answers 404. A turn that streams over an expired watch lease ends with `await` / `awaitReason: \"detached\"` while the execution keeps running; pass the last seen SSE `id:` as `after` to rejoin it. Replays buffered events strictly past the `after` cursor, then live-tails if the turn is still running. Each event carries an SSE `id:` line — a durable row seq, or (unified vocabulary) a composite `<seq>.<subIndex>` when one durable row translates to multiple events. Pass that id verbatim after any disconnect (tab reload, sleep, stream timeout) to resume without missing or duplicating events. Replayed and live-tailed frames use the unified execution vocabulary. A Runtype session turn's response carries `X-Runtype-Execution-Driver`, the driver holding the turn when the stream attached: `request-worker` or `workflow-leg` while that driver holds it, otherwise `owner`. An API key needs `AGENTS:READ`, `AGENTS:*`, `DISPATCH:*`, or `*`; `DISPATCH:*` is admitted because this alias exists for dispatch-started runs.","tags":["executions"],"parameters":[{"name":"executionId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"conversationId","in":"query","description":"Fallback session key, honored only for a turn that persists no session key of its own (the Claude Managed lane). A durable turn resolves its session owner from the persisted execution, and a subagent run from its private child thread.","required":false,"schema":{"type":"string","minLength":1}},{"name":"after","in":"query","description":"Replay only events strictly past this cursor (the last seen SSE id, passed verbatim): a plain row seq, or the composite `<seq>.<subIndex>` a unified-vocabulary stream stamps on intermediate sub-frames. Defaults to 0 (replay the whole turn).","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Server-Sent Events stream (buffered replay followed by a live tail)","content":{"text/event-stream":{"schema":{"$ref":"#/components/schemas/ExecutionStreamEvent"}}}},"400":{"description":"No session owner resolves for this execution","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient API key permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Execution not found, or it addresses no durable session","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Failed to attach to the execution stream","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/executions/{executionId}/journal":{"get":{"operationId":"executions_readAnExecutionJournal","summary":"Read an execution journal","description":"Returns the durable flow-execution journal events for an execution the caller owns, in replay order. At most 1000 events are returned; when the execution has more, the response is capped at that many rows and `truncated` is true.","tags":["executions"],"parameters":[{"name":"executionId","in":"path","description":"Execution ID to read","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Journal events returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Executions_readAnExecutionJournal_Response_200"}}}},"400":{"description":"Invalid execution ID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient API key permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/executions/{executionId}/status":{"get":{"operationId":"executions_pollAnAsynchronousExecution","summary":"Poll an asynchronous execution","description":"Returns lifecycle status and, once terminal, the result of an execution accepted via `Prefer: respond-async`.","tags":["executions"],"parameters":[{"name":"executionId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Execution status returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Executions_pollAnAsynchronousExecution_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient API key permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Execution not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/extraction-models":{"get":{"operationId":"extractionModels_listExtractionModels","summary":"List extraction models","description":"List supported extraction models, their native routes, field and image limits, pricing and credential requirements. An extraction model reads typed field values out of text and images with no generated tokens; it runs the `extract` flow step. This static catalog does not verify account eligibility or spending readiness; execution performs those checks. These models are not chat models.","tags":["extractionModels"],"responses":{"200":{"description":"Supported extraction model catalog.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Extraction_Models_listExtractionModels_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/runtime/extractions":{"post":{"operationId":"extractionModels_extractTypedFieldsHostedExtractionProvider","summary":"Extract typed fields (hosted ExtractionProvider)","description":"The runtime-family extraction contract consumed by `@runtypelabs/runtime`’s HostedExtractionProvider, so a self-hosted runtime on platform or hybrid keys runs the `extract` step through Runtype with a Self-hosted Runtime key (`RUNTIME:EXECUTE`). Billed and recorded like an extract flow step. Requires an Enterprise plan: ineligible accounts receive 403 (code `BYOC_PLAN_REQUIRED`).","tags":["extractionModels"],"responses":{"200":{"description":"The values, answers and extraction metadata","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RuntimeExtractionResponse"}}}},"400":{"description":"Invalid state, fields or images (see `code`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExtractTypedFieldsHostedExtractionProviderRequestBadRequestError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Monthly spend limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Not an API key, the key lacks an execute permission, or the account is not on an Enterprise plan (code `BYOC_PLAN_REQUIRED`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"The extraction model is not served or cannot be funded (see `code`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExtractTypedFieldsHostedExtractionProviderRequestUnprocessableEntityError"}}}},"429":{"description":"Daily execution limit or rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Extraction failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RuntimeExtractionRequest"}}}},"security":[{"BearerAuth":[]}]}},"/v1/feedback":{"get":{"operationId":"feedback_listFeedbackWithFilters","summary":"List feedback with filters","tags":["feedback"],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"string"}},{"name":"offset","in":"query","required":false,"schema":{"type":"string"}},{"name":"record_id","in":"query","required":false,"schema":{"type":"string"}},{"name":"flow_id","in":"query","required":false,"schema":{"type":"string"}},{"name":"surfaceId","in":"query","required":false,"schema":{"type":"string"}},{"name":"type","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Feedback list","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Feedback_listFeedbackWithFilters_Response_200"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]},"post":{"operationId":"feedback_submitFeedbackOnAMessage","summary":"Submit feedback on a message","description":"Submit feedback (upvote/downvote/copy/csat/nps) on a message or conversation.","tags":["feedback"],"responses":{"200":{"description":"Feedback updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Feedback_submitFeedbackOnAMessage_Response_200"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubmitFeedbackOnAMessageRequestBadRequestError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalError"}}}},"503":{"description":"Database temporarily unavailable; nothing was read or written. Retry after the `Retry-After` interval (seconds).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatabaseUnavailableError"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":{"description":"Any type"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/feedback/stats":{"get":{"operationId":"feedback_getFeedbackStatistics","summary":"Get feedback statistics","tags":["feedback"],"parameters":[{"name":"record_id","in":"query","required":false,"schema":{"type":"string"}},{"name":"flow_id","in":"query","required":false,"schema":{"type":"string"}},{"name":"surfaceId","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Feedback statistics","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Feedback_getFeedbackStatistics_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/feedback/{id}":{"get":{"operationId":"feedback_getSpecificFeedbackRecord","summary":"Get specific feedback record","tags":["feedback"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Feedback record","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Feedback_getSpecificFeedbackRecord_Response_200"}}}},"400":{"description":"Invalid feedback ID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Feedback not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]},"delete":{"operationId":"feedback_deleteFeedbackRecord","summary":"Delete feedback record","tags":["feedback"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Feedback deleted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Feedback_deleteFeedbackRecord_Response_200"}}}},"400":{"description":"Invalid feedback ID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Feedback not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/flow-steps/flow/{flowId}":{"get":{"operationId":"flowSteps_getAllFlowStepsForAFlow","summary":"Get all flow steps for a flow","description":"Returns all steps stored in the flow config JSONB column, sorted by order.","tags":["flowSteps"],"parameters":[{"name":"flowId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Flow steps list","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Flow_Steps_getAllFlowStepsForAFlow_Response_200"}}}},"400":{"description":"Invalid flow ID format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Flow not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/flow-versions/{flowId}":{"get":{"operationId":"flowVersions_listVersionsForAFlow","summary":"List versions for a flow","tags":["flowVersions"],"parameters":[{"name":"flowId","in":"path","required":true,"schema":{"type":"string"}},{"name":"type","in":"query","required":false,"schema":{"$ref":"#/components/schemas/V1FlowVersionsFlowIdGetParametersType"}}],"responses":{"200":{"description":"Flow versions list","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Flow_Versions_listVersionsForAFlow_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Flow not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalError"}}}},"503":{"description":"Database temporarily unavailable; nothing was read or written. Retry after the `Retry-After` interval (seconds).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatabaseUnavailableError"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/flow-versions/{flowId}/publish":{"post":{"operationId":"flowVersions_publishASpecificFlowVersion","summary":"Publish a specific flow version","tags":["flowVersions"],"parameters":[{"name":"flowId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Version published","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Flow_Versions_publishASpecificFlowVersion_Response_200"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublishASpecificFlowVersionRequestBadRequestError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Publishing would overwrite a definition managed by code","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublishASpecificFlowVersionRequestConflictError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalError"}}}},"503":{"description":"Database temporarily unavailable; nothing was read or written. Retry after the `Retry-After` interval (seconds).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatabaseUnavailableError"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"onConflict":{"$ref":"#/components/schemas/V1FlowVersionsFlowIdPublishPostRequestBodyContentApplicationJsonSchemaOnConflict","default":"error","description":"Use overwrite only after confirming replacement of a code-managed flow."},"versionId":{"type":"string","minLength":1}},"required":["versionId"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/flow-versions/{flowId}/published":{"get":{"operationId":"flowVersions_getThePublishedVersionForAFlow","summary":"Get the published version for a flow","tags":["flowVersions"],"parameters":[{"name":"flowId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Published flow version","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Flow_Versions_getThePublishedVersionForAFlow_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalError"}}}},"503":{"description":"Database temporarily unavailable; nothing was read or written. Retry after the `Retry-After` interval (seconds).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatabaseUnavailableError"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/flow-versions/{flowId}/{versionId}":{"get":{"operationId":"flowVersions_getASpecificFlowVersion","summary":"Get a specific flow version","tags":["flowVersions"],"parameters":[{"name":"flowId","in":"path","required":true,"schema":{"type":"string"}},{"name":"versionId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Flow version detail","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Flow_Versions_getASpecificFlowVersion_Response_200"}}}},"400":{"description":"Version does not belong to this flow","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalError"}}}},"503":{"description":"Database temporarily unavailable; nothing was read or written. Retry after the `Retry-After` interval (seconds).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatabaseUnavailableError"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/flows":{"get":{"operationId":"flows_listFlows","summary":"List flows","description":"Get all flows for the authenticated user with filtering and cursor pagination.","tags":["flows"],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"string"}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"}},{"name":"direction","in":"query","required":false,"schema":{"type":"string"}},{"name":"includeCount","in":"query","required":false,"schema":{"type":"string"}},{"name":"search","in":"query","required":false,"schema":{"type":"string"}},{"name":"view","in":"query","description":"Response representation. `full` (default) preserves complete values; `compact` shortens every string value longer than 100 characters to a 100-character preview followed by `…`.","required":false,"schema":{"$ref":"#/components/schemas/V1FlowsGetParametersView"}},{"name":"include","in":"query","description":"usage adds each flow usage: the model ids its steps name and the record types its steps write.","required":false,"schema":{"$ref":"#/components/schemas/V1FlowsGetParametersInclude"}}],"responses":{"200":{"description":"Paginated list of flows","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Flows_listFlows_Response_200"}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]},"post":{"operationId":"flows_createFlow","summary":"Create flow","description":"Create a new flow with step definitions.","tags":["flows"],"responses":{"201":{"description":"Created flow","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Flows_createFlow_Response_201"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"description":{"type":["string","null"],"maxLength":5000},"flowSteps":{"type":"array","items":{"$ref":"#/components/schemas/V1FlowsPostRequestBodyContentApplicationJsonSchemaFlowStepsItems"}},"inputs":{"type":"array","items":{"$ref":"#/components/schemas/V1FlowsPostRequestBodyContentApplicationJsonSchemaInputsItems"},"description":"Inputs the flow expects its caller to supply. Declared names do not raise UNDECLARED_VARIABLE_REFERENCE."},"name":{"type":"string","minLength":1},"steps":{"type":"array","items":{"$ref":"#/components/schemas/V1FlowsPostRequestBodyContentApplicationJsonSchemaStepsItems"}}},"required":["name"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/flows/ensure":{"post":{"operationId":"flows_ensureFlowConfigAsCodeConverge","summary":"Ensure flow (config-as-code converge)","description":"Idempotently converge a repo-defined flow definition onto the platform. Identity is name + account scope. Hash-only probes skip the payload in the steady state (a miss is a normal 200 `definitionRequired` response, not an error); full requests create the flow or append a new version when the canonical content hash differs. Non-executing: never touches the execution pipeline — the deploy-time sibling of the dispatch-coupled `flowMode: \"upsert\"` (which saves and runs in one request). The response always carries the server-computed canonical hash. Set dryRun to plan without writing (CI drift gate), onConflict: \"overwrite\" to converge over dashboard/API edits, and release: \"publish\" to also re-aim the published-version pointer. Optional version.label / version.notes stamp provenance (a git SHA, a release tag) on the appended version row.","tags":["flows"],"responses":{"200":{"description":"Converge result: unchanged | created | updated | definitionRequired (hash miss — retry with the full definition) | plan (dryRun)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FlowEnsureResponse"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflict: external_modification (last write was not ensure; pass onConflict: \"overwrite\") or remote_changed (expectedRemoteHash guard)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FlowEnsureConflict"}}}},"422":{"description":"Submitted contentHash does not match the server-recomputed canonical hash","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FlowEnsureHashMismatch"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"contentHash":{"type":"string","pattern":"^[0-9a-f]{64}$"},"definition":{"$ref":"#/components/schemas/V1FlowsEnsurePostRequestBodyContentApplicationJsonSchemaDefinition"},"dryRun":{"type":"boolean"},"expectedRemoteHash":{"type":"string","pattern":"^[0-9a-f]{64}$"},"name":{"type":"string","minLength":1},"onConflict":{"$ref":"#/components/schemas/V1FlowsEnsurePostRequestBodyContentApplicationJsonSchemaOnConflict"},"release":{"$ref":"#/components/schemas/V1FlowsEnsurePostRequestBodyContentApplicationJsonSchemaRelease"},"version":{"$ref":"#/components/schemas/EnsureVersionMetadata"}},"required":["name"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/flows/pull":{"get":{"operationId":"flows_pullFlowDefinitionConfigAsCode","summary":"Pull flow definition (config-as-code)","description":"Return the canonical config-as-code definition and provenance for a flow by name — the absorb-drift direction of the ensure protocol. The contentHash is recomputed from the live flow state, so it is accurate even immediately after a dashboard edit.","tags":["flows"],"parameters":[{"name":"name","in":"query","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Canonical definition + provenance","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FlowPullResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No flow with that name in the account scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/flows/{id}":{"get":{"operationId":"flows_getFlowDetails","summary":"Get flow details","description":"Get a flow by ID including its step definitions.","tags":["flows"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Flow details with steps","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Flows_getFlowDetails_Response_200"}}}},"400":{"description":"Invalid flow ID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Flow not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]},"put":{"operationId":"flows_updateFlow","summary":"Update flow","description":"Update a flow and/or its step definitions.","tags":["flows"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Updated flow","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Flows_updateFlow_Response_200"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Flow not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"description":{"type":["string","null"],"maxLength":5000},"flowSteps":{"type":"array","items":{"$ref":"#/components/schemas/V1FlowsIdPutRequestBodyContentApplicationJsonSchemaFlowStepsItems"}},"inputs":{"type":["array","null"],"items":{"$ref":"#/components/schemas/V1FlowsIdPutRequestBodyContentApplicationJsonSchemaInputsItems"},"description":"Inputs the flow expects its caller to supply. Declared names do not raise UNDECLARED_VARIABLE_REFERENCE."},"name":{"type":"string","minLength":1}}}}}},"security":[{"BearerAuth":[]}]},"delete":{"operationId":"flows_deleteFlow","summary":"Delete flow","description":"Delete a flow by ID. Cascades to associated step results and prompts.","tags":["flows"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Flow deleted","content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"400":{"description":"Invalid flow ID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Flow not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/flows/{id}/export-runtime":{"get":{"operationId":"flows_exportFlowForRuntimeLimitedPreview","summary":"Export flow for runtime (limited preview)","description":"Export a fully-resolved, self-contained flow definition that the @runtypelabs/runtime package can consume directly at boot. All step configs are inlined; no live DB queries are needed at execution time. A configured `decision_judge` tool carries its published question set (questions, model, version, input mapping and current calibration) at `config.questionSet`, resolved once at export so a self-hosted runtime never looks the question set up; a question set that is missing, unpublished, owned by another account, or pinned to an unpublished version is reported in `warnings` with reason `question_set_unresolved` instead of failing the export. An export that would carry a literal credential typed into a tool config or MCP server is refused with `422` and code `raw_credential_in_export`. Requires the `RUNTIME:EXPORT` scope and an Enterprise plan (the `byoc` entitlement); an unentitled account receives `403` with code `BYOC_PLAN_REQUIRED` in every environment.\n\nThe response carries `hostDependencies`: the runtime seams the exported artifact needs a host to wire before it can run everything it describes. A durable-class step (`wait-until` or `crawl`) anywhere in the flow's executable closure declares a `durable-pause-host` dependency; a detached-capable dynamic subagent pool or a detached inline subagent tool declares a `background-run-coordinator` dependency; an account-owned tool reference (`mcp:` or `builtin:` integration id) the export did not inline declares a `hosted-tool-resolver` dependency; and an enabled record step (`upsert-record`, `update-record`, `get-record`, `list-records`, `retrieve-record`) declares a `record-store` dependency. The array is empty when nothing needs wiring, and the export is never refused for a declared dependency.\n\nThe response also carries `warnings`: each Claude Managed agent the flow references (embedded only as a stub the runtime cannot run), and each child flow or sub-agent that an embedded agent could not include, with the reason, and each configured decision tool whose question set could not be resolved (`question_set_unresolved`). The array is empty when every child was embedded.","tags":["flows"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Exported flow definition","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Flows_exportFlowForRuntimeLimitedPreview_Response_200"}}}},"400":{"description":"Invalid flow ID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions, or the account plan does not include runtime extraction (code `BYOC_PLAN_REQUIRED`, Enterprise plans only)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Flow not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"The export would carry a literal credential (code `raw_credential_in_export`); `details` names each tool or MCP server field without echoing the value","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RuntimeExportError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/flows/{id}/publish":{"post":{"operationId":"flows_publishFlow","summary":"Publish flow","description":"Promote a flow draft version to published.","tags":["flows"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Flow published","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Flows_publishFlow_Response_200"}}}},"400":{"description":"Invalid flow ID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Flow or draft version not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Flow is managed by code","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublishFlowRequestConflictError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/flows/{id}/run-on-record-type":{"post":{"operationId":"flows_runFlowOnRecordsOfAType","summary":"Run flow on records of a type","description":"Execute a flow against every record of the given type. Small batches (≤10) execute immediately and return 200; larger batches return 202 with a scheduled batchId.","tags":["flows"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Batch executed immediately","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Flows_runFlowOnRecordsOfAType_Response_200"}}}},"400":{"description":"Validation error or no matching records","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunFlowOnRecordsOfATypeRequestBadRequestError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Flow not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Flow requires behavior not supported by the runtime execution surface","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunFlowOnRecordsOfATypeRequestUnprocessableEntityError"}}}},"429":{"description":"Daily execution limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"recordType":{"type":"string","minLength":1}},"required":["recordType"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/flows/{id}/step-results":{"get":{"operationId":"flows_listFlowStepResults","summary":"List flow step results","description":"Get unified step execution results for a flow with filtering and offset pagination.","tags":["flows"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"recordId","in":"query","required":false,"schema":{"type":"string"}},{"name":"batchId","in":"query","required":false,"schema":{"type":"string"}},{"name":"status","in":"query","required":false,"schema":{"type":"string"}},{"name":"stepId","in":"query","required":false,"schema":{"type":"string"}},{"name":"from","in":"query","required":false,"schema":{"type":"string"}},{"name":"to","in":"query","required":false,"schema":{"type":"string"}},{"name":"sortBy","in":"query","required":false,"schema":{"type":"string"}},{"name":"sortOrder","in":"query","required":false,"schema":{"$ref":"#/components/schemas/V1FlowsIdStepResultsGetParametersSortOrder"}},{"name":"limit","in":"query","required":false,"schema":{"type":"string"}},{"name":"offset","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Step results","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Flows_listFlowStepResults_Response_200"}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Flow not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/integration-configs":{"get":{"operationId":"integrationConfigs_listIntegrationConfigs","summary":"List integration configs","description":"Returns the configuration status of all integration providers for the authenticated user.","tags":["integrationConfigs"],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Integration_Configs_listIntegrationConfigs_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/integration-configs/{provider}":{"get":{"operationId":"integrationConfigs_getIntegrationConfigStatus","summary":"Get integration config status","description":"Returns whether a specific integration provider is configured for the authenticated user.","tags":["integrationConfigs"],"parameters":[{"name":"provider","in":"path","description":"Integration provider name","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Integration_Configs_getIntegrationConfigStatus_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]},"post":{"operationId":"integrationConfigs_createOrUpdateAnIntegrationConfig","summary":"Create or update an integration config","description":"Stores an API key for the specified integration provider. Storing a NEW integration key requires the BYOK (Bring Your Own Key) entitlement; rotating a key that already exists for the provider is always allowed.","tags":["integrationConfigs"],"parameters":[{"name":"provider","in":"path","description":"Integration provider name","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Integration config saved","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Integration_Configs_createOrUpdateAnIntegrationConfig_Response_200"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"BYOK entitlement required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Organization model configuration already migrated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateOrUpdateAnIntegrationConfigRequestConflictError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"apiKey":{"type":"string","minLength":1,"description":"API key for the provider"}},"required":["apiKey"]}}}},"security":[{"BearerAuth":[]}]},"delete":{"operationId":"integrationConfigs_deleteAnIntegrationConfig","summary":"Delete an integration config","description":"Removes the API key and configuration for the specified integration provider.","tags":["integrationConfigs"],"parameters":[{"name":"provider","in":"path","description":"Integration provider name","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Integration config deleted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Integration_Configs_deleteAnIntegrationConfig_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Organization model configuration already migrated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteAnIntegrationConfigRequestConflictError"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/integrations":{"get":{"operationId":"integrations_listIntegrations","summary":"List integrations","description":"List all available integrations with the caller’s configuration status. Optionally filter credential status by environment.","tags":["integrations"],"parameters":[{"name":"environment","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"List of integrations with configuration status","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Integrations_listIntegrations_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]},"post":{"operationId":"integrations_reserveANewIntegration","summary":"Reserve a new integration","description":"Reserve a new integration row server-side. Returns a pending row scoped to the authenticated owner whose id may be embedded in provider manifests before credentials are supplied.","tags":["integrations"],"responses":{"201":{"description":"Pending integration reserved","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Integrations_reserveANewIntegration_Response_201"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"provider":{"$ref":"#/components/schemas/V1IntegrationsPostRequestBodyContentApplicationJsonSchemaProvider"}},"required":["provider"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/integrations/category/{category}":{"get":{"operationId":"integrations_listIntegrationsByCategory","summary":"List integrations by category","description":"List integrations within a given category along with the caller’s configuration status for each.","tags":["integrations"],"parameters":[{"name":"category","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"List of integrations in the category","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Integrations_listIntegrationsByCategory_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/integrations/connections":{"get":{"operationId":"integrations_listConnectedIntegrationAccounts","summary":"List connected integration accounts","description":"List connected integration accounts available in the caller's active personal or organization scope. Use an integration ID to pin a tool instance to a specific connection, e.g. a Granola tool's toolConfigs integrationId.","tags":["integrations"],"parameters":[{"name":"provider","in":"query","description":"Integration provider, e.g. granola or slack.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Connected accounts for the provider","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Integrations_listConnectedIntegrationAccounts_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/integrations/credentials-status":{"get":{"operationId":"integrations_getIntegrationCredentialStatus","summary":"Get integration credential status","description":"Return which environments have credentials configured for each integration for the authenticated caller.","tags":["integrations"],"responses":{"200":{"description":"Per-environment credential status","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Integrations_getIntegrationCredentialStatus_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/integrations/granola/install":{"post":{"operationId":"integrations_installGranolaIntegration","summary":"Install Granola integration","description":"Install or upsert a Granola integration for the authenticated owner. Verifies the pasted API key against the Granola public API before storing it in the secret store. Re-pasting the same key updates the existing connection.","tags":["integrations"],"responses":{"200":{"description":"Granola integration installed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Integrations_installGranolaIntegration_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Granola rejected the API key (invalid key or plan does not include API access)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Granola API unreachable during key verification","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"apiKey":{"type":"string","minLength":1},"displayName":{"type":"string","minLength":1,"maxLength":100}},"required":["apiKey"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/integrations/slack/app-status":{"get":{"operationId":"integrations_checkSlackAppCreationStatus","summary":"Check Slack app creation status","description":"Report whether Slack has sent an events-URL verification challenge to a surface's Slack webhook. Slack issues that challenge when an app is created from a manifest, so a verifiedAt newer than the one observed before the manifest was handed out is evidence the customer's Slack app now exists. Verification markers expire an hour after they are recorded, and the check is advisory: the OAuth install remains the authority on whether an integration is usable.","tags":["integrations"],"parameters":[{"name":"surfaceId","in":"query","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Slack app creation status","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Integrations_checkSlackAppCreationStatus_Response_200"}}}},"400":{"description":"Invalid surface ID format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Surface not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/integrations/slack/install":{"post":{"operationId":"integrations_installSlackIntegration","summary":"Install Slack integration","description":"Install or upsert a Slack app integration for the authenticated owner, writing bot token and signing secret into the secret store.","tags":["integrations"],"responses":{"200":{"description":"Slack integration installed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Integrations_installSlackIntegration_Response_200"}}}},"400":{"description":"Invalid surface or integration ID format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Surface not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"appId":{"type":"string","minLength":1},"botToken":{"type":"string","minLength":1},"botUserId":{"type":"string","minLength":1},"enterpriseId":{"type":"string","minLength":1},"enterpriseName":{"type":"string","minLength":1},"integrationId":{"type":"string","minLength":1},"isEnterpriseInstall":{"type":"boolean"},"scopes":{"type":"array","items":{"type":"string"}},"signingSecret":{"type":"string","minLength":1},"surfaceId":{"type":"string","minLength":1},"teamId":{"type":"string","minLength":1},"teamName":{"type":"string","minLength":1}},"required":["botToken","signingSecret","teamId"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/integrations/slack/manifest":{"post":{"operationId":"integrations_generateSlackAppManifest","summary":"Generate Slack app manifest","description":"Generate the Slack app manifest for a surface, with absolute API URLs (events webhook, interactivity webhook, and OAuth redirect), plus a link to Slack's app-creation page and a hosted connect-page handoff for the human credential + OAuth step. Paste the manifest into Slack's From a manifest option; Slack no longer accepts a manifest embedded in the URL. The redirect URL matches the OAuth start route byte-for-byte. When integrationId is omitted a pending Slack integration is reserved automatically (24h TTL) and returned as integrationId. A supplied integrationId must be a live pending reservation; an already-connected, revoked, or expired one is refused with 404, so omit it to get a fresh reservation. Credentials never pass through this route.","tags":["integrations"],"responses":{"200":{"description":"Slack app manifest generated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Integrations_generateSlackAppManifest_Response_200"}}}},"400":{"description":"Invalid surface or integration ID format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Surface or integration not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"appName":{"type":"string","minLength":1},"includeAssistantFeatures":{"type":"boolean"},"integrationId":{"type":"string","minLength":1},"surfaceId":{"type":"string","minLength":1}},"required":["surfaceId"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/integrations/slack/rotate-credentials":{"post":{"operationId":"integrations_rotateSlackCredentials","summary":"Rotate Slack credentials","description":"Rotate any subset of bot token, signing secret, or app ID on an existing Slack integration without re-supplying the others.","tags":["integrations"],"responses":{"200":{"description":"Slack credentials rotated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Integrations_rotateSlackCredentials_Response_200"}}}},"400":{"description":"Invalid integration ID format or bot token failed auth.test","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Integration not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Slack workspace mismatch","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"appId":{"type":"string","minLength":1},"botToken":{"type":"string","minLength":1},"integrationId":{"type":"string","minLength":1},"signingSecret":{"type":"string","minLength":1}},"required":["integrationId"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/integrations/telegram/install":{"post":{"operationId":"integrations_installTelegramIntegration","summary":"Install Telegram integration","description":"Install or upsert a Telegram bot integration for the authenticated owner, writing bot token and webhook secret into the secret store and registering the webhook with Telegram.","tags":["integrations"],"responses":{"200":{"description":"Telegram integration installed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Integrations_installTelegramIntegration_Response_200"}}}},"400":{"description":"Invalid surface or integration ID format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Surface not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Failed to register webhook with Telegram","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"botId":{"type":"string","minLength":1},"botName":{"type":"string","minLength":1},"botToken":{"type":"string","minLength":1},"botUsername":{"type":"string","minLength":1},"integrationId":{"type":"string","minLength":1},"surfaceId":{"type":"string","minLength":1},"webhookSecret":{"type":"string","minLength":1}},"required":["botId","botToken"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/integrations/telegram/managed/available":{"get":{"operationId":"integrations_checkManagedTelegramBotAvailability","summary":"Check managed Telegram bot availability","description":"Returns whether managed Telegram bot creation is configured on this deployment.","tags":["integrations"],"responses":{"200":{"description":"Availability status","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Integrations_checkManagedTelegramBotAvailability_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/integrations/telegram/managed/initiate":{"post":{"operationId":"integrations_initiateManagedTelegramBotCreation","summary":"Initiate managed Telegram bot creation","description":"Initiate creation of a managed Telegram bot, returning a deep link to the manager bot and a pending request id.","tags":["integrations"],"responses":{"201":{"description":"Managed bot creation initiated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Integrations_initiateManagedTelegramBotCreation_Response_201"}}}},"400":{"description":"Invalid surface or integration ID format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Surface not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Managed bot request limit reached","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Managed bot creation is not available","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"botCommands":{"type":"array","items":{"$ref":"#/components/schemas/V1IntegrationsTelegramManagedInitiatePostRequestBodyContentApplicationJsonSchemaBotCommandsItems"}},"botDescription":{"type":"string","maxLength":512},"integrationId":{"type":"string","minLength":1},"suggestedBotName":{"type":"string","minLength":1,"maxLength":64},"suggestedUsername":{"type":"string","minLength":1,"maxLength":32},"surfaceId":{"type":"string","minLength":1}},"required":["suggestedBotName"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/integrations/telegram/managed/{integrationId}/rotate-token":{"post":{"operationId":"integrations_rotateManagedTelegramBotToken","summary":"Rotate managed Telegram bot token","description":"Rotate the bot token of a managed Telegram bot via the manager bot and persist the new token in the secret store.","tags":["integrations"],"parameters":[{"name":"integrationId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Token rotated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Integrations_rotateManagedTelegramBotToken_Response_200"}}}},"400":{"description":"Invalid integration ID format or unsupported integration","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Integration not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Token rotation failed upstream","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Managed bot token rotation is not available","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/integrations/telegram/managed/{requestId}":{"delete":{"operationId":"integrations_cancelManagedTelegramBotRequest","summary":"Cancel managed Telegram bot request","description":"Cancels an in-progress managed Telegram bot creation request.","tags":["integrations"],"parameters":[{"name":"requestId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Request cancelled","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Integrations_cancelManagedTelegramBotRequest_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Request not found or already completed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/integrations/telegram/managed/{requestId}/confirm-rename":{"post":{"operationId":"integrations_confirmManagedTelegramBotRename","summary":"Confirm managed Telegram bot rename","description":"Confirm that a renamed managed Telegram bot belongs to the caller, clearing the dashboard rename prompt.","tags":["integrations"],"parameters":[{"name":"requestId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Rename confirmed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Integrations_confirmManagedTelegramBotRename_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Request not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Rename decision is no longer applicable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/integrations/telegram/managed/{requestId}/reject-rename":{"post":{"operationId":"integrations_rejectManagedTelegramBotRename","summary":"Reject managed Telegram bot rename","description":"Reject a renamed managed Telegram bot, tearing down its integration record and credentials so the user can retry.","tags":["integrations"],"parameters":[{"name":"requestId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Rename rejected","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Integrations_rejectManagedTelegramBotRename_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Request not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Rename decision is no longer applicable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/integrations/telegram/managed/{requestId}/status":{"get":{"operationId":"integrations_getManagedTelegramBotRequestStatus","summary":"Get managed Telegram bot request status","description":"Returns the current status of a managed Telegram bot creation request.","tags":["integrations"],"parameters":[{"name":"requestId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Managed bot request status","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Integrations_getManagedTelegramBotRequestStatus_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/integrations/tools":{"get":{"operationId":"integrations_listConfiguredIntegrationTools","summary":"List configured integration tools","description":"List all tools available from integrations that have valid credentials configured for the caller.","tags":["integrations"],"responses":{"200":{"description":"List of configured integration tools","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Integrations_listConfiguredIntegrationTools_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/integrations/vectorize":{"get":{"operationId":"integrations_listVectorizeConfigurations","summary":"List Vectorize configurations","description":"Get all Cloudflare Vectorize configurations for the authenticated user.","tags":["integrations"],"responses":{"200":{"description":"List of Vectorize configurations","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Integrations_listVectorizeConfigurations_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]},"post":{"operationId":"integrations_createVectorizeConfiguration","summary":"Create Vectorize configuration","description":"Create a new Cloudflare Vectorize configuration for the authenticated user.","tags":["integrations"],"responses":{"201":{"description":"Created Vectorize configuration","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Integrations_createVectorizeConfiguration_Response_201"}}}},"400":{"description":"Invalid configuration or connection error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"accountId":{"type":"string","minLength":10},"apiToken":{"type":"string","minLength":1},"indexName":{"type":"string","minLength":1},"name":{"type":"string","minLength":1,"maxLength":100},"timeout":{"type":"number","format":"double","minimum":1000,"maximum":120000}},"required":["accountId","apiToken","indexName","name"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/integrations/vectorize/indexes/create":{"post":{"operationId":"integrations_createVectorizeIndex","summary":"Create Vectorize index","description":"Create a new Vectorize index in a Cloudflare account using provided or stored credentials.","tags":["integrations"],"responses":{"201":{"description":"Created Vectorize index","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Integrations_createVectorizeIndex_Response_201"}}}},"400":{"description":"Missing or invalid parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Configuration not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"accountId":{"type":"string"},"apiToken":{"type":"string"},"configId":{"type":"string"},"description":{"type":"string"},"dimensions":{"type":"number","format":"double"},"indexName":{"type":"string"},"metric":{"type":"string"}},"required":["dimensions","indexName","metric"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/integrations/vectorize/indexes/list":{"post":{"operationId":"integrations_listVectorizeIndexes","summary":"List Vectorize indexes","description":"List all Vectorize indexes in a Cloudflare account using provided or stored credentials.","tags":["integrations"],"responses":{"200":{"description":"List of Vectorize indexes","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Integrations_listVectorizeIndexes_Response_200"}}}},"400":{"description":"Missing or invalid credentials","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Configuration not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"accountId":{"type":"string"},"apiToken":{"type":"string"},"configId":{"type":"string"}}}}}},"security":[{"BearerAuth":[]}]}},"/v1/integrations/vectorize/test":{"post":{"operationId":"integrations_testNewVectorizeConfiguration","summary":"Test new Vectorize configuration","description":"Test the connection to a Cloudflare Vectorize configuration before saving it.","tags":["integrations"],"responses":{"200":{"description":"Connection test result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Integrations_testNewVectorizeConfiguration_Response_200"}}}},"400":{"description":"Connection test failed or invalid configuration","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized or authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"accountId":{"type":"string","minLength":10},"apiToken":{"type":"string","minLength":1},"indexName":{"type":"string","minLength":1},"name":{"type":"string","minLength":1,"maxLength":100},"timeout":{"type":"number","format":"double","minimum":1000,"maximum":120000}},"required":["accountId","apiToken","indexName","name"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/integrations/vectorize/{id}":{"get":{"operationId":"integrations_getVectorizeConfiguration","summary":"Get Vectorize configuration","description":"Get a specific Cloudflare Vectorize configuration by ID.","tags":["integrations"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Vectorize configuration","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Integrations_getVectorizeConfiguration_Response_200"}}}},"400":{"description":"Invalid configuration ID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Configuration not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]},"put":{"operationId":"integrations_updateVectorizeConfiguration","summary":"Update Vectorize configuration","description":"Update an existing Cloudflare Vectorize configuration by ID.","tags":["integrations"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Updated Vectorize configuration","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Integrations_updateVectorizeConfiguration_Response_200"}}}},"400":{"description":"Invalid configuration or connection error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Configuration not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"accountId":{"type":"string","minLength":10},"apiToken":{"type":"string","minLength":1},"indexName":{"type":"string","minLength":1},"name":{"type":"string","minLength":1,"maxLength":100},"timeout":{"type":"number","format":"double","minimum":1000,"maximum":120000}}}}}},"security":[{"BearerAuth":[]}]},"delete":{"operationId":"integrations_deleteVectorizeConfiguration","summary":"Delete Vectorize configuration","description":"Delete a Cloudflare Vectorize configuration by ID.","tags":["integrations"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Configuration deleted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Integrations_deleteVectorizeConfiguration_Response_200"}}}},"400":{"description":"Invalid configuration ID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Configuration not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/integrations/vectorize/{id}/test":{"post":{"operationId":"integrations_testSavedVectorizeConfiguration","summary":"Test saved Vectorize configuration","description":"Test the connection to a saved Cloudflare Vectorize configuration.","tags":["integrations"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Connection test result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Integrations_testSavedVectorizeConfiguration_Response_200"}}}},"400":{"description":"Connection test failed or invalid ID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized or authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Configuration not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/integrations/weaviate":{"get":{"operationId":"integrations_listWeaviateConfigurations","summary":"List Weaviate configurations","description":"Get all Weaviate configurations for the authenticated user.","tags":["integrations"],"responses":{"200":{"description":"List of Weaviate configurations","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Integrations_listWeaviateConfigurations_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]},"post":{"operationId":"integrations_createWeaviateConfiguration","summary":"Create Weaviate configuration","description":"Create a new Weaviate configuration.","tags":["integrations"],"responses":{"201":{"description":"Created Weaviate configuration","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Integrations_createWeaviateConfiguration_Response_201"}}}},"400":{"description":"Validation or connection error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"apiKey":{"type":"string","minLength":1},"headers":{"type":"object","additionalProperties":{"type":"string"}},"name":{"type":"string","minLength":1,"maxLength":100},"settings":{"$ref":"#/components/schemas/V1IntegrationsWeaviatePostRequestBodyContentApplicationJsonSchemaSettings"},"url":{"type":"string","format":"uri"}},"required":["apiKey","name","url"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/integrations/weaviate/test":{"post":{"operationId":"integrations_testNewWeaviateConfiguration","summary":"Test new Weaviate configuration","description":"Test the connection to a Weaviate instance before saving the configuration.","tags":["integrations"],"responses":{"200":{"description":"Connection test result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Integrations_testNewWeaviateConfiguration_Response_200"}}}},"400":{"description":"Connection failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TestNewWeaviateConfigurationRequestBadRequestError"}}}},"401":{"description":"Unauthorized or auth failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TestNewWeaviateConfigurationRequestUnauthorizedError"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TestNewWeaviateConfigurationRequestInternalServerError"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"apiKey":{"type":"string","minLength":1},"headers":{"type":"object","additionalProperties":{"type":"string"}},"name":{"type":"string","minLength":1,"maxLength":100},"settings":{"$ref":"#/components/schemas/V1IntegrationsWeaviateTestPostRequestBodyContentApplicationJsonSchemaSettings"},"url":{"type":"string","format":"uri"}},"required":["apiKey","name","url"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/integrations/weaviate/{id}":{"get":{"operationId":"integrations_getWeaviateConfiguration","summary":"Get Weaviate configuration","description":"Get a specific Weaviate configuration by ID.","tags":["integrations"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Weaviate configuration","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Integrations_getWeaviateConfiguration_Response_200"}}}},"400":{"description":"Invalid configuration ID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Weaviate configuration not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]},"put":{"operationId":"integrations_updateWeaviateConfiguration","summary":"Update Weaviate configuration","description":"Update an existing Weaviate configuration.","tags":["integrations"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Updated Weaviate configuration","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Integrations_updateWeaviateConfiguration_Response_200"}}}},"400":{"description":"Validation or connection error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Weaviate configuration not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"apiKey":{"type":"string","minLength":1},"headers":{"type":"object","additionalProperties":{"type":"string"}},"name":{"type":"string","minLength":1,"maxLength":100},"settings":{"$ref":"#/components/schemas/V1IntegrationsWeaviateIdPutRequestBodyContentApplicationJsonSchemaSettings"},"url":{"type":"string","format":"uri"}}}}}},"security":[{"BearerAuth":[]}]},"delete":{"operationId":"integrations_deleteWeaviateConfiguration","summary":"Delete Weaviate configuration","description":"Delete a Weaviate configuration by ID.","tags":["integrations"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Deletion result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Integrations_deleteWeaviateConfiguration_Response_200"}}}},"400":{"description":"Invalid configuration ID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Weaviate configuration not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/integrations/weaviate/{id}/classes":{"post":{"operationId":"integrations_listWeaviateCollections","summary":"List Weaviate collections","description":"List collections from a saved Weaviate configuration with vectorizer and dimension info.","tags":["integrations"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"List of Weaviate collections","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Integrations_listWeaviateCollections_Response_200"}}}},"400":{"description":"Invalid configuration ID or connection failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListWeaviateCollectionsRequestBadRequestError"}}}},"401":{"description":"Unauthorized or auth failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListWeaviateCollectionsRequestUnauthorizedError"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Weaviate configuration not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListWeaviateCollectionsRequestInternalServerError"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/integrations/weaviate/{id}/test":{"post":{"operationId":"integrations_testWeaviateConnection","summary":"Test Weaviate connection","description":"Test the connection to a saved Weaviate instance.","tags":["integrations"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Connection test result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Integrations_testWeaviateConnection_Response_200"}}}},"400":{"description":"Invalid configuration ID or connection failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TestWeaviateConnectionRequestBadRequestError"}}}},"401":{"description":"Unauthorized or auth failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TestWeaviateConnectionRequestUnauthorizedError"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Weaviate configuration not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TestWeaviateConnectionRequestInternalServerError"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/integrations/{integrationId}":{"get":{"operationId":"integrations_getIntegrationDetails","summary":"Get integration details","description":"Get details for a specific integration including its tools and configuration status.","tags":["integrations"],"parameters":[{"name":"integrationId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Integration details","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Integrations_getIntegrationDetails_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Integration not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/integrations/{integrationId}/credentials":{"post":{"operationId":"integrations_saveIntegrationCredentials","summary":"Save integration credentials","description":"Save (insert or update) credentials for a specific integration, optionally scoped to a development or production environment.","tags":["integrations"],"parameters":[{"name":"integrationId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Credentials saved","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Integrations_saveIntegrationCredentials_Response_200"}}}},"400":{"description":"Invalid environment, missing required field, or unsupported integration","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Integration not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"The organization credential has moved to the normalized connection plane. The legacy route refuses the mutation and identifies whether the blocking authority is a connection or provider policy.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaveIntegrationCredentialsRequestConflictError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalError"}}}},"503":{"description":"Database temporarily unavailable; nothing was read or written. Retry after the `Retry-After` interval (seconds).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatabaseUnavailableError"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":{"type":"string"}}}}},"security":[{"BearerAuth":[]}]},"delete":{"operationId":"integrations_deleteIntegrationCredentials","summary":"Delete integration credentials","description":"Delete stored credentials for an integration. Without an environment query param, deletes the \"all environments\" credentials.","tags":["integrations"],"parameters":[{"name":"integrationId","in":"path","required":true,"schema":{"type":"string"}},{"name":"environment","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Credentials removed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Integrations_deleteIntegrationCredentials_Response_200"}}}},"400":{"description":"Unknown integration ID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Integration not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"The organization credential has moved to the normalized connection plane. The legacy route refuses the mutation and identifies whether the blocking authority is a connection or provider policy.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteIntegrationCredentialsRequestConflictError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalError"}}}},"503":{"description":"Database temporarily unavailable; nothing was read or written. Retry after the `Retry-After` interval (seconds).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatabaseUnavailableError"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/integrations/{integrationId}/tools":{"get":{"operationId":"integrations_listToolsForAnIntegration","summary":"List tools for an integration","description":"List all tools defined by a specific integration along with their parameter schemas.","tags":["integrations"],"parameters":[{"name":"integrationId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"List of integration tools","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Integrations_listToolsForAnIntegration_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Integration not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/integrations/{integrationId}/tools/{toolName}":{"get":{"operationId":"integrations_getAnIntegrationTool","summary":"Get an integration tool","description":"Get details for a specific tool within an integration, including its parameter schema.","tags":["integrations"],"parameters":[{"name":"integrationId","in":"path","required":true,"schema":{"type":"string"}},{"name":"toolName","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Integration tool details","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Integrations_getAnIntegrationTool_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Tool not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/logs":{"get":{"operationId":"logs_queryCustomerLogs","summary":"Query customer logs","description":"Query persisted customer logs with filtering, pagination, and search. When `data.live` is present the page came from the span store: one entry is one execution seam, so sub-seam rows (step skips, sources, context notices, artifacts, state snapshots, custom events) are not listed, a start/complete pair is one row carrying a duration, runs still in progress appear once they finish, and `search` matches a span's message, name, operation, tool name or error class. Otherwise each entry is one event. Requests naming `audit` or `schedule`, and an audit-entitled unfiltered read, are always served from the event tier.","tags":["logs"],"parameters":[{"name":"from","in":"query","description":"Start timestamp (ISO 8601). Defaults to 24 hours ago.","required":false,"schema":{"type":"string"}},{"name":"to","in":"query","description":"End timestamp (ISO 8601). Defaults to now.","required":false,"schema":{"type":"string"}},{"name":"startTime","in":"query","description":"Alias for from. Ignored when from is also given.","required":false,"schema":{"type":"string"}},{"name":"endTime","in":"query","description":"Alias for to. Ignored when to is also given.","required":false,"schema":{"type":"string"}},{"name":"level","in":"query","description":"Comma-separated log levels (debug,info,warn,error). An unknown value is rejected with 400.","required":false,"schema":{"type":"string"}},{"name":"category","in":"query","description":"Comma-separated categories (execution,agent,tool,model,system,error,schedule,batch,audit). An unknown value is rejected with 400.","required":false,"schema":{"type":"string"}},{"name":"flowId","in":"query","description":"Filter by flow ID","required":false,"schema":{"type":"string"}},{"name":"agentId","in":"query","description":"Filter by agent ID","required":false,"schema":{"type":"string"}},{"name":"executionId","in":"query","description":"Filter by runtime execution_id / executionSessionId (for example exec_... or otel-...), not the aex_... agent-execution row ID","required":false,"schema":{"type":"string"}},{"name":"surfaceId","in":"query","description":"Filter by surface ID","required":false,"schema":{"type":"string"}},{"name":"conversationId","in":"query","description":"Filter by conversation ID","required":false,"schema":{"type":"string"}},{"name":"search","in":"query","description":"Case-insensitive substring search over a span's message, name, operation, tool name or error class; a live-tier row matches on its message.","required":false,"schema":{"type":"string"}},{"name":"status","in":"query","description":"Comma-separated statuses (running,completed,failed,queued,cancelled,unknown). An unknown value is rejected with 400. A row is unknown while its activity has not finished, else failed at level error and completed otherwise; running, queued and cancelled match no row today.","required":false,"schema":{"type":"string"}},{"name":"type","in":"query","description":"Comma-separated entry types (flow,step,tool,batch,system,agent,model,schedule,audit). An unknown value is rejected with 400. Matches the type each row is rendered with, so step selects step spans only and flow selects flow runs without their steps. Combined with category by AND.","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","description":"Max results per page (default 500, max 1000)","required":false,"schema":{"type":"string"}},{"name":"cursor","in":"query","description":"Pagination cursor","required":false,"schema":{"type":"string"}},{"name":"order","in":"query","description":"Sort order: asc or desc","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Log entries returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Logs_queryCustomerLogs_Response_200"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Audit trail not available on the current plan (category=audit requested)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueryCustomerLogsRequestPaymentRequiredError"}}}},"403":{"description":"API key lacks a read scope (FLOWS:READ, AGENTS:READ or ANALYTICS:READ)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Log store temporarily unavailable; no entries or counts could be read","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/logs/context/{executionId}":{"get":{"operationId":"logs_contextSnapshotsForAnExecution","summary":"Context snapshots for an execution","description":"Returns the ordered context manifest of every provider request in one execution: each block's category, kind, size, and hash, without content.","tags":["logs"],"parameters":[{"name":"executionId","in":"path","description":"Runtime execution_id to read (for example exec_...), not the aex_... agent-execution row ID","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Context snapshots returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Logs_contextSnapshotsForAnExecution_Response_200"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No trace for this execution","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/logs/context/{executionId}/blocks":{"get":{"operationId":"logs_capturedTextOfContextBlocks","summary":"Captured text of context blocks","description":"Returns the captured text of the requested context blocks by manifest hash. A block whose text was not captured (logging policy, capture budget, or an older run) is omitted.","tags":["logs"],"parameters":[{"name":"executionId","in":"path","description":"Runtime execution_id to read (for example exec_...), not the aex_... agent-execution row ID","required":true,"schema":{"type":"string"}},{"name":"hashes","in":"query","description":"Comma-separated manifest entry hashes, 1 to 50.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Block text returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Logs_capturedTextOfContextBlocks_Response_200"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No trace for this execution","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/logs/entry":{"get":{"operationId":"logs_readOneLogEntryInFull","summary":"Read one log entry in full","description":"Returns a single log entry, including the model-call transcript the paged list projection omits. Addressed by the span key: traceId, spanId and timestamp. Bounded to one span, so a detail read never costs a page.","tags":["logs"],"parameters":[{"name":"timestamp","in":"query","description":"The span's exact started_at (ISO 8601)","required":true,"schema":{"type":"string"}},{"name":"traceId","in":"query","description":"Trace the span belongs to; a span id is unique only within its trace.","required":true,"schema":{"type":"string"}},{"name":"spanId","in":"query","description":"Span to read, from a list row’s otlpSpanId.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Entry returned, or null when no row matches","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Logs_readOneLogEntryInFull_Response_200"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"API key lacks a read scope (FLOWS:READ, AGENTS:READ or ANALYTICS:READ)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/logs/stats":{"get":{"operationId":"logs_getAggregatedLogStats","summary":"Get aggregated log stats","description":"Returns aggregated log statistics including histogram, counts by level, and counts by category.","tags":["logs"],"parameters":[{"name":"from","in":"query","description":"Start timestamp (ISO 8601). Defaults to 24 hours ago.","required":false,"schema":{"type":"string"}},{"name":"to","in":"query","description":"End timestamp (ISO 8601). Defaults to now.","required":false,"schema":{"type":"string"}},{"name":"startTime","in":"query","description":"Alias for from. Ignored when from is also given.","required":false,"schema":{"type":"string"}},{"name":"endTime","in":"query","description":"Alias for to. Ignored when to is also given.","required":false,"schema":{"type":"string"}},{"name":"level","in":"query","description":"Comma-separated log levels (debug,info,warn,error). An unknown value is rejected with 400.","required":false,"schema":{"type":"string"}},{"name":"category","in":"query","description":"Comma-separated categories (execution,agent,tool,model,system,error,schedule,batch,audit). An unknown value is rejected with 400.","required":false,"schema":{"type":"string"}},{"name":"flowId","in":"query","description":"Filter by flow ID","required":false,"schema":{"type":"string"}},{"name":"agentId","in":"query","description":"Filter by agent ID","required":false,"schema":{"type":"string"}},{"name":"executionId","in":"query","description":"Filter by runtime execution_id / executionSessionId (for example exec_... or otel-...), not the aex_... agent-execution row ID","required":false,"schema":{"type":"string"}},{"name":"surfaceId","in":"query","description":"Filter by surface ID","required":false,"schema":{"type":"string"}},{"name":"conversationId","in":"query","description":"Filter by conversation ID","required":false,"schema":{"type":"string"}},{"name":"search","in":"query","description":"Case-insensitive substring search over a span's message, name, operation, tool name or error class; a live-tier row matches on its message.","required":false,"schema":{"type":"string"}},{"name":"status","in":"query","description":"Comma-separated statuses (running,completed,failed,queued,cancelled,unknown). An unknown value is rejected with 400. A row is unknown while its activity has not finished, else failed at level error and completed otherwise; running, queued and cancelled match no row today.","required":false,"schema":{"type":"string"}},{"name":"type","in":"query","description":"Comma-separated entry types (flow,step,tool,batch,system,agent,model,schedule,audit). An unknown value is rejected with 400. Matches the type each row is rendered with, so step selects step spans only and flow selects flow runs without their steps. Combined with category by AND.","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","description":"Max results per page (default 500, max 1000)","required":false,"schema":{"type":"string"}},{"name":"cursor","in":"query","description":"Pagination cursor","required":false,"schema":{"type":"string"}},{"name":"order","in":"query","description":"Sort order: asc or desc","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Log stats returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Logs_getAggregatedLogStats_Response_200"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Audit trail not available on the current plan (category=audit requested)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetAggregatedLogStatsRequestPaymentRequiredError"}}}},"403":{"description":"API key lacks a read scope (FLOWS:READ, AGENTS:READ or ANALYTICS:READ)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Log store temporarily unavailable; no entries or counts could be read","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/logs/trace/compare":{"post":{"operationId":"logs_compareTraces","summary":"Compare traces","description":"Structural diff of two executions (tool-sequence alignment, first divergence, per-side totals, shallow argument drift) or of two cohorts given as query filter sets (tool usage, stop reasons and signal rates over at most 50 sampled runs per side).","tags":["logs"],"responses":{"200":{"description":"Comparison","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Logs_compareTraces_Response_200"}}}},"400":{"description":"Unreadable filter, window over the cap, or too many runs to probe; `code` says which","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"API key lacks a read scope (FLOWS:READ, AGENTS:READ or ANALYTICS:READ)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No trace for one of the executions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Log store temporarily unavailable; no entries or counts could be read","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TraceCompareRequest"}}}},"security":[{"BearerAuth":[]}]}},"/v1/logs/trace/conversation/{conversationId}":{"get":{"operationId":"logs_traceAConversation","summary":"Trace a conversation","description":"Returns trace data for all executions within a conversation.","tags":["logs"],"parameters":[{"name":"conversationId","in":"path","description":"Conversation ID to trace","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Conversation trace returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Logs_traceAConversation_Response_200"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"API key lacks a read scope (FLOWS:READ, AGENTS:READ or ANALYTICS:READ)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/logs/trace/execution/{executionId}":{"get":{"operationId":"logs_traceAnExecution","summary":"Trace an execution","description":"Returns a structured trace tree for a single execution.","tags":["logs"],"parameters":[{"name":"executionId","in":"path","description":"Runtime execution_id / executionSessionId to trace (for example exec_... or otel-...), not the aex_... agent-execution row ID","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Trace tree returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Logs_traceAnExecution_Response_200"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"API key lacks a read scope (FLOWS:READ, AGENTS:READ or ANALYTICS:READ)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/logs/trace/execution/{executionId}/children":{"get":{"operationId":"logs_listChildExecutionsOfARun","summary":"List child executions of a run","description":"Lists the subagent runs whose `parentExecutionId` is this execution, each keyed back to the tool call that spawned it. Fetch a child tree by passing its `executionId` to the trace route.","tags":["logs"],"parameters":[{"name":"executionId","in":"path","description":"Runtime execution_id / executionSessionId of the parent run","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Child executions returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Logs_listChildExecutionsOfARun_Response_200"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"API key lacks a read scope (FLOWS:READ, AGENTS:READ or ANALYTICS:READ)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/logs/trace/execution/{executionId}/explain":{"post":{"operationId":"logs_explainARunUsingRetainedTraceEvidence","summary":"Explain a run using retained trace evidence","description":"Runs a bounded, tool-free analysis in the caller account. Model usage is metered. Requires ANALYTICS:READ and FLOWS:EXECUTE for API keys. Does not assess business quality or modify the source run.","tags":["logs"],"parameters":[{"name":"executionId","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":256}}],"responses":{"200":{"description":"Evidence-linked run explanation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Logs_explainARunUsingRetainedTraceEvidence_Response_200"}}}},"400":{"description":"Invalid execution ID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Execution spend limit reached","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Required permission or account verification missing","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No retained trace evidence","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"408":{"description":"Request cancelled","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Execution rate limit reached","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Analysis failed or invalid evidence citations","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Trace service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/logs/trace/execution/{executionId}/slice":{"get":{"operationId":"logs_readATraceSlice","summary":"Read a trace slice","description":"A bounded window of one trace: by span index range, span kind, tool name, or around the first failed span. Content stays previews-only unless includeContent is set, which loads it for the selected spans under a byte budget and lists every cut.","tags":["logs"],"parameters":[{"name":"executionId","in":"path","required":true,"schema":{"type":"string"}},{"name":"start","in":"query","description":"First span index (trace start order) to include.","required":false,"schema":{"type":"string"}},{"name":"end","in":"query","description":"Span index to stop before.","required":false,"schema":{"type":"string"}},{"name":"kind","in":"query","required":false,"schema":{"$ref":"#/components/schemas/V1LogsTraceExecutionExecutionIdSliceGetParametersKind"}},{"name":"toolName","in":"query","required":false,"schema":{"type":"string"}},{"name":"aroundFirstFailure","in":"query","description":"Return the first failed span plus this many spans either side (0-50). Not combinable with start/end.","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","description":"Spans to return, 1-100 (default 25).","required":false,"schema":{"type":"string"}},{"name":"includeContent","in":"query","description":"Load full content for the selected spans only, under maxContentBytes.","required":false,"schema":{"$ref":"#/components/schemas/V1LogsTraceExecutionExecutionIdSliceGetParametersIncludeContent"}},{"name":"maxContentBytes","in":"query","description":"Content byte budget, 1-262144 (default 65536).","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Trace slice","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Logs_readATraceSlice_Response_200"}}}},"400":{"description":"Unreadable filter, window over the cap, or too many runs to probe; `code` says which","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"API key lacks a read scope (FLOWS:READ, AGENTS:READ or ANALYTICS:READ)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No trace for this execution","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Log store temporarily unavailable; no entries or counts could be read","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/logs/trace/query":{"post":{"operationId":"logs_queryTraces","summary":"Query traces","description":"Filter runs and group them by one or two dimensions into aggregates (count, failure rate, tokens, cost, duration, tool calls, signal fire rate), each with sample execution ids to drill into. Reads trace headers on indexed columns; model and tool-call metrics probe spans and cap the window at 7 days.","tags":["logs"],"responses":{"200":{"description":"Aggregates","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Logs_queryTraces_Response_200"}}}},"400":{"description":"Unreadable filter, window over the cap, or too many runs to probe; `code` says which","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"API key lacks a read scope (FLOWS:READ, AGENTS:READ or ANALYTICS:READ)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Log store temporarily unavailable; no entries or counts could be read","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TraceQueryRequest"}}}},"security":[{"BearerAuth":[]}]}},"/v1/messaging/conversations":{"get":{"operationId":"messagingConversations_listConversations","summary":"List conversations","description":"Get all messaging conversations for the authenticated user with filtering and pagination.","tags":["messagingConversations"],"parameters":[{"name":"limit","in":"query","description":"Max results per page (default 50, max 100)","required":false,"schema":{"type":"string"}},{"name":"cursor","in":"query","description":"Pagination cursor","required":false,"schema":{"type":"string"}},{"name":"includeCount","in":"query","description":"Set to `true` to include `totalCount`/`totalPages`. Omitted by default so a poll does not pay for a COUNT over the surface.","required":false,"schema":{"type":"string"}},{"name":"surfaceId","in":"query","description":"Filter by surface ID","required":false,"schema":{"type":"string"}},{"name":"status","in":"query","description":"Filter by status (open, closed, archived, all)","required":false,"schema":{"type":"string"}},{"name":"agentMode","in":"query","description":"Filter by agent mode (auto, human, all)","required":false,"schema":{"type":"string"}},{"name":"search","in":"query","description":"Search by subject, participant name, or email","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Paginated list of conversations","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Messaging_Conversations_listConversations_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Surface not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]},"post":{"operationId":"messagingConversations_createConversation","summary":"Create conversation","description":"Create a new messaging conversation linked to a surface.","tags":["messagingConversations"],"responses":{"201":{"description":"Created conversation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Messaging_Conversations_createConversation_Response_201"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Surface not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"context":{"$ref":"#/components/schemas/V1MessagingConversationsPostRequestBodyContentApplicationJsonSchemaContext"},"externalParticipantId":{"type":"string","maxLength":500},"externalThreadId":{"type":"string","maxLength":500},"participantEmail":{"type":"string","format":"email","maxLength":255},"participantMetadata":{"type":"object","additionalProperties":{"description":"Any type"}},"participantName":{"type":"string","maxLength":255},"status":{"$ref":"#/components/schemas/V1MessagingConversationsPostRequestBodyContentApplicationJsonSchemaStatus"},"subject":{"type":"string","maxLength":500},"surfaceId":{"type":"string"},"timezone":{"type":["string","null"],"maxLength":64}},"required":["surfaceId"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/messaging/conversations/{id}":{"get":{"operationId":"messagingConversations_getConversation","summary":"Get conversation","description":"Get a messaging conversation by ID with full details.","tags":["messagingConversations"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Conversation details","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Messaging_Conversations_getConversation_Response_200"}}}},"400":{"description":"Invalid conversation ID format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Conversation not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]},"put":{"operationId":"messagingConversations_updateConversation","summary":"Update conversation","description":"Update a messaging conversation by ID.","tags":["messagingConversations"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Updated conversation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Messaging_Conversations_updateConversation_Response_200"}}}},"400":{"description":"Invalid conversation ID format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Conversation not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Another open conversation already exists for this thread","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"context":{"$ref":"#/components/schemas/V1MessagingConversationsIdPutRequestBodyContentApplicationJsonSchemaContext"},"participantEmail":{"type":"string","format":"email","maxLength":255},"participantMetadata":{"type":"object","additionalProperties":{"description":"Any type"}},"participantName":{"type":"string","maxLength":255},"status":{"$ref":"#/components/schemas/V1MessagingConversationsIdPutRequestBodyContentApplicationJsonSchemaStatus"},"subject":{"type":"string","maxLength":500},"timezone":{"type":["string","null"],"maxLength":64}}}}}},"security":[{"BearerAuth":[]}]},"delete":{"operationId":"messagingConversations_deleteConversation","summary":"Delete conversation","description":"Delete a messaging conversation by ID.","tags":["messagingConversations"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Conversation deleted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Messaging_Conversations_deleteConversation_Response_200"}}}},"400":{"description":"Invalid conversation ID format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Conversation not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/messaging/conversations/{id}/messages":{"get":{"operationId":"messagingConversations_listMessages","summary":"List messages","description":"Get messages for a conversation.","tags":["messagingConversations"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","description":"Max results (default 100, max 100)","required":false,"schema":{"type":"string"}},{"name":"offset","in":"query","description":"Messages to skip before the page (default 0)","required":false,"schema":{"type":"string"}},{"name":"order","in":"query","description":"Sort order: asc or desc (default asc)","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"List of messages","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Messaging_Conversations_listMessages_Response_200"}}}},"400":{"description":"Invalid conversation ID format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Conversation not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]},"post":{"operationId":"messagingConversations_createMessage","summary":"Create message","description":"Add a message to a conversation.","tags":["messagingConversations"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Created message","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Messaging_Conversations_createMessage_Response_201"}}}},"400":{"description":"Invalid conversation ID format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Conversation not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"content":{"type":"string","minLength":1},"direction":{"$ref":"#/components/schemas/V1MessagingConversationsIdMessagesPostRequestBodyContentApplicationJsonSchemaDirection"},"externalMessageId":{"type":"string","maxLength":500},"flowStepResultId":{"type":"string"},"metadata":{"$ref":"#/components/schemas/V1MessagingConversationsIdMessagesPostRequestBodyContentApplicationJsonSchemaMetadata"},"role":{"$ref":"#/components/schemas/V1MessagingConversationsIdMessagesPostRequestBodyContentApplicationJsonSchemaRole"}},"required":["content","role"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/messaging/conversations/{id}/resume":{"post":{"operationId":"messagingConversations_resumeAgentHandling","summary":"Resume agent handling","description":"Switch a messaging conversation from human-operator mode back to automatic agent handling. Any operator with write access to the organization may resume, including a conversation another operator took over (supervisor override); the takeover actor is audit attribution, not a lock. Returns 409 if the conversation is already in auto mode.","tags":["messagingConversations"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Conversation resumed to auto mode","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Messaging_Conversations_resumeAgentHandling_Response_200"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Conversation not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conversation is already in auto (agent) mode (ALREADY_AUTO_MODE), or its state changed concurrently and the resume did not apply (STATE_CHANGED, retryable).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessagingConversationConflictError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/messaging/conversations/{id}/send":{"post":{"operationId":"messagingConversations_sendHumanAuthoredMessage","summary":"Send human-authored message","description":"Send a human-authored outbound message through the conversation's messaging channel.","tags":["messagingConversations"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Message sent to channel","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Messaging_Conversations_sendHumanAuthoredMessage_Response_201"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Conversation not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conversation mode changed concurrently: another operator resumed the conversation to automatic agent handling after this request's requireHumanMode precondition was checked but before the send committed (STATE_CHANGED). Nothing is persisted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessagingConversationConflictError"}}}},"422":{"description":"Conversation or surface cannot be addressed before anything is sent: no external thread/participant to reply to, or the surface type has no registered outbound channel adapter (UNSUPPORTED_SURFACE_TYPE). Nothing is persisted in either case.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessagingSendUndeliverableError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Channel delivery failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"content":{"type":"string","minLength":1,"maxLength":50000},"metadata":{"$ref":"#/components/schemas/V1MessagingConversationsIdSendPostRequestBodyContentApplicationJsonSchemaMetadata"},"requireHumanMode":{"type":"boolean","default":true}},"required":["content"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/messaging/conversations/{id}/takeover":{"post":{"operationId":"messagingConversations_takeOverConversation","summary":"Take over conversation","description":"Switch a messaging conversation into human-operator mode so inbound messages are persisted but agent replies are suppressed. The claim is atomic: when two operators take over at once, exactly one succeeds and the other receives 409 carrying the winner's takeoverActorId. A takeover lapses and the agent resumes after the surface's interventionMode.takeoverIdleTimeoutMinutes (default 24h) with no operator send; closing or reopening the conversation also clears it.","tags":["messagingConversations"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Conversation switched to human mode","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Messaging_Conversations_takeOverConversation_Response_200"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Conversation not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conversation is already in human mode (ALREADY_HUMAN_MODE), or its state changed concurrently and the takeover did not apply (STATE_CHANGED, retryable).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessagingConversationConflictError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"reason":{"type":"string","maxLength":1000}}}}}},"security":[{"BearerAuth":[]}]}},"/v1/messaging/imap/{surfaceId}/poll-now":{"post":{"operationId":"emailImap_triggerAnImmediateImapPoll","summary":"Trigger an immediate IMAP poll","description":"Forces the polling Durable Object to poll immediately. Requires polling to be active.","tags":["emailImap"],"parameters":[{"name":"surfaceId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Poll triggered","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Email___IMAP_triggerAnImmediateImapPoll_Response_200"}}}},"400":{"description":"Invalid surface ID format or polling not active","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TriggerAnImmediateImapPollRequestForbiddenError"}}}},"404":{"description":"Surface not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/messaging/imap/{surfaceId}/start":{"post":{"operationId":"emailImap_startImapPolling","summary":"Start IMAP polling","description":"Persists IMAP/SMTP configuration on the surface and starts the polling Durable Object.","tags":["emailImap"],"parameters":[{"name":"surfaceId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling started","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Email___IMAP_startImapPolling_Response_200"}}}},"400":{"description":"Invalid surface ID format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StartImapPollingRequestForbiddenError"}}}},"404":{"description":"Surface not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"fromAddress":{"type":"string","format":"email"},"fromName":{"type":"string"},"imapHost":{"type":"string","minLength":1},"imapPassword":{"type":"string","minLength":1},"imapPort":{"type":"integer","minimum":1,"maximum":65535},"imapSecure":{"type":"boolean"},"imapUsername":{"type":"string","minLength":1},"mailbox":{"type":"string"},"pollIntervalMinutes":{"type":"integer","minimum":1,"maximum":60},"smtpHost":{"type":"string","minLength":1},"smtpPassword":{"type":"string","minLength":1},"smtpPort":{"type":"integer","minimum":1,"maximum":65535},"smtpSecure":{"type":"boolean"},"smtpUsername":{"type":"string","minLength":1}},"required":["fromAddress","imapHost","imapPassword","imapPort","imapUsername","smtpHost","smtpPassword","smtpPort","smtpUsername"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/messaging/imap/{surfaceId}/status":{"get":{"operationId":"emailImap_getImapPollingStatus","summary":"Get IMAP polling status","description":"Returns the current polling status and masked inbound configuration for an email surface.","tags":["emailImap"],"parameters":[{"name":"surfaceId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling status","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Email___IMAP_getImapPollingStatus_Response_200"}}}},"400":{"description":"Invalid surface ID format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetImapPollingStatusRequestForbiddenError"}}}},"404":{"description":"Surface not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/messaging/imap/{surfaceId}/stop":{"post":{"operationId":"emailImap_stopImapPolling","summary":"Stop IMAP polling","description":"Disables polling on the surface and stops the polling Durable Object.","tags":["emailImap"],"parameters":[{"name":"surfaceId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Polling stopped","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Email___IMAP_stopImapPolling_Response_200"}}}},"400":{"description":"Invalid surface ID format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StopImapPollingRequestForbiddenError"}}}},"404":{"description":"Surface not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/messaging/imap/{surfaceId}/test-send":{"post":{"operationId":"emailImap_sendATestEmailViaSmtp","summary":"Send a test email via SMTP","description":"Sends a test email through the supplied SMTP configuration to confirm delivery works.","tags":["emailImap"],"parameters":[{"name":"surfaceId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Test email sent","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Email___IMAP_sendATestEmailViaSmtp_Response_200"}}}},"400":{"description":"Invalid surface ID format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SendATestEmailViaSmtpRequestForbiddenError"}}}},"404":{"description":"Surface not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"The SMTP server rejected the test email (`success: false`), or an internal error occurred","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SendATestEmailViaSmtpRequestInternalServerError"}}}},"503":{"description":"Database temporarily unavailable; nothing was read or written. Retry after the `Retry-After` interval (seconds).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatabaseUnavailableError"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"fromAddress":{"type":"string","format":"email"},"fromName":{"type":"string"},"smtpHost":{"type":"string","minLength":1},"smtpPassword":{"type":"string","minLength":1},"smtpPort":{"type":"integer","minimum":1,"maximum":65535,"default":587},"smtpSecure":{"type":"boolean"},"smtpUsername":{"type":"string","minLength":1},"to":{"type":"string","format":"email"}},"required":["fromAddress","smtpHost","smtpPassword","smtpUsername","to"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/messaging/imap/{surfaceId}/verify":{"post":{"operationId":"emailImap_verifyImapSmtpConnection","summary":"Verify IMAP + SMTP connection","description":"Tests IMAP and SMTP connectivity for an email surface using the supplied credentials.","tags":["emailImap"],"parameters":[{"name":"surfaceId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Verification results for IMAP and SMTP","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Email___IMAP_verifyImapSmtpConnection_Response_200"}}}},"400":{"description":"Invalid surface ID format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyImapSmtpConnectionRequestForbiddenError"}}}},"404":{"description":"Surface not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"imapHost":{"type":"string","minLength":1},"imapPassword":{"type":"string","minLength":1},"imapPort":{"type":"integer","minimum":1,"maximum":65535},"imapSecure":{"type":"boolean"},"imapUsername":{"type":"string","minLength":1},"mailbox":{"type":"string"},"pollIntervalMinutes":{"type":"integer","minimum":1,"maximum":60},"smtpHost":{"type":"string","minLength":1},"smtpPassword":{"type":"string","minLength":1},"smtpPort":{"type":"integer","minimum":1,"maximum":65535},"smtpSecure":{"type":"boolean"},"smtpUsername":{"type":"string","minLength":1}},"required":["imapHost","imapPassword","imapPort","imapUsername","smtpHost","smtpPassword","smtpPort","smtpUsername"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/messaging/validations/slack/test-token":{"post":{"operationId":"messagingValidations_validateSlackBotTokenDeprecated","summary":"Validate Slack bot token (deprecated)","description":"Back-compat shim. Use POST /{channelType}/credentials instead.","tags":["messagingValidations"],"responses":{"200":{"description":"Validation result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Messaging_Validations_validateSlackBotTokenDeprecated_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"botToken":{"type":"string","minLength":1}},"required":["botToken"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/messaging/validations/telegram/bot-token":{"post":{"operationId":"messagingValidations_validateTelegramBotTokenDeprecated","summary":"Validate Telegram bot token (deprecated)","description":"Back-compat shim. Use POST /{channelType}/credentials instead.","tags":["messagingValidations"],"responses":{"200":{"description":"Validation result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Messaging_Validations_validateTelegramBotTokenDeprecated_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"botToken":{"type":"string","minLength":1}},"required":["botToken"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/messaging/validations/{channelType}/credentials":{"post":{"operationId":"messagingValidations_validateChannelCredentials","summary":"Validate channel credentials","description":"Validate credentials for a messaging channel type. Returns 404 when no validator is registered for the channel.","tags":["messagingValidations"],"parameters":[{"name":"channelType","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Validation result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Messaging_Validations_validateChannelCredentials_Response_200"}}}},"400":{"description":"Invalid request body","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidateChannelCredentialsRequestBadRequestError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No validator for channel type","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidateChannelCredentialsRequestNotFoundError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"security":[{"BearerAuth":[]}]}},"/v1/messaging/validations/{channelType}/echo":{"post":{"operationId":"messagingValidations_sendEchoMessage","summary":"Send echo message","description":"Send a test \"Hello from Runtype\" message via the configured channel adapter.","tags":["messagingValidations"],"parameters":[{"name":"channelType","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Echo result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Messaging_Validations_sendEchoMessage_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"501":{"description":"Echo not implemented for channel","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SendEchoMessageRequestNotImplementedError"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"credentials":{"type":"object","additionalProperties":{"description":"Any type"}},"recipient":{"type":"string","minLength":1}},"required":["recipient"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/model-configs":{"get":{"operationId":"modelConfigs_listModelConfigurations","summary":"List model configurations","description":"Get every model the account can run, with enriched catalog metadata: its model configurations plus the models its organization custom inference endpoints declare (`configScope: organization_connection`). `credentialPolicy` states which providers may serve a call. Auto-provisions a default if none exist.","tags":["modelConfigs"],"responses":{"200":{"description":"List of model configurations","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Model_Configs_listModelConfigurations_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]},"post":{"operationId":"modelConfigs_createModelConfiguration","summary":"Create model configuration","description":"Create a new model configuration for the authenticated user.","tags":["modelConfigs"],"responses":{"201":{"description":"Created model configuration","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Model_Configs_createModelConfiguration_Response_201"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Plan does not allow this provider","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Organization model configuration migration conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateModelConfigurationRequestConflictError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"modelId":{"type":"string","minLength":1},"provider":{"$ref":"#/components/schemas/V1ModelConfigsPostRequestBodyContentApplicationJsonSchemaProvider"},"providerKeyId":{"type":"string","description":"Credential selector: `platform`, a provider-key ID, or an organization-connection ID. For migrated model providers this stores the model reference without changing organization-wide credential policy."},"settings":{"$ref":"#/components/schemas/V1ModelConfigsPostRequestBodyContentApplicationJsonSchemaSettings","default":{}}},"required":["modelId","provider"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/model-configs/available":{"get":{"operationId":"modelConfigs_listAvailableModels","summary":"List available models","description":"Deprecated flat model catalog endpoint. Use /grouped for grouped provider options.","tags":["modelConfigs"],"parameters":[{"name":"showAll","in":"query","required":false,"schema":{"type":"string"}},{"name":"category","in":"query","required":false,"schema":{"type":"string"}},{"name":"q","in":"query","description":"Free-text search over model name, id, creator, provider and tags. Every word must match (prefixes count); results are ordered by relevance.","required":false,"schema":{"type":"string","maxLength":200}}],"responses":{"200":{"description":"Available model catalog with user configuration status","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Model_Configs_listAvailableModels_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"deprecated":true,"security":[{"BearerAuth":[]}]}},"/v1/model-configs/grouped":{"get":{"operationId":"modelConfigs_getGroupedModels","summary":"Get grouped models","description":"Get models grouped by base model with all provider options. Supports filtering to configured-only models and free-text search (`q`). The account custom models (`isCustom: true`) always follow the catalog groups; `category=custom` returns only them. `credentialPolicy` states which providers may serve a call.","tags":["modelConfigs"],"parameters":[{"name":"showAll","in":"query","required":false,"schema":{"type":"string"}},{"name":"category","in":"query","required":false,"schema":{"type":"string"}},{"name":"configured","in":"query","required":false,"schema":{"type":"string"}},{"name":"q","in":"query","description":"Free-text search over model name, id, creator, provider and tags. Every word must match (prefixes count); results are ordered by relevance.","required":false,"schema":{"type":"string","maxLength":200}}],"responses":{"200":{"description":"Grouped model catalog","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Model_Configs_getGroupedModels_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/model-configs/search-capable":{"get":{"operationId":"modelConfigs_listSearchCapableModels","summary":"List search-capable models","description":"Get catalog models that support AI model search for flow search steps.","tags":["modelConfigs"],"responses":{"200":{"description":"Search-capable model catalog","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Model_Configs_listSearchCapableModels_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/model-configs/search-configured":{"get":{"operationId":"modelConfigs_listConfiguredSearchProviders","summary":"List configured search providers","description":"Get enabled user model configurations that support search, plus configured Exa search when available.","tags":["modelConfigs"],"responses":{"200":{"description":"Configured search providers","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Model_Configs_listConfiguredSearchProviders_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/model-configs/usage":{"get":{"operationId":"modelConfigs_getModelConfigurationUsage","summary":"Get model configuration usage","description":"Get usage counters and last-used timestamps for the authenticated user's model configurations.","tags":["modelConfigs"],"responses":{"200":{"description":"Model configuration usage statistics","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Model_Configs_getModelConfigurationUsage_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/model-configs/{id}":{"put":{"operationId":"modelConfigs_updateModelConfiguration","summary":"Update model configuration","description":"Update fields on an existing model configuration.","tags":["modelConfigs"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Updated model configuration","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Model_Configs_updateModelConfiguration_Response_200"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Model configuration not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Organization model configuration migration conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateModelConfigurationRequestConflictError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"isDefault":{"type":"boolean"},"isEnabled":{"type":"boolean"},"providerKeyId":{"type":"string","description":"Credential selector: `platform`, a provider-key ID, or an organization-connection ID. For migrated model providers this stores the model reference without changing organization-wide credential policy."},"settings":{"$ref":"#/components/schemas/V1ModelConfigsIdPutRequestBodyContentApplicationJsonSchemaSettings"}}}}}},"security":[{"BearerAuth":[]}]},"delete":{"operationId":"modelConfigs_deleteModelConfiguration","summary":"Delete model configuration","description":"Delete a model configuration by ID.","tags":["modelConfigs"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Model configuration deleted","content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"400":{"description":"Invalid config ID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Model configuration not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Organization model configuration migration conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteModelConfigurationRequestConflictError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/model-configs/{id}/default":{"patch":{"operationId":"modelConfigs_setDefaultModelConfiguration","summary":"Set default model configuration","description":"Mark a model configuration as the default for the authenticated user.","tags":["modelConfigs"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Default model set","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Model_Configs_setDefaultModelConfiguration_Response_200"}}}},"400":{"description":"Invalid config ID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Model configuration not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Organization model configuration migration conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SetDefaultModelConfigurationRequestConflictError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/model-configs/{id}/status":{"patch":{"operationId":"modelConfigs_enableOrDisableModelConfiguration","summary":"Enable or disable model configuration","description":"Toggle the enabled flag on a model configuration.","tags":["modelConfigs"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Status updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Model_Configs_enableOrDisableModelConfiguration_Response_200"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Model configuration not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Organization model configuration migration conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EnableOrDisableModelConfigurationRequestConflictError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"isEnabled":{"type":"boolean"}},"required":["isEnabled"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/model-usage":{"get":{"operationId":"modelUsage_getModelUsageStatistics","summary":"Get model usage statistics","description":"Get aggregated model usage statistics with optional date range and time series.","tags":["modelUsage"],"parameters":[{"name":"startDate","in":"query","description":"Start date (YYYY-MM-DD)","required":false,"schema":{"type":"string"}},{"name":"endDate","in":"query","description":"End date (YYYY-MM-DD)","required":false,"schema":{"type":"string"}},{"name":"period","in":"query","description":"Convenience preset (today, yesterday, last_7_days, last_30_days, current_month, last_month, current_year)","required":false,"schema":{"type":"string"}},{"name":"granularity","in":"query","description":"Time series granularity (hour, day, week, month)","required":false,"schema":{"type":"string"}},{"name":"modelConfigId","in":"query","description":"Filter by model config ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Model usage statistics","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Model_Usage_getModelUsageStatistics_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalError"}}}},"503":{"description":"Analytics Engine not configured","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/model-usage/{modelConfigId}":{"get":{"operationId":"modelUsage_getModelUsageDetails","summary":"Get model usage details","description":"Get detailed usage statistics for a specific model configuration.","tags":["modelUsage"],"parameters":[{"name":"modelConfigId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Model usage details","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Model_Usage_getModelUsageDetails_Response_200"}}}},"400":{"description":"Invalid model config ID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Model config not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalError"}}}},"503":{"description":"Analytics Engine not configured","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/products":{"get":{"operationId":"products_listProducts","summary":"List products","description":"List all products for the authenticated user with search and cursor pagination.","tags":["products"],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"string"}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"}},{"name":"search","in":"query","required":false,"schema":{"type":"string"}},{"name":"sort","in":"query","required":false,"schema":{"$ref":"#/components/schemas/V1ProductsGetParametersSort"}},{"name":"view","in":"query","description":"Response representation. `full` (default) preserves complete values; `compact` shortens every string value longer than 100 characters to a 100-character preview followed by `…`.","required":false,"schema":{"$ref":"#/components/schemas/V1ProductsGetParametersView"}}],"responses":{"200":{"description":"Paginated list of products","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Products_listProducts_Response_200"}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]},"post":{"operationId":"products_createProduct","summary":"Create product","description":"Create a new product with optional canvas and spec configuration.","tags":["products"],"responses":{"201":{"description":"Product created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Products_createProduct_Response_201"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"canvas":{"$ref":"#/components/schemas/V1ProductsPostRequestBodyContentApplicationJsonSchemaCanvas"},"description":{"type":"string"},"icon":{"type":"string","maxLength":50},"name":{"type":"string","minLength":1},"spec":{"$ref":"#/components/schemas/V1ProductsPostRequestBodyContentApplicationJsonSchemaSpec"}},"required":["name"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/products/assemble":{"post":{"operationId":"products_assembleProductFromFpo","summary":"Assemble product from FPO","description":"Assemble a product from a validated Full Product Object (FPO). API keys must carry PRODUCTS:WRITE (or PRODUCTS:CREATE) and SECRETS:WRITE, plus the write scope for every entity kind the FPO materializes (FLOWS:WRITE, AGENTS:WRITE, PRODUCTS:SURFACES:WRITE, SCHEDULES:WRITE, RECORDS:WRITE, EVALS:WRITE, SKILLS:WRITE), and SECRETS:READ when an inline HTTP step references a managed secret.","tags":["products"],"responses":{"201":{"description":"Assembled product result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Products_assembleProductFromFpo_Response_201"}}}},"400":{"description":"Validation or invalid input error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssembleProductFromFpoRequestBadRequestError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions for the entities this FPO materializes, or a `cli` surface while CLI surfaces are not enabled for the account (`CLI_SURFACE_DISABLED`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssembleProductFromFpoRequestForbiddenError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssembleProductFromFpoRequestInternalServerError"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":{"description":"Any type"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/products/ensure":{"post":{"operationId":"products_ensureProductConfigAsCodeConverge","summary":"Ensure product (config-as-code converge)","description":"Idempotently converge a repo-defined product definition onto the platform. Identity is name + account scope. Hash-only probes skip the payload in the steady state (a miss is a normal 200 `definitionRequired` response, not an error); full requests create the product or update it when the canonical content hash differs. The converge covers the top-level product record only (description, icon, spec) — not nested capabilities/surfaces/tools or canvas layout. The response always carries the server-computed canonical hash. Set dryRun to plan without writing (CI drift gate), and onConflict: \"overwrite\" to converge over dashboard/API edits. Products have no version snapshots, so there is no publish option.","tags":["products"],"responses":{"200":{"description":"Converge result: unchanged | created | updated | definitionRequired (hash miss — retry with the full definition) | plan (dryRun)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductEnsureResponse"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflict: external_modification (last write was not ensure; pass onConflict: \"overwrite\") or remote_changed (expectedRemoteHash guard)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductEnsureConflict"}}}},"422":{"description":"Submitted contentHash does not match the server-recomputed canonical hash","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductEnsureHashMismatch"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"contentHash":{"type":"string","pattern":"^[0-9a-f]{64}$"},"definition":{"$ref":"#/components/schemas/V1ProductsEnsurePostRequestBodyContentApplicationJsonSchemaDefinition"},"dryRun":{"type":"boolean"},"expectedRemoteHash":{"type":"string","pattern":"^[0-9a-f]{64}$"},"name":{"type":"string","minLength":1},"onConflict":{"$ref":"#/components/schemas/V1ProductsEnsurePostRequestBodyContentApplicationJsonSchemaOnConflict"}},"required":["name"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/products/ensure-fpo":{"post":{"operationId":"products_ensureFullProductConfigAsCodeConvergeOfTheWholeFpo","summary":"Ensure full product (config-as-code converge of the whole FPO)","description":"Idempotently converge an entire Full Product Object (the nested product graph) in one shot. Fans out to the per-entity ensure services in dependency order (product → capability backing flows/agents → capability-as-tool composition → capability links → surfaces + surface items → records → schedules → secret bindings), returning a per-entity report. Identity is the product name + account scope. NON-atomic by design: a per-entity failure is reported in `entities[].result = \"failed\"` (and `hasFailures`) and a re-run self-heals; only a top-level product reject aborts. Converged capability agents and flows are published to `live` by default; set release to \"none\" to save changes as drafts. Set dryRun to plan without writing. Set prune to remove product-scoped capabilities/surfaces (and their items) absent from the FPO (account-scoped flows/agents/tools/records are never removed). A hash-only probe (`name` + `contentHash`, no fpo) with release \"none\" answers `unchanged` when the live graph reconstructs (as GET /products/pull-fpo does) to that hash, else `definitionRequired` (retry with the full fpo); a probe that publishes (the default release) always answers `definitionRequired`, because only a full converge can publish drafts that are not yet live. The probe, the dryRun `remoteHash` and expectedRemoteHash read the live graph, so API keys need PRODUCTS:READ for them. A dryRun reports the live graph's `remoteHash`; pass it as expectedRemoteHash on the apply to refuse the write (409 remote_changed) if the product changed in between. The guard compares what GET /products/pull-fpo reconstructs, so edits to seed records, schedules or secrets (which pull-fpo omits) do not trip it. When pull-fpo has to omit part of the product (a capability, surface, schedule, eval suite or skill it cannot represent), a probe answers `definitionRequired`, a dryRun reports no `remoteHash`, and expectedRemoteHash is refused with 409. The guard is re-checked immediately before the first write but does not lock the graph, so an edit that lands while the apply is running can still be overwritten. API keys need PRODUCTS:CREATE to create the product and PRODUCTS:UPDATE to change an existing one (PRODUCTS:WRITE covers both). API keys converge each nested flow, agent, tool, surface, schedule, record, eval suite and skill only with that entity kind's own write scope (FLOWS:WRITE, AGENTS:WRITE or AGENTS:CREATE/UPDATE, TOOLS:WRITE, PRODUCTS:SURFACES:WRITE, SCHEDULES:WRITE, RECORDS:WRITE, EVALS:WRITE, SKILLS:WRITE) on top of the product scope; otherwise that entity reports `failed`. Adding or changing a capability on an existing product needs PRODUCTS:CAPABILITIES:WRITE, and adding a route to an existing surface needs PRODUCTS:SURFACES:WRITE. Prune needs PRODUCTS:CAPABILITIES:WRITE to remove capabilities and PRODUCTS:SURFACES:WRITE to remove surfaces or their items, and a pruned surface's client tokens are revoked. Binding a skill to an agent also needs agent update scope. Schedules also honor the plan's active-schedule limit and minimum frequency.","tags":["products"],"responses":{"200":{"description":"Converge result: unchanged | converged | plan (dryRun), with a per-entity report; or definitionRequired (hash-only probe miss — retry with the full fpo).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductFpoEnsureResponse"}}}},"400":{"description":"FPO validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflict: external_modification converging the top-level product, or remote_changed (expectedRemoteHash guard).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductEnsureConflict"}}}},"422":{"description":"Submitted contentHash does not match the server-recomputed canonical hash","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductEnsureHashMismatch"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"contentHash":{"type":"string","pattern":"^[0-9a-f]{64}$","description":"Hash-only probe: the canonical FPO hash the caller holds. Answers `unchanged` when the live graph reconstructs (as pull-fpo does) to this hash, else `definitionRequired`. Only valid without `fpo`."},"dryRun":{"type":"boolean","description":"Plan without writing — returns a per-entity plan (CI drift gate)."},"expectedRemoteHash":{"type":"string","pattern":"^[0-9a-f]{64}$","description":"TOCTOU guard binding a dry run to its apply: the write proceeds only while the live graph still hashes to this value (the dry run's `remoteHash`); otherwise 409 remote_changed."},"fpo":{"type":"object","additionalProperties":{"description":"Any type"},"description":"A complete Full Product Object (FPO): the nested product graph (product, capabilities, tools, surfaces, ...). Validated server-side via the shared FPO validator. Omit it only for a hash-only probe (`name` + `contentHash`)."},"name":{"type":"string","minLength":1,"description":"The product name a hash-only probe resolves. Only valid without `fpo`."},"onConflict":{"$ref":"#/components/schemas/V1ProductsEnsureFpoPostRequestBodyContentApplicationJsonSchemaOnConflict","description":"Per nested entity: \"overwrite\" converges over dashboard/API edits."},"prune":{"type":"boolean","description":"Opt-in removal of product-scoped capabilities/surfaces (and their items) absent from the FPO, after the converge passes. NEVER touches account-scoped flows/agents/tools/records. Honors createPolicy:\"skip\". With dryRun, reports would-be removals as `pruned` plan rows."},"release":{"$ref":"#/components/schemas/V1ProductsEnsureFpoPostRequestBodyContentApplicationJsonSchemaRelease","description":"Whether converged capability agents and flows go live. Defaults to \"publish\": an agent or flow whose converged content is not yet live is versioned and published (the agent's `live` alias moves to that version), matching product creation. \"none\" saves changes as drafts and leaves `live` where it was. Publishing needs update authority over that entity kind, and for an agent the live deploy scope (AGENTS:DEPLOY:LIVE; AGENTS:WRITE or AGENTS:UPDATE also accepted); an API key without it converges that kind as \"none\"."}}}}}},"security":[{"BearerAuth":[]}]}},"/v1/products/pull":{"get":{"operationId":"products_pullProductDefinitionConfigAsCode","summary":"Pull product definition (config-as-code)","description":"Return the canonical config-as-code definition and provenance for a product by name — the absorb-drift direction of the ensure protocol. The contentHash is recomputed from the live product state, so it is accurate even immediately after a dashboard edit. Returns the top-level product record only (description, icon, spec); nested capabilities/surfaces and canvas layout are not included.","tags":["products"],"parameters":[{"name":"name","in":"query","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Canonical definition + provenance","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductPullResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No product with that name in the account scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/products/pull-fpo":{"get":{"operationId":"products_pullFullProductReconstructTheWholeFpoFromTheLiveGraph","summary":"Pull full product (reconstruct the whole FPO from the live graph)","description":"Reconstruct a self-contained Full Product Object from the live product graph — the absorb-drift direction of ensure-fpo. Composes the per-entity pulls (product, backing flows/agents, surfaces) and mints deterministic FPO-local ids, so feeding the result back into POST /products/ensure-fpo converges to `unchanged`. records/schedules/secrets are NOT reconstructed and `tools` is emitted empty (tool refs are portable `tool:<name>`); see `warnings` for per-pull caveats. The contentHash is recomputed from the live graph, so it is accurate immediately after a dashboard edit. API keys need PRODUCTS:READ, plus FLOWS:READ, AGENTS:READ, SCHEDULES:READ, EVALS:READ or SKILLS:READ for each section the product carries.","tags":["products"],"parameters":[{"name":"name","in":"query","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Reconstructed FPO + canonical content hash","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductFpoPullResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No product with that name in the account scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/products/{id}":{"get":{"operationId":"products_getProductDetails","summary":"Get product details","description":"Get a product by ID including its capabilities and surfaces.","tags":["products"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"includeEditorContext","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Product details","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Products_getProductDetails_Response_200"}}}},"400":{"description":"Invalid product ID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Product not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]},"put":{"operationId":"products_updateProduct","summary":"Update product","description":"Update an existing product. Supports partial updates with deep-merging for canvas and spec.","tags":["products"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Product updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Products_updateProduct_Response_200"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Product not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"canvas":{"$ref":"#/components/schemas/V1ProductsIdPutRequestBodyContentApplicationJsonSchemaCanvas"},"description":{"type":"string"},"icon":{"type":"string","maxLength":50},"name":{"type":"string","minLength":1},"spec":{"$ref":"#/components/schemas/V1ProductsIdPutRequestBodyContentApplicationJsonSchemaSpec"}}}}}},"security":[{"BearerAuth":[]}]},"delete":{"operationId":"products_deleteProduct","summary":"Delete product","description":"Delete a product (cascades to capabilities, surfaces, items, keys). Optionally cleans up associated flows/agents via cleanupFlowIds/cleanupAgentIds in the request body.","tags":["products"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Product deleted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Products_deleteProduct_Response_200"}}}},"400":{"description":"Invalid product ID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Product not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/products/{id}/activity":{"get":{"operationId":"products_getProductActivity","summary":"Get product activity","description":"First page of every activity source a product has: one entry per conversational surface (messaging conversations or client-conversation records) and one per distinct agent capability. Agent rows are `RunListRow`s read the way `GET /v1/runs?agentId=` reads them, so a client continues that source with `/v1/runs` and the surface sources with their own list endpoints; rows, cursors and `hasMore` match. A source that fails returns empty rows plus an `error`; the response is still 200.","tags":["products"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","description":"Rows per source. Defaults to 50, clamped to 100.","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Per-source first pages","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Products_getProductActivity_Response_200"}}}},"400":{"description":"Invalid product ID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Product not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/products/{id}/capabilities":{"post":{"operationId":"products_addCapabilityToProduct","summary":"Add capability to product","description":"Add a capability (flow or agent binding) to a product. Requires either flowId or agentId.","tags":["products"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Capability added","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Products_addCapabilityToProduct_Response_201"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Product or referenced resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Duplicate agent or capability name","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"agentId":{"type":"string"},"capabilityDescription":{"type":"string"},"capabilityName":{"type":"string","minLength":1,"maxLength":100},"enabled":{"type":"boolean"},"flowId":{"type":"string"},"parametersSchema":{"description":"Any type"}},"required":["capabilityName"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/products/{id}/capabilities/{capabilityId}":{"put":{"operationId":"products_updateCapability","summary":"Update capability","description":"Update an existing product capability. Supports partial updates and schema refresh.","tags":["products"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"capabilityId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Capability updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Products_updateCapability_Response_200"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Product or capability not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Capability name already exists","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"capabilityDescription":{"type":"string"},"capabilityName":{"type":"string","minLength":1,"maxLength":100},"enabled":{"type":"boolean"},"parametersSchema":{"description":"Any type"},"refreshSchema":{"type":"boolean"}}}}}},"security":[{"BearerAuth":[]}]},"delete":{"operationId":"products_removeCapability","summary":"Remove capability","description":"Remove a capability from a product.","tags":["products"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"capabilityId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Capability removed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Products_removeCapability_Response_200"}}}},"400":{"description":"Invalid ID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Product or capability not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/products/{id}/cleanup-preview":{"get":{"operationId":"products_previewCleanupResources","summary":"Preview cleanup resources","description":"Preview the flows and agents associated with a product that could be cleaned up on deletion, including whether each is referenced elsewhere.","tags":["products"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Cleanup preview","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Products_previewCleanupResources_Response_200"}}}},"400":{"description":"Invalid product ID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Product not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/products/{id}/comments":{"get":{"operationId":"products_listProductComments","summary":"List product comments","description":"List the comment threads on a product's canvas with their messages. Threads belong to the product's organization; a personal account's product has none.","tags":["products"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"status","in":"query","description":"Which threads to list; defaults to `all`","required":false,"schema":{"$ref":"#/components/schemas/V1ProductsIdCommentsGetParametersStatus"}},{"name":"limit","in":"query","description":"The newest threads to return, at most 500 (the default)","required":false,"schema":{"type":"integer","minimum":1,"maximum":500}},{"name":"cursor","in":"query","description":"The `nextCursor` of the previous page: lists the threads older than that page","required":false,"schema":{"type":"string"}},{"name":"ids","in":"query","description":"Comma-separated thread ids, at most `limit` of them: lists only those threads, in their current state","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Comment threads","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListProductCommentsResponse"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Product not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]},"post":{"operationId":"products_startAProductCommentThread","summary":"Start a product comment thread","description":"Start a comment thread on one element of the product canvas with its first comment. The author is the caller's credential.","tags":["products"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Thread started","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductCommentThread"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Product not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateProductCommentThreadRequest"}}}},"security":[{"BearerAuth":[]}]}},"/v1/products/{id}/comments/threads/{threadId}":{"patch":{"operationId":"products_resolveAProductCommentThread","summary":"Resolve a product comment thread","description":"Resolve a thread, recording who resolved it and when, or open it again. Setting the state it already has changes nothing.","tags":["products"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"threadId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Thread updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductCommentThread"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Product or thread not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateProductCommentThreadRequest"}}}},"security":[{"BearerAuth":[]}]}},"/v1/products/{id}/comments/threads/{threadId}/messages":{"post":{"operationId":"products_replyInAProductCommentThread","summary":"Reply in a product comment thread","description":"Add a comment to a thread, resolved or not. `authorKind: assistant` posts the Assistant's answer to an `@assistant` mention, relayed by the caller's client.","tags":["products"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"threadId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Comment added","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductComment"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Product or thread not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateProductCommentRequest"}}}},"security":[{"BearerAuth":[]}]}},"/v1/products/{id}/configuration":{"get":{"operationId":"products_getProductConfigurationSummary","summary":"Get product configuration summary","description":"Get the secret configuration summary for a product. Never returns secret values — used to decide whether to show a \"Configure secrets\" prompt.","tags":["products"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Configuration summary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Products_getProductConfigurationSummary_Response_200"}}}},"400":{"description":"Invalid product ID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Product not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/products/{id}/setup":{"get":{"operationId":"products_getProductSetupReadiness","summary":"Get product setup readiness","description":"Get structured, headless-first next steps to make a product live: pending secrets plus every surface's install steps, folded into a product-level readiness result. A sibling of the secrets-only configuration endpoint.","tags":["products"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Product setup readiness","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Products_getProductSetupReadiness_Response_200"}}}},"400":{"description":"Invalid product ID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Product not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/products/{id}/stack/declared":{"put":{"operationId":"products_declareProductStack","summary":"Declare product stack","description":"Replace what one source declares the product is built on (frameworks, vector databases, upstream services, versions). The Overview shows declared items beside the ones detected from the product's own configuration. The actor is the caller's credential: a named API key reads as its name, anyone else by first name.","tags":["products"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Declaration stored","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeclareProductStackResponse"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Product not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeclareProductStackRequest"}}}},"security":[{"BearerAuth":[]}]}},"/v1/products/{id}/surfaces":{"get":{"operationId":"products_listSurfaces","summary":"List surfaces","description":"List the surfaces for a product with filtering and cursor pagination.","tags":["products"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"string"}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"}},{"name":"type","in":"query","required":false,"schema":{"type":"string"}},{"name":"status","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Paginated list of surfaces","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Products_listSurfaces_Response_200"}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Product not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalError"}}}},"503":{"description":"Database temporarily unavailable; nothing was read or written. Retry after the `Retry-After` interval (seconds).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatabaseUnavailableError"}}}}},"security":[{"BearerAuth":[]}]},"post":{"operationId":"products_createSurface","summary":"Create surface","description":"Create a new surface for a product.","tags":["products"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Surface created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Products_createSurface_Response_201"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions, or `CLI_SURFACE_DISABLED`: a `cli` surface while CLI surfaces are not enabled for the account","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Product not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"behavior":{"description":"Any type"},"config":{"description":"Any type"},"inbound":{"type":"object","additionalProperties":{"description":"Any type"},"description":"Inbound config. Slack, Telegram and iMessage accept channelResponseMode (mention, the default; always; or judge, which asks the platform response-gate judgment whether to reply and waits for a mention when the judgment fails), responseRules (free text up to 2000 characters the judgment reads), eagerness (conservative, balanced or eager), onUncertain (silent or reply), responseGateShadow (opt-in: judge and record without changing behavior in mention or always mode), keywords, channelOverrides (per-channel channelResponseMode and eagerness) and contextBackfill ({ mode: window (default), judged (only the messages the judgment finds relevant, falling back to window on failure) or none, maxMessages up to 20, maxAgeMinutes up to 1440 })."},"name":{"type":"string","minLength":1,"maxLength":255},"outbound":{"type":"object","additionalProperties":{"description":"Any type"}},"status":{"$ref":"#/components/schemas/V1ProductsIdSurfacesPostRequestBodyContentApplicationJsonSchemaStatus"},"type":{"$ref":"#/components/schemas/V1ProductsIdSurfacesPostRequestBodyContentApplicationJsonSchemaType"}},"required":["name","type"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/products/{id}/surfaces/ensure":{"post":{"operationId":"products_ensureSurfaceConfigAsCodeConverge","summary":"Ensure surface (config-as-code converge)","description":"Idempotently converge a repo-defined surface definition onto a product. Identity is name + product. Hash-only probes skip the payload in the steady state (a miss is a normal 200 `definitionRequired` response, not an error); full requests create the surface or update it when the canonical content hash differs. The response always carries the server-computed canonical hash. Set dryRun to plan without writing (CI drift gate), and onConflict: \"overwrite\" to converge over dashboard/API edits. Surfaces have no version snapshots, so there is no publish option. inbound/outbound are excluded from the content hash, so a request carrying them must send the full definition; changes to them are reported in changedKeys (as inbound.<key> / outbound.<key>) and converge as \"updated\".","tags":["products"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Converge result: unchanged | created | updated | definitionRequired (hash miss — retry with the full definition) | plan (dryRun)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SurfaceEnsureResponse"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions, or `CLI_SURFACE_DISABLED`: a `cli` surface while CLI surfaces are not enabled for the account","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Product not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflict: external_modification (last write was not ensure; pass onConflict: \"overwrite\") or remote_changed (expectedRemoteHash guard)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SurfaceEnsureConflict"}}}},"422":{"description":"Submitted contentHash does not match the server-recomputed canonical hash","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SurfaceEnsureHashMismatch"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"contentHash":{"type":"string","pattern":"^[0-9a-f]{64}$"},"definition":{"$ref":"#/components/schemas/V1ProductsIdSurfacesEnsurePostRequestBodyContentApplicationJsonSchemaDefinition"},"dryRun":{"type":"boolean"},"expectedRemoteHash":{"type":"string","pattern":"^[0-9a-f]{64}$"},"name":{"type":"string","minLength":1},"onConflict":{"$ref":"#/components/schemas/V1ProductsIdSurfacesEnsurePostRequestBodyContentApplicationJsonSchemaOnConflict"}},"required":["name"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/products/{id}/surfaces/pull":{"get":{"operationId":"products_pullSurfaceDefinitionConfigAsCode","summary":"Pull surface definition (config-as-code)","description":"Return the canonical config-as-code definition and provenance for a surface by name within a product — the absorb-drift direction of the ensure protocol. The contentHash is recomputed from the live surface state, so it is accurate even immediately after a dashboard edit. Configured inbound/outbound credentials are returned as the \"<redacted>\" placeholder, which ensure accepts to keep the stored value; inbound/outbound are null when the surface has none.","tags":["products"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"name","in":"query","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Canonical definition + provenance","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SurfacePullResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Product not found, or no surface with that name in the product","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/products/{id}/surfaces/{surfaceId}":{"get":{"operationId":"products_getSurfaceDetails","summary":"Get surface details","description":"Get a surface by ID including its items and keys.","tags":["products"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"surfaceId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Surface details","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Products_getSurfaceDetails_Response_200"}}}},"400":{"description":"Invalid surface ID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Surface not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]},"put":{"operationId":"products_updateSurface","summary":"Update surface","description":"Update an existing surface. Supports partial updates with shallow-merge for behavior.","tags":["products"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"surfaceId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Surface updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Products_updateSurface_Response_200"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Product or surface not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Invalid credentials","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"behavior":{"description":"Any type"},"config":{"description":"Any type"},"inbound":{"type":"object","additionalProperties":{"description":"Any type"},"description":"Inbound config. Slack, Telegram and iMessage accept channelResponseMode (mention, the default; always; or judge, which asks the platform response-gate judgment whether to reply and waits for a mention when the judgment fails), responseRules (free text up to 2000 characters the judgment reads), eagerness (conservative, balanced or eager), onUncertain (silent or reply), responseGateShadow (opt-in: judge and record without changing behavior in mention or always mode), keywords, channelOverrides (per-channel channelResponseMode and eagerness) and contextBackfill ({ mode: window (default), judged (only the messages the judgment finds relevant, falling back to window on failure) or none, maxMessages up to 20, maxAgeMinutes up to 1440 })."},"name":{"type":"string","minLength":1,"maxLength":255},"outbound":{"type":"object","additionalProperties":{"description":"Any type"}},"status":{"$ref":"#/components/schemas/V1ProductsIdSurfacesSurfaceIdPutRequestBodyContentApplicationJsonSchemaStatus"}}}}}},"security":[{"BearerAuth":[]}]},"delete":{"operationId":"products_deleteSurface","summary":"Delete surface","description":"Delete a surface (cascades to items, keys, and orthogonal endpoint registrations).","tags":["products"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"surfaceId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Surface deleted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Products_deleteSurface_Response_200"}}}},"400":{"description":"Invalid ID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Product or surface not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/products/{id}/surfaces/{surfaceId}/entry-point":{"put":{"operationId":"products_setTheAnsweringCapabilityOfAChatSurface","summary":"Set the answering capability of a chat surface","tags":["products"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"surfaceId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Entry point selected","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Products_setTheAnsweringCapabilityOfAChatSurface_Response_200"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Product, surface or capability not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"capabilityId":{"type":"string"}},"required":["capabilityId"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/products/{id}/surfaces/{surfaceId}/items":{"post":{"operationId":"products_addItemToSurface","summary":"Add item to surface","description":"Add a capability item to a surface.","tags":["products"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"surfaceId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Surface item added","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Products_addItemToSurface_Response_201"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Product, surface, or capability not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Capability already added to this surface","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"capabilityId":{"type":"string"},"enabled":{"type":"boolean"},"endpointSlug":{"type":"string","pattern":"^[a-z0-9-]+$","maxLength":100},"exposedDescription":{"type":"string"},"exposedName":{"type":"string","maxLength":100},"isEntryPoint":{"type":"boolean"},"presentation":{"$ref":"#/components/schemas/V1ProductsIdSurfacesSurfaceIdItemsPostRequestBodyContentApplicationJsonSchemaPresentation"}},"required":["capabilityId"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/products/{id}/surfaces/{surfaceId}/items/{itemId}":{"put":{"operationId":"products_updateSurfaceItem","summary":"Update surface item","description":"Update an existing surface item. Config updates are deep-merged.","tags":["products"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"surfaceId","in":"path","required":true,"schema":{"type":"string"}},{"name":"itemId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Surface item updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Products_updateSurfaceItem_Response_200"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Product or surface item not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"config":{"type":["object","null"],"additionalProperties":{"description":"Any type"}},"enabled":{"type":"boolean"},"endpointSlug":{"type":["string","null"],"pattern":"^[a-z0-9-]+$","maxLength":100},"exposedDescription":{"type":["string","null"]},"exposedName":{"type":["string","null"],"maxLength":100},"isEntryPoint":{"type":"boolean"},"presentation":{"oneOf":[{"$ref":"#/components/schemas/V1ProductsIdSurfacesSurfaceIdItemsItemIdPutRequestBodyContentApplicationJsonSchemaPresentation"},{"type":"null"}]}}}}}},"security":[{"BearerAuth":[]}]},"delete":{"operationId":"products_removeSurfaceItem","summary":"Remove surface item","description":"Remove an item from a surface (cleans up any Orthogonal API registration).","tags":["products"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"surfaceId","in":"path","required":true,"schema":{"type":"string"}},{"name":"itemId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Surface item removed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Products_removeSurfaceItem_Response_200"}}}},"400":{"description":"Invalid ID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Product or surface item not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/products/{id}/surfaces/{surfaceId}/keys":{"post":{"operationId":"products_createSurfaceApiKey","summary":"Create surface API key","description":"Create a new API key for a surface. The plaintext key is only returned on creation.","tags":["products"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"surfaceId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Surface key created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Products_createSurfaceApiKey_Response_201"}}}},"400":{"description":"Validation error or chat surface","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Product or surface not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"environment":{"$ref":"#/components/schemas/V1ProductsIdSurfacesSurfaceIdKeysPostRequestBodyContentApplicationJsonSchemaEnvironment","default":"test"},"expiresAt":{"type":"string","format":"date-time"},"name":{"type":"string","maxLength":255},"rateLimitPerDay":{"type":"integer","minimum":1},"rateLimitPerMinute":{"type":"integer","minimum":1},"scopes":{"type":"array","items":{"type":"string","minLength":1,"maxLength":4096},"description":"Capability restrictions. Prefer IDs from get_surface.scopeTargets; linked surface-item/capability IDs and unique names shown in that catalog are accepted and resolved to immutable authorization targets. Use `*` for unrestricted access."}}}}}},"security":[{"BearerAuth":[]}]}},"/v1/products/{id}/surfaces/{surfaceId}/keys/{keyId}":{"delete":{"operationId":"products_deleteSurfaceApiKey","summary":"Delete surface API key","description":"Delete an API key for a surface.","tags":["products"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"surfaceId","in":"path","required":true,"schema":{"type":"string"}},{"name":"keyId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Surface key deleted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Products_deleteSurfaceApiKey_Response_200"}}}},"400":{"description":"Invalid ID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Product or surface key not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/products/{id}/surfaces/{surfaceId}/keys/{keyId}/reveal":{"get":{"operationId":"products_revealTestSurfaceKey","summary":"Reveal test surface key","description":"Reveal the plaintext of a test surface key. Session-only — API key authentication is rejected.","tags":["products"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"surfaceId","in":"path","required":true,"schema":{"type":"string"}},{"name":"keyId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Revealed key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Products_revealTestSurfaceKey_Response_200"}}}},"400":{"description":"Invalid ID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Cannot reveal this key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/products/{id}/surfaces/{surfaceId}/schedules":{"get":{"operationId":"products_listSchedulesForSurface","summary":"List schedules for surface","description":"List the schedules attached to a schedule-type surface.","tags":["products"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"surfaceId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"List of schedules","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Products_listSchedulesForSurface_Response_200"}}}},"400":{"description":"Invalid ID or surface is not a schedule surface","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Product or surface not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]},"post":{"operationId":"products_createScheduleForSurface","summary":"Create schedule for surface","description":"Create a new schedule (one-time or recurring) for a schedule-type surface.","tags":["products"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"surfaceId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Schedule created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Products_createScheduleForSurface_Response_201"}}}},"400":{"description":"Validation error, or RUNTIME_LANE_INELIGIBLE for a flow the batch host cannot run","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScheduleValidationError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Product, surface, or flow not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"cron":{"type":"string"},"enabled":{"type":"boolean"},"executionOptions":{"$ref":"#/components/schemas/V1ProductsIdSurfacesSurfaceIdSchedulesPostRequestBodyContentApplicationJsonSchemaExecutionOptions"},"flowId":{"type":"string"},"recordFilter":{"$ref":"#/components/schemas/V1ProductsIdSurfacesSurfaceIdSchedulesPostRequestBodyContentApplicationJsonSchemaRecordFilter"},"recordIds":{"type":"array","items":{"type":"string"}},"recordType":{"type":"string","minLength":1},"runAt":{"type":"string","format":"date-time"},"timezone":{"type":"string"},"triggerType":{"$ref":"#/components/schemas/V1ProductsIdSurfacesSurfaceIdSchedulesPostRequestBodyContentApplicationJsonSchemaTriggerType"}},"required":["flowId","triggerType"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/products/{id}/surfaces/{surfaceId}/schedules/{scheduleId}":{"get":{"operationId":"products_getScheduleDetails","summary":"Get schedule details","description":"Get a schedule by ID including recent runs.","tags":["products"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"surfaceId","in":"path","required":true,"schema":{"type":"string"}},{"name":"scheduleId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Schedule details","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Products_getScheduleDetails_Response_200"}}}},"400":{"description":"Invalid ID or surface is not a schedule surface","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Product, surface, or schedule not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]},"put":{"operationId":"products_updateSchedule","summary":"Update schedule","description":"Update an existing schedule. Recomputes next run time when trigger settings change.","tags":["products"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"surfaceId","in":"path","required":true,"schema":{"type":"string"}},{"name":"scheduleId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Schedule updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Products_updateSchedule_Response_200"}}}},"400":{"description":"Validation error, or RUNTIME_LANE_INELIGIBLE for a flow the batch host cannot run","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScheduleValidationError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Product, surface, or schedule not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"cron":{"type":["string","null"]},"enabled":{"type":"boolean"},"executionOptions":{"$ref":"#/components/schemas/V1ProductsIdSurfacesSurfaceIdSchedulesScheduleIdPutRequestBodyContentApplicationJsonSchemaExecutionOptions"},"flowId":{"type":"string"},"recordFilter":{"oneOf":[{"$ref":"#/components/schemas/V1ProductsIdSurfacesSurfaceIdSchedulesScheduleIdPutRequestBodyContentApplicationJsonSchemaRecordFilter"},{"type":"null"}]},"recordIds":{"type":"array","items":{"type":"string"}},"recordType":{"type":["string","null"],"minLength":1},"runAt":{"type":["string","null"],"format":"date-time"},"timezone":{"type":["string","null"]},"triggerType":{"$ref":"#/components/schemas/V1ProductsIdSurfacesSurfaceIdSchedulesScheduleIdPutRequestBodyContentApplicationJsonSchemaTriggerType"}}}}}},"security":[{"BearerAuth":[]}]},"delete":{"operationId":"products_deleteSchedule","summary":"Delete schedule","description":"Delete a schedule from a schedule-type surface.","tags":["products"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"surfaceId","in":"path","required":true,"schema":{"type":"string"}},{"name":"scheduleId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Schedule deleted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Products_deleteSchedule_Response_200"}}}},"400":{"description":"Invalid ID or surface is not a schedule surface","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Product, surface, or schedule not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/products/{id}/surfaces/{surfaceId}/schedules/{scheduleId}/pause":{"post":{"operationId":"products_pauseSchedule","summary":"Pause schedule","description":"Pause a schedule (sets enabled to false).","tags":["products"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"surfaceId","in":"path","required":true,"schema":{"type":"string"}},{"name":"scheduleId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Schedule paused","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Products_pauseSchedule_Response_200"}}}},"400":{"description":"Invalid ID or surface is not a schedule surface","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Product, surface, or schedule not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/products/{id}/surfaces/{surfaceId}/schedules/{scheduleId}/resume":{"post":{"operationId":"products_resumeSchedule","summary":"Resume schedule","description":"Resume a schedule (sets enabled to true).","tags":["products"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"surfaceId","in":"path","required":true,"schema":{"type":"string"}},{"name":"scheduleId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Schedule resumed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Products_resumeSchedule_Response_200"}}}},"400":{"description":"Invalid ID, surface is not a schedule surface, or RUNTIME_LANE_INELIGIBLE for a flow the batch host cannot run","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScheduleValidationError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Product, surface, or schedule not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/products/{id}/surfaces/{surfaceId}/schedules/{scheduleId}/run-now":{"post":{"operationId":"products_runScheduleImmediately","summary":"Run schedule immediately","description":"Trigger an immediate batch run of a schedule, resolving its records and submitting a batch.","tags":["products"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"surfaceId","in":"path","required":true,"schema":{"type":"string"}},{"name":"scheduleId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Schedule run queued","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Products_runScheduleImmediately_Response_200"}}}},"400":{"description":"Invalid ID, no records, or surface is not a schedule surface","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Monthly spend limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Product, surface, or schedule not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"The flow uses capabilities the batch host cannot run (RUNTIME_LANE_INELIGIBLE). Nothing is queued and no executions are counted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchLaneRefusalError"}}}},"429":{"description":"Daily execution limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalError"}}}},"503":{"description":"Database temporarily unavailable; nothing was read or written. Retry after the `Retry-After` interval (seconds).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatabaseUnavailableError"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/products/{id}/surfaces/{surfaceId}/sessions":{"get":{"operationId":"products_listSignedInSurfaceSessions","summary":"List signed-in surface sessions","description":"List the live end-user sessions on an MCP surface whose auth mode is `required` (hosted sign-in). Each session is one refresh-token family an MCP client holds for a signed-in user.","tags":["products"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"surfaceId","in":"path","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","description":"Maximum sessions to return, 1 to 100. Defaults to 50.","required":false,"schema":{"type":"string"}},{"name":"cursor","in":"query","description":"The `nextCursor` from the previous page.","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Live sessions, newest first","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Products_listSignedInSurfaceSessions_Response_200"}}}},"400":{"description":"Invalid ID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Product, surface or session not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/products/{id}/surfaces/{surfaceId}/sessions/{sessionId}":{"delete":{"operationId":"products_revokeASignedInSurfaceSession","summary":"Revoke a signed-in surface session","description":"Revoke one end-user session on an MCP surface: its refresh tokens stop rotating and its access tokens are refused, within about a minute everywhere.","tags":["products"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"surfaceId","in":"path","required":true,"schema":{"type":"string"}},{"name":"sessionId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Session revoked","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Products_revokeASignedInSurfaceSession_Response_200"}}}},"400":{"description":"Invalid ID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Product, surface or session not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/products/{id}/surfaces/{surfaceId}/setup":{"get":{"operationId":"products_getSurfaceSetupReadiness","summary":"Get surface setup readiness","description":"Get the headless-first next steps to make a single surface live. Secret steps are product-scoped and therefore only appear on the product-level setup endpoint.","tags":["products"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"surfaceId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Surface setup readiness","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Products_getSurfaceSetupReadiness_Response_200"}}}},"400":{"description":"Invalid product ID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Product or surface not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/products/{productId}/surfaces/{surfaceId}/cli/preview":{"get":{"operationId":"products_previewACliSurface","summary":"Preview a CLI surface","description":"Renders the saved `cli` surface the way a publish would build it: the exact `--help` text of the CLI and of each command, each command's flags and an example, and the SKILL.md. Compares that build with the version the install host serves, listing added, removed and changed commands and changed settings. Reads the install host's bucket and never writes to it; a surface that is turned off still previews.","tags":["products"],"parameters":[{"name":"productId","in":"path","required":true,"schema":{"type":"string"}},{"name":"surfaceId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Preview","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CliPreview"}}}},"400":{"description":"Invalid IDs, no valid command name (`CLI_BIN_NAME_REQUIRED`) or a name the publish refuses (`CLI_NAME_REJECTED`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PreviewACliSurfaceRequestBadRequestError"}}}},"403":{"description":"Insufficient permissions, `CLI_SURFACE_PUBLISH_DISABLED` while publishing is off for the account, or `CLI_INSTALL_DOMAIN_DISABLED` for an install domain while custom install domains are off","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PreviewACliSurfaceRequestForbiddenError"}}}},"404":{"description":"Product or CLI surface not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"`CLI_DIST_UNAVAILABLE`: the install host's storage failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PreviewACliSurfaceRequestBadGatewayError"}}}},"503":{"description":"`CLI_DIST_NOT_CONFIGURED`: this deployment has no `CLI_DIST` bucket or install host","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PreviewACliSurfaceRequestServiceUnavailableError"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/products/{productId}/surfaces/{surfaceId}/cli/publish":{"get":{"operationId":"products_getCliPublishStatus","summary":"Get CLI publish status","description":"Whether the install host serves this `cli` surface, and the commands that install it. Read live from the install host's bucket.","tags":["products"],"parameters":[{"name":"productId","in":"path","required":true,"schema":{"type":"string"}},{"name":"surfaceId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Publish status","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CliPublishStatus"}}}},"400":{"description":"Invalid IDs, or a name, install domain (`CLI_INSTALL_DOMAIN_INVALID`) or package the publish refuses","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetCliPublishStatusRequestBadRequestError"}}}},"403":{"description":"Insufficient permissions, `CLI_SURFACE_PUBLISH_DISABLED` while publishing is off for the account, or `CLI_INSTALL_DOMAIN_DISABLED` for an install domain while custom install domains are off","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetCliPublishStatusRequestForbiddenError"}}}},"404":{"description":"Product or CLI surface not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"`CLI_DIST_UNAVAILABLE`: the install host's storage failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetCliPublishStatusRequestBadGatewayError"}}}},"503":{"description":"`CLI_DIST_NOT_CONFIGURED`: this deployment has no `CLI_DIST` bucket or install host","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetCliPublishStatusRequestServiceUnavailableError"}}}}},"security":[{"BearerAuth":[]}]},"post":{"operationId":"products_publishACliSurface","summary":"Publish a CLI surface","description":"Writes the surface's `cli.json`, `SKILL.md` and install scripts to the install host under its slug (its command name), so `curl -fsSL https://get.runtype.com/<slug> | sh` installs it. With `installDomain` set, publish issues a TXT token (`_runtype-install.<installDomain>`); once a publish finds it, the install scripts point at `https://<installDomain>`, which serves the same files at its root. Until then the CLI installs from the Runtype host and `installDomain.state` is `pending`. The first version is 1.0.0; changed files bump the patch version. A slug belongs to the first surface that publishes it, a verified domain to the surface whose TXT record proves it, and a name close to a protected brand needs a manual review first.","tags":["products"],"parameters":[{"name":"productId","in":"path","required":true,"schema":{"type":"string"}},{"name":"surfaceId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Published or unchanged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CliPublishResult"}}}},"400":{"description":"Invalid IDs, or a name, install domain (`CLI_INSTALL_DOMAIN_INVALID`) or package the publish refuses","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublishACliSurfaceRequestBadRequestError"}}}},"403":{"description":"Insufficient permissions, `CLI_SURFACE_PUBLISH_DISABLED` while publishing is off for the account, or `CLI_INSTALL_DOMAIN_DISABLED` for an install domain while custom install domains are off","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublishACliSurfaceRequestForbiddenError"}}}},"404":{"description":"Product or CLI surface not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"The surface is inactive (`CLI_SURFACE_INACTIVE`) or has no tools (`CLI_SURFACE_HAS_NO_TOOLS`), another surface publishes its slug (`CLI_SLUG_TAKEN`) or holds its install domain while its TXT record still names that surface (`CLI_INSTALL_DOMAIN_TAKEN`), its name needs a brand review (`CLI_NAME_NEEDS_REVIEW`), or a concurrent publish changed it (`CLI_PUBLISH_CONFLICT`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublishACliSurfaceRequestConflictError"}}}},"502":{"description":"`CLI_DIST_UNAVAILABLE`: the install host's storage failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublishACliSurfaceRequestBadGatewayError"}}}},"503":{"description":"`CLI_DIST_NOT_CONFIGURED`: this deployment has no `CLI_DIST` bucket or install host","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublishACliSurfaceRequestServiceUnavailableError"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/products/{id}/surfaces/{surfaceId}/configure-from-docs":{"post":{"operationId":"webhookManagement_configureWebhookFromDocumentation","summary":"Configure webhook from documentation","description":"Trigger doc-crawling system flow to configure webhook schema from documentation URL. Not yet implemented.","tags":["webhookManagement"],"parameters":[{"name":"id","in":"path","description":"Product ID","required":true,"schema":{"type":"string"}},{"name":"surfaceId","in":"path","description":"Surface ID","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"501":{"description":"Not yet implemented","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfigureWebhookFromDocumentationRequestNotImplementedError"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"eventHint":{"type":"string","maxLength":1000},"url":{"type":"string","format":"uri"}},"required":["url"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/products/{id}/surfaces/{surfaceId}/webhook-infer":{"post":{"operationId":"webhookManagement_inferSchemaFromJsonPayload","summary":"Infer schema from JSON payload","description":"Infer a webhook schema from a pasted JSON payload.","tags":["webhookManagement"],"parameters":[{"name":"id","in":"path","description":"Product ID","required":true,"schema":{"type":"string"}},{"name":"surfaceId","in":"path","description":"Surface ID","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Schema inferred","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Webhook_Management_inferSchemaFromJsonPayload_Response_200"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"payload":{"description":"Any type"}}}}}},"security":[{"BearerAuth":[]}]}},"/v1/products/{id}/surfaces/{surfaceId}/webhook-learning":{"post":{"operationId":"webhookManagement_toggleWebhookLearningMode","summary":"Toggle webhook learning mode","description":"Enable or disable learning mode for a webhook surface.","tags":["webhookManagement"],"parameters":[{"name":"id","in":"path","description":"Product ID","required":true,"schema":{"type":"string"}},{"name":"surfaceId","in":"path","description":"Surface ID","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Learning mode toggled","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Webhook_Management_toggleWebhookLearningMode_Response_200"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"enabled":{"type":"boolean"}},"required":["enabled"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/products/{id}/surfaces/{surfaceId}/webhook-mappings":{"get":{"operationId":"webhookManagement_getWebhookFieldMappings","summary":"Get webhook field mappings","description":"Get field mappings for all surface items on a webhook surface.","tags":["webhookManagement"],"parameters":[{"name":"id","in":"path","description":"Product ID","required":true,"schema":{"type":"string"}},{"name":"surfaceId","in":"path","description":"Surface ID","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Mappings returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Webhook_Management_getWebhookFieldMappings_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]},"put":{"operationId":"webhookManagement_updateWebhookFieldMappings","summary":"Update webhook field mappings","description":"Update field mappings for a specific surface item.","tags":["webhookManagement"],"parameters":[{"name":"id","in":"path","description":"Product ID","required":true,"schema":{"type":"string"}},{"name":"surfaceId","in":"path","description":"Surface ID","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Mappings updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Webhook_Management_updateWebhookFieldMappings_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"itemId":{"type":"string"},"mappings":{"type":"array","items":{"$ref":"#/components/schemas/V1ProductsIdSurfacesSurfaceIdWebhookMappingsPutRequestBodyContentApplicationJsonSchemaMappingsItems"}}},"required":["itemId","mappings"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/products/{id}/surfaces/{surfaceId}/webhook-observations":{"get":{"operationId":"webhookManagement_listWebhookObservations","summary":"List webhook observations","description":"List observed webhook events with summary information.","tags":["webhookManagement"],"parameters":[{"name":"id","in":"path","description":"Product ID","required":true,"schema":{"type":"string"}},{"name":"surfaceId","in":"path","description":"Surface ID","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Observations listed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Webhook_Management_listWebhookObservations_Response_200"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]},"delete":{"operationId":"webhookManagement_clearWebhookObservations","summary":"Clear webhook observations","description":"Clear all observed webhook events for a surface.","tags":["webhookManagement"],"parameters":[{"name":"id","in":"path","description":"Product ID","required":true,"schema":{"type":"string"}},{"name":"surfaceId","in":"path","description":"Surface ID","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Observations cleared","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Webhook_Management_clearWebhookObservations_Response_200"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/products/{id}/surfaces/{surfaceId}/webhook-routing":{"get":{"operationId":"webhookManagement_getEventRoutingConfiguration","summary":"Get event routing configuration","description":"Get the event routing configuration for a webhook surface.","tags":["webhookManagement"],"parameters":[{"name":"id","in":"path","description":"Product ID","required":true,"schema":{"type":"string"}},{"name":"surfaceId","in":"path","description":"Surface ID","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Routing configuration returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Webhook_Management_getEventRoutingConfiguration_Response_200"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]},"put":{"operationId":"webhookManagement_updateEventRoutingConfiguration","summary":"Update event routing configuration","description":"Update event routing configuration for a webhook surface.","tags":["webhookManagement"],"parameters":[{"name":"id","in":"path","description":"Product ID","required":true,"schema":{"type":"string"}},{"name":"surfaceId","in":"path","description":"Surface ID","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Routing updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Webhook_Management_updateEventRoutingConfiguration_Response_200"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"eventTypePath":{"type":"string","minLength":1},"fallbackCapabilityId":{"type":"string"},"routes":{"type":"object","additionalProperties":{"type":"string"}}},"required":["eventTypePath","routes"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/products/{id}/surfaces/{surfaceId}/webhook-schema":{"get":{"operationId":"webhookManagement_getWebhookSchema","summary":"Get webhook schema","description":"Get the current proposed and/or confirmed schema for a webhook surface.","tags":["webhookManagement"],"parameters":[{"name":"id","in":"path","description":"Product ID","required":true,"schema":{"type":"string"}},{"name":"surfaceId","in":"path","description":"Surface ID","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Schema returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Webhook_Management_getWebhookSchema_Response_200"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]},"post":{"operationId":"webhookManagement_uploadWebhookSchema","summary":"Upload webhook schema","description":"Upload a schema (AsyncAPI, JSON Schema, or raw JSON example) for a webhook surface.","tags":["webhookManagement"],"parameters":[{"name":"id","in":"path","description":"Product ID","required":true,"schema":{"type":"string"}},{"name":"surfaceId","in":"path","description":"Surface ID","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Schema uploaded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Webhook_Management_uploadWebhookSchema_Response_200"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"format":{"$ref":"#/components/schemas/V1ProductsIdSurfacesSurfaceIdWebhookSchemaPostRequestBodyContentApplicationJsonSchemaFormat"},"schema":{"description":"Any type"}}}}}},"security":[{"BearerAuth":[]}]}},"/v1/products/{id}/surfaces/{surfaceId}/webhook-schema/confirm":{"post":{"operationId":"webhookManagement_confirmProposedSchema","summary":"Confirm proposed schema","description":"Confirm the proposed schema, making the webhook surface active.","tags":["webhookManagement"],"parameters":[{"name":"id","in":"path","description":"Product ID","required":true,"schema":{"type":"string"}},{"name":"surfaceId","in":"path","description":"Surface ID","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Schema confirmed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Webhook_Management_confirmProposedSchema_Response_200"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/products/{productId}/surfaces/{surfaceId}/a2a":{"post":{"operationId":"a2A_a2AJsonRpcEndpoint","summary":"A2A JSON-RPC endpoint","description":"A2A Protocol v1.0 JSON-RPC 2.0 transport endpoint. The request body is a JSON-RPC 2.0 envelope `{ jsonrpc: \"2.0\", id?, method, params }` dispatched on `method`. Method names are the 1.0 PascalCase forms; the legacy 0.3 slash-strings are still accepted as tolerant aliases:\n- `SendMessage` (alias `message/send`) — params: `{ message, configuration?, metadata? }`; returns an envelope whose `result` is `{ task }`.\n- `SendStreamingMessage` (alias `message/stream`) — params: same; returns a `text/event-stream` of A2A 1.0 StreamResponse events.\n- `GetTask` (alias `tasks/get`) — params: `{ id | taskId, historyLength? }`; returns a Task envelope.\n- `ListTasks` — params: `{ pageSize?, pageToken?, status?, includeArtifacts? }`; returns `{ tasks, nextPageToken, pageSize, totalSize }` (cursor-paginated).\n- `CancelTask` (alias `tasks/cancel`) — params: `{ id | taskId }`; returns a Task envelope.\n- `SubscribeToTask` (alias `tasks/resubscribe`) — params: `{ id }`; returns a `text/event-stream` of A2A 1.0 StreamResponse events.\nEach streaming `data:` line is a JSON-RPC response carrying a `StreamResponse` oneof (`statusUpdate` / `artifactUpdate`); errors stream as a JSON-RPC error envelope (`google.rpc.Status` form). The body is validated by the handler (not by request-schema middleware) so JSON-RPC error envelopes (`-32700`, METHOD_NOT_FOUND, INVALID_PARAMS) are preserved. Authentication is an A2A surface key (Authorization: Bearer a2a_xxx or X-API-Key header) or a Clerk JWT (dashboard testing).","tags":["a2A"],"parameters":[{"name":"productId","in":"path","required":true,"schema":{"type":"string"}},{"name":"surfaceId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"JSON-RPC response envelope (unary methods) or an SSE event stream (SendStreamingMessage, SubscribeToTask).","content":{"text/event-stream":{"schema":{"$ref":"#/components/schemas/A2AStreamEvent"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"A2ASurfaceKey":[]}]}},"/v1/products/{productId}/surfaces/{surfaceId}/a2a/.well-known/agent-card.json":{"get":{"operationId":"a2A_getA2AAgentCard","summary":"Get A2A Agent Card","description":"Public A2A Protocol Agent Card discovery endpoint describing an A2A surface and its skills. No authentication required.","tags":["a2A"],"parameters":[{"name":"productId","in":"path","required":true,"schema":{"type":"string"}},{"name":"surfaceId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Agent Card","content":{"application/json":{"schema":{"$ref":"#/components/schemas/A2A_getA2AAgentCard_Response_200"}}}},"404":{"description":"Agent or A2A surface not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/products/{productId}/surfaces/{surfaceId}/a2a/info":{"get":{"operationId":"a2A_getA2ASurfaceInfo","summary":"Get A2A surface info","description":"Public A2A surface information including the protocol version, JSON-RPC endpoint, Agent Card URL, and authentication details. No authentication required.","tags":["a2A"],"parameters":[{"name":"productId","in":"path","required":true,"schema":{"type":"string"}},{"name":"surfaceId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"A2A surface information","content":{"application/json":{"schema":{"$ref":"#/components/schemas/A2A_getA2ASurfaceInfo_Response_200"}}}},"404":{"description":"Product or A2A surface not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/products/{productId}/surfaces/{surfaceId}/discovered-tools":{"get":{"operationId":"surfaces_listDiscoveredWebMcpTools","summary":"List discovered WebMCP tools","description":"List the WebMCP page tools observed on this chat surface over the trailing 7 days, grouped by validated request origin. Each tool carries a live admit/reject status derived from the surface's current behavior.webmcp allowlist (never stored). Client-reported pageOrigin is returned as diagnostic metadata only.","tags":["surfaces"],"parameters":[{"name":"productId","in":"path","required":true,"schema":{"type":"string"}},{"name":"surfaceId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Discovered WebMCP tools grouped by request origin","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Surfaces_listDiscoveredWebMcpTools_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListDiscoveredWebMcpToolsRequestUnauthorizedError"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListDiscoveredWebMcpToolsRequestForbiddenError"}}}},"404":{"description":"Surface not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListDiscoveredWebMcpToolsRequestNotFoundError"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/products/{productId}/surfaces/{surfaceId}/observed-origins":{"get":{"operationId":"surfaces_listObservedPageOrigins","summary":"List observed page origins","description":"List the page origins observed sending requests to this chat surface over the trailing 7 days. Each origin carries an allowed flag indicating whether any active client token linked to this surface would admit it via the same validateOrigin check used by chat dispatch.","tags":["surfaces"],"parameters":[{"name":"productId","in":"path","required":true,"schema":{"type":"string"}},{"name":"surfaceId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Observed origins with allowed flags","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Surfaces_listObservedPageOrigins_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListObservedPageOriginsRequestUnauthorizedError"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListObservedPageOriginsRequestForbiddenError"}}}},"404":{"description":"Surface not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListObservedPageOriginsRequestNotFoundError"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/surfaces":{"get":{"operationId":"surfaces_listSurfaces","summary":"List surfaces","description":"List product surfaces across the authenticated user/org's products with cursor-based pagination. Supports filtering by product, type, and status. Slack inbound config is returned only for Slack surfaces and only includes safe-to-expose keys.","tags":["surfaces"],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"string"}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"}},{"name":"productId","in":"query","required":false,"schema":{"type":"string"}},{"name":"type","in":"query","required":false,"schema":{"type":"string"}},{"name":"status","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Paginated list of surfaces","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Surfaces_listSurfaces_Response_200"}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalError"}}}},"503":{"description":"Database temporarily unavailable; nothing was read or written. Retry after the `Retry-After` interval (seconds).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatabaseUnavailableError"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/surfaces/{surfaceId}":{"get":{"operationId":"surfaces_getSurfaceDetails","summary":"Get surface details","description":"Get an authorized surface by its globally unique ID, including items and keys.","tags":["surfaces"],"parameters":[{"name":"surfaceId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Surface details","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Surfaces_getSurfaceDetails_Response_200"}}}},"400":{"description":"Invalid surface ID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Surface not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/surfaces/{surfaceId}/channel-context":{"get":{"operationId":"surfaces_readAChannelContextWindow","summary":"Read a channel context window","description":"Read the recent channel messages a Slack, Telegram or iMessage surface holds for one channel or group (at most 20, newest 24 hours, oldest first), each with the response gate decision recorded for it, and the next-turn labels recorded on those decisions. Skipped messages create no conversation, so this is where their decisions are read.","tags":["surfaces"],"parameters":[{"name":"surfaceId","in":"path","required":true,"schema":{"type":"string"}},{"name":"channelId","in":"query","description":"Slack channel ID, Telegram chat ID, or iMessage group ID.","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"The channel window with its gate decisions and labels","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Surfaces_readAChannelContextWindow_Response_200"}}}},"400":{"description":"Invalid surface ID, or a surface type without a channel context","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Surface not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/surfaces/{surfaceId}/test-deliveries":{"post":{"operationId":"surfaces_sendAProviderFixtureThroughASurfacesRealIngress","summary":"Send a provider fixture through a surface’s real ingress","description":"Resolve an authorized surface by its globally unique ID and send a provider-native fixture through the same authenticated ingress used by production deliveries.","tags":["surfaces"],"parameters":[{"name":"surfaceId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Provider delivery attempts accepted by the surface ingress.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Surfaces_sendAProviderFixtureThroughASurfacesRealIngress_Response_200"}}}},"400":{"description":"Invalid fixture or repository state.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Authentication required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Surface not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"The surface or provider credential is not ready.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"GitHub or the surface ingress rejected the delivery.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"deliveryId":{"type":"string","pattern":"^[A-Za-z0-9._:-]{1,128}$","description":"Reuse a previous delivery ID (`X-GitHub-Delivery`), so the ingress can show it handles a repeat once."},"fixture":{"$ref":"#/components/schemas/V1SurfacesSurfaceIdTestDeliveriesPostRequestBodyContentApplicationJsonSchemaFixture"},"payload":{"type":"object","additionalProperties":{"description":"Any type"},"description":"Send and sign this payload instead of the fixture built from the pull request (an edited fixture)."},"planningPath":{"type":"string","minLength":1},"pullRequest":{"type":"integer","exclusiveMinimum":0},"repeat":{"type":"integer","minimum":1,"maximum":3},"repository":{"type":"string","pattern":"^[^/\\s]+\\/[^/\\s]+$"}},"required":["fixture","pullRequest","repository"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/products/{productId}/surfaces/{surfaceId}/mcp/.well-known/mcp.json":{"get":{"operationId":"productMcp_mcpManifest","summary":"MCP manifest","description":"MCP manifest describing the server capabilities. Public (no auth) for discovery. Protected surfaces omit tool details until authenticated.","tags":["productMcp"],"parameters":[{"name":"productId","in":"path","required":true,"schema":{"type":"string"}},{"name":"surfaceId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"MCP manifest","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Product_MCP_mcpManifest_Response_200"}}}},"404":{"description":"Product or surface not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/products/{productId}/surfaces/{surfaceId}/mcp/.well-known/oauth-protected-resource":{"get":{"operationId":"productMcp_oAuthProtectedResourceMetadata","summary":"OAuth protected resource metadata","description":"RFC 9728 Protected Resource Metadata for a surface-specific MCP endpoint. Public (no auth).","tags":["productMcp"],"parameters":[{"name":"productId","in":"path","required":true,"schema":{"type":"string"}},{"name":"surfaceId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"RFC 9728 protected resource metadata","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Product_MCP_oAuthProtectedResourceMetadata_Response_200"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/products/{productId}/surfaces/{surfaceId}/mcp/info":{"get":{"operationId":"productMcp_mcpSurfaceInfo","summary":"MCP surface info","description":"Get MCP surface information. Public (no auth required).","tags":["productMcp"],"parameters":[{"name":"productId","in":"path","required":true,"schema":{"type":"string"}},{"name":"surfaceId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"MCP surface info","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Product_MCP_mcpSurfaceInfo_Response_200"}}}},"404":{"description":"Product or surface not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/products/{productId}/surfaces/{surfaceId}/mcp/tools/execute-test":{"post":{"operationId":"productMcp_executeAnMcpSurfaceToolDashboardTest","summary":"Execute an MCP surface tool (dashboard test)","description":"Dashboard test endpoint. Authenticates with a Clerk session JWT and executes a named tool via the same path as production tools/call.","tags":["productMcp"],"parameters":[{"name":"productId","in":"path","required":true,"schema":{"type":"string"}},{"name":"surfaceId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Tool execution result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Product_MCP_executeAnMcpSurfaceToolDashboardTest_Response_200"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Tool or surface not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"arguments":{"type":"object","additionalProperties":{"description":"Any type"}},"toolName":{"type":"string"}},"required":["toolName"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/products/{productId}/surfaces/{surfaceId}/mcp/tools/test":{"post":{"operationId":"productMcp_listMcpSurfaceToolsDashboardTest","summary":"List MCP surface tools (dashboard test)","description":"Dashboard test endpoint. Authenticates with a Clerk session JWT (not MCP API keys) and returns the available tools for the surface.","tags":["productMcp"],"parameters":[{"name":"productId","in":"path","required":true,"schema":{"type":"string"}},{"name":"surfaceId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Available tools for the surface","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Product_MCP_listMcpSurfaceToolsDashboardTest_Response_200"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Product or surface not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/prompts":{"get":{"operationId":"prompts_listPrompts","summary":"List prompts","description":"Returns prompts for the authenticated user, optionally filtered by flow, search, or model.","tags":["prompts"],"parameters":[{"name":"flowId","in":"query","description":"Filter prompts by flow ID","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","description":"Max results per page (default 50, max 100)","required":false,"schema":{"type":"string"}},{"name":"cursor","in":"query","description":"Pagination cursor","required":false,"schema":{"type":"string"}},{"name":"direction","in":"query","description":"Pagination direction","required":false,"schema":{"$ref":"#/components/schemas/V1PromptsGetParametersDirection"}},{"name":"search","in":"query","description":"Search by name or text","required":false,"schema":{"type":"string"}},{"name":"model","in":"query","description":"Filter by model ID","required":false,"schema":{"type":"string"}},{"name":"view","in":"query","description":"Response representation. `full` (default) preserves complete values; `compact` shortens every string value longer than 100 characters to a 100-character preview followed by `…`.","required":false,"schema":{"$ref":"#/components/schemas/V1PromptsGetParametersView"}}],"responses":{"200":{"description":"List of prompts","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Prompts_listPrompts_Response_200"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]},"post":{"operationId":"prompts_createAPrompt","summary":"Create a prompt","description":"Creates a new standalone prompt with token estimation.","tags":["prompts"],"responses":{"201":{"description":"Prompt created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Prompts_createAPrompt_Response_201"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"model":{"type":"string","default":"gemini-3.8-flash"},"name":{"type":"string","minLength":1,"maxLength":255},"responseFormat":{"$ref":"#/components/schemas/V1PromptsPostRequestBodyContentApplicationJsonSchemaResponseFormat","default":"json"},"systemPrompt":{"type":"string"},"text":{"type":"string","minLength":1},"userPrompt":{"type":"string"}},"required":["name","text"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/prompts/{id}":{"get":{"operationId":"prompts_getPromptDetails","summary":"Get prompt details","description":"Returns a prompt with its associated flow information.","tags":["prompts"],"parameters":[{"name":"id","in":"path","description":"Prompt TypeID","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Prompt details","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Prompts_getPromptDetails_Response_200"}}}},"400":{"description":"Invalid prompt ID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Prompt not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]},"put":{"operationId":"prompts_updateAPrompt","summary":"Update a prompt","description":"Updates an existing prompt. Only provided fields are updated.","tags":["prompts"],"parameters":[{"name":"id","in":"path","description":"Prompt TypeID","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Updated prompt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Prompts_updateAPrompt_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Prompt not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"model":{"type":"string","default":"gemini-3.8-flash"},"name":{"type":"string","minLength":1,"maxLength":255},"responseFormat":{"$ref":"#/components/schemas/V1PromptsIdPutRequestBodyContentApplicationJsonSchemaResponseFormat","default":"json"},"systemPrompt":{"type":"string"},"text":{"type":"string","minLength":1},"userPrompt":{"type":"string"}}}}}},"security":[{"BearerAuth":[]}]},"delete":{"operationId":"prompts_deleteAPrompt","summary":"Delete a prompt","description":"Deletes a prompt. Flow attachments are deleted by CASCADE.","tags":["prompts"],"parameters":[{"name":"id","in":"path","description":"Prompt TypeID","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Prompt deleted","content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"400":{"description":"Invalid prompt ID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Prompt not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/provider-keys":{"get":{"operationId":"providerKeys_listProviderKeys","summary":"List provider keys","description":"Returns provider credentials for the active account. Migrated organization integrations and model-provider credentials are organization-owned; personal compatibility credentials remain user-owned.","tags":["providerKeys"],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Provider_Keys_listProviderKeys_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]},"post":{"operationId":"providerKeys_createAProviderKey","summary":"Create a provider key","description":"Creates a provider credential for the active account. In an organization, Braintrust and migrated model providers (currently OpenAI, Anthropic, Google, xAI, Mixlayer, Vercel AI Gateway, Tinfoil, Amazon Bedrock, Vertex AI, Vertex AI (Claude), and generic-openai) create organization-owned connections and return connection IDs. For OpenAI, Anthropic, Google, and xAI, isDefault=true selects organization BYOK authority; false stores the connection without changing custody. Mixlayer, Vercel AI Gateway, Tinfoil, Amazon Bedrock, Vertex AI, Vertex AI (Claude), and generic-openai creates are always storage-only; use the organization-policy endpoint to select one explicitly. Personal accounts and providers that have not migrated retain provider-key ownership. Requires BYOK entitlement.","tags":["providerKeys"],"responses":{"201":{"description":"Provider key created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Provider_Keys_createAProviderKey_Response_201"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Feature not available","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"apiKey":{"type":"string","minLength":1},"isDefault":{"type":"boolean","default":false},"name":{"type":"string","minLength":1,"maxLength":100},"provider":{"$ref":"#/components/schemas/V1ProviderKeysPostRequestBodyContentApplicationJsonSchemaProvider"},"settings":{"type":"object","additionalProperties":{"description":"Any type"},"description":"Provider-specific settings. For generic-openai: baseUrl, and apiFormat. Wire format of the custom inference endpoint: \"chat-completions\" (default) posts to {baseUrl}/chat/completions, \"responses\" posts to {baseUrl}/responses."}},"required":["apiKey","name","provider"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/provider-keys/discover-models":{"post":{"operationId":"providerKeys_discoverModelsFromEndpoint","summary":"Discover models from endpoint","description":"Discover available models from an OpenAI-compatible endpoint using a provided API key and base URL.","tags":["providerKeys"],"responses":{"200":{"description":"Models discovered","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Provider_Keys_discoverModelsFromEndpoint_Response_200"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Feature not available","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"apiKey":{"type":"string","minLength":1},"baseUrl":{"type":"string","minLength":1}},"required":["apiKey","baseUrl"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/provider-keys/organization-policy":{"put":{"operationId":"providerKeys_selectOrganizationModelProviderCredentialCustody","summary":"Select organization model-provider credential custody","description":"Selects the organization-wide credential used for a migrated model provider. This is an explicit audited authority change affecting all members and detached execution.","tags":["providerKeys"],"responses":{"200":{"description":"Organization provider credential selected","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Provider_Keys_selectOrganizationModelProviderCredentialCustody_Response_200"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Organization context or permission required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Credential selection unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Provider_Keys_selectOrganizationModelProviderCredentialCustody_Request"}}}},"security":[{"BearerAuth":[]}]}},"/v1/provider-keys/provider/{provider}":{"get":{"operationId":"providerKeys_listProviderKeysByProvider","summary":"List provider keys by provider","description":"Returns active-account provider credentials filtered by provider, including organization-owned migrated connections.","tags":["providerKeys"],"parameters":[{"name":"provider","in":"path","description":"Provider name","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Provider_Keys_listProviderKeysByProvider_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/provider-keys/{id}":{"delete":{"operationId":"providerKeys_deleteAProviderKey","summary":"Delete a provider key","description":"Deletes a provider key or supported organization-owned connection. Generic-openai deletion also cleans up associated model configs.","tags":["providerKeys"],"parameters":[{"name":"id","in":"path","description":"Provider key or organization connection ID","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Provider key deleted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Provider_Keys_deleteAProviderKey_Response_200"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Credential or model inventory moved during mixed-version rollout","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteAProviderKeyRequestConflictError"}}}},"422":{"description":"Mutation would leave organization credential selection ambiguous","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]},"patch":{"operationId":"providerKeys_updateAProviderKey","summary":"Update a provider key","description":"Updates a provider key or a supported organization-owned connection returned by create/list. For migrated organization model providers, isDefault=true explicitly selects organization BYOK authority; rotation and non-default metadata changes do not change custody policy.","tags":["providerKeys"],"parameters":[{"name":"id","in":"path","description":"Provider key or organization connection ID","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Provider key updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Provider_Keys_updateAProviderKey_Response_200"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Legacy ID replacement during mixed-version rollout","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateAProviderKeyRequestConflictError"}}}},"422":{"description":"Mutation would leave organization credential selection ambiguous","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"apiKey":{"type":"string","minLength":1},"isActive":{"type":"boolean"},"isDefault":{"type":"boolean"},"name":{"type":"string","minLength":1,"maxLength":100},"settings":{"type":"object","additionalProperties":{"description":"Any type"},"description":"Provider-specific settings. For generic-openai: baseUrl, and apiFormat. Wire format of the custom inference endpoint: \"chat-completions\" (default) posts to {baseUrl}/chat/completions, \"responses\" posts to {baseUrl}/responses."}}}}}},"security":[{"BearerAuth":[]}]}},"/v1/provider-keys/{id}/discover-models":{"post":{"operationId":"providerKeys_discoverModelsFromExistingKey","summary":"Discover models from existing key","description":"Discover available models from an existing generic-openai provider key or organization connection.","tags":["providerKeys"],"parameters":[{"name":"id","in":"path","description":"Provider key or organization connection ID","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Models discovered","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Provider_Keys_discoverModelsFromExistingKey_Response_200"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Feature not available","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/provider-keys/{id}/sync-models":{"post":{"operationId":"providerKeys_syncModelsForAProviderKey","summary":"Sync models for a provider key","description":"Sync and upsert model configurations for a generic-openai provider key or organization connection.","tags":["providerKeys"],"parameters":[{"name":"id","in":"path","description":"Provider key or organization connection ID","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Models synced","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Provider_Keys_syncModelsForAProviderKey_Response_200"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Feature not available","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Organization connection or model inventory is managed by a newer Worker","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SyncModelsForAProviderKeyRequestConflictError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"models":{"type":"array","items":{"$ref":"#/components/schemas/V1ProviderKeysIdSyncModelsPostRequestBodyContentApplicationJsonSchemaModelsItems"}}},"required":["models"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/provider-status":{"get":{"operationId":"providerStatus_getProviderStatus","summary":"Get provider status","description":"Returns configuration status for all providers (AI models, integrations, vector databases).","tags":["providerStatus"],"responses":{"200":{"description":"Provider status","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Provider_Status_getProviderStatus_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/provider-status/embedding-models":{"get":{"operationId":"providerStatus_getAvailableEmbeddingModels","summary":"Get available embedding models","description":"Get available embedding models based on configured providers.","tags":["providerStatus"],"responses":{"200":{"description":"List of embedding models","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Provider_Status_getAvailableEmbeddingModels_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/public/flows/validate":{"post":{"operationId":"flowValidation_validateAProspectiveFlowPayload","summary":"Validate a prospective flow payload","description":"Validates a flow definition without creating it. Authentication is optional — authenticated requests get additional account-scoped checks.","tags":["flowValidation"],"responses":{"200":{"description":"Validation result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FlowValidationResult"}}}},"400":{"description":"Invalid JSON body","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidateAProspectiveFlowPayloadRequestBadRequestError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FlowValidationResult"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":{"description":"Any type"}}}}}}},"/v1/public/products/validate":{"post":{"operationId":"productValidation_validateAFullProductObjectFpo","summary":"Validate a full product object (FPO)","description":"Validates a Full Product Object (FPO) against the platform schema and returns errors, warnings, and recommendations.","tags":["productValidation"],"responses":{"200":{"description":"Validation result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Product_Validation_validateAFullProductObjectFpo_Response_200"}}}},"400":{"description":"Invalid JSON body","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Validation failed unexpectedly","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidateAFullProductObjectFpoRequestInternalServerError"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"security":[{"BearerAuth":[]}]}},"/v1/public/products/validate-template":{"post":{"operationId":"productValidation_validateAProductTemplate","summary":"Validate a product template","description":"Validates a product template against the platform schema.","tags":["productValidation"],"responses":{"200":{"description":"Validation result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Product_Validation_validateAProductTemplate_Response_200"}}}},"400":{"description":"Invalid JSON body","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Validation failed unexpectedly","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidateAProductTemplateRequestInternalServerError"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"security":[{"BearerAuth":[]}]}},"/v1/public/products/validate/agent":{"post":{"operationId":"productValidation_validateAStandaloneAgentDefinition","summary":"Validate a standalone agent definition","description":"Validates an agent definition in isolation, without requiring a full product object.","tags":["productValidation"],"responses":{"200":{"description":"Validation result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Product_Validation_validateAStandaloneAgentDefinition_Response_200"}}}},"400":{"description":"Invalid JSON body","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Validation failed unexpectedly","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidateAStandaloneAgentDefinitionRequestInternalServerError"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{}}}}}}},"/v1/public/products/validate/flow":{"post":{"operationId":"productValidation_validateAStandaloneFlowDefinition","summary":"Validate a standalone flow definition","description":"Validates a flow definition in isolation, without requiring a full product object.","tags":["productValidation"],"responses":{"200":{"description":"Validation result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Product_Validation_validateAStandaloneFlowDefinition_Response_200"}}}},"400":{"description":"Invalid JSON body","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Validation failed unexpectedly","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidateAStandaloneFlowDefinitionRequestInternalServerError"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{}}}}}}},"/v1/public/products/validate/surface":{"post":{"operationId":"productValidation_validateAStandaloneSurfaceDefinition","summary":"Validate a standalone surface definition","description":"Validates a surface definition in isolation, without requiring a full product object.","tags":["productValidation"],"responses":{"200":{"description":"Validation result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Product_Validation_validateAStandaloneSurfaceDefinition_Response_200"}}}},"400":{"description":"Invalid JSON body","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Validation failed unexpectedly","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidateAStandaloneSurfaceDefinitionRequestInternalServerError"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{}}}}}}},"/v1/public/products/validate/tool":{"post":{"operationId":"productValidation_validateAStandaloneToolDefinition","summary":"Validate a standalone tool definition","description":"Validates a tool definition in isolation, without requiring a full product object.","tags":["productValidation"],"responses":{"200":{"description":"Validation result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Product_Validation_validateAStandaloneToolDefinition_Response_200"}}}},"400":{"description":"Invalid JSON body","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Validation failed unexpectedly","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidateAStandaloneToolDefinitionRequestInternalServerError"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{}}}}}}},"/v1/question-sets":{"get":{"operationId":"questionSets_listQuestionSets","summary":"List question sets","description":"List the organization's question sets with cursor pagination, newest first.","tags":["questionSets"],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"string"}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"}},{"name":"direction","in":"query","required":false,"schema":{"$ref":"#/components/schemas/V1QuestionSetsGetParametersDirection"}},{"name":"includeCount","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Paginated question sets","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Question_Sets_listQuestionSets_Response_200"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuestionSetError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions, or no organization context","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuestionSetError"}}}}},"security":[{"BearerAuth":[]}]},"post":{"operationId":"questionSets_createAQuestionSet","summary":"Create a question set","description":"Create a question set with its first version as a draft. Publish the version before a tool, step or grader can reference it.","tags":["questionSets"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Question_Sets_createAQuestionSet_Response_201"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuestionSetError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions, or no organization context","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuestionSetError"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuestionSetError"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"description":{"type":["string","null"]},"inputMapping":{"type":["object","null"],"additionalProperties":{"type":"string","minLength":1}},"model":{"type":["string","null"],"minLength":1},"name":{"type":"string","minLength":1,"maxLength":255},"questions":{"type":"object","additionalProperties":{"description":"Any type"},"description":"Judgment questions keyed by question id. Each is `{ type: \"boolean\" | \"choice\" | \"score\", instructions, criteria }`. The id is never sent to the model, so instructions and criteria carry the meaning."},"slug":{"type":"string","pattern":"^[a-z0-9][a-z0-9_-]{0,63}$","description":"Stable handle, unique in the organization: lowercase letters, digits, `-` and `_`, up to 64."}},"required":["name","questions","slug"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/question-sets/ensure":{"post":{"operationId":"questionSets_ensureQuestionSetConfigAsCodeConverge","summary":"Ensure question set (config-as-code converge)","description":"Idempotently converge a repo-defined question set. Identity is the slug within the organization. A hash-only probe skips the payload in the steady state (a miss is a normal 200 `definitionRequired`, not an error); a full request creates the set, or appends a draft version when the questions, input mapping or model differ. Set dryRun to plan without writing, onConflict: \"overwrite\" to converge over dashboard or API edits, expectedRemoteHash to bind an apply to its dry run, and release: \"publish\" to publish the latest version. Ensure never deletes a set or a version.","tags":["questionSets"],"responses":{"200":{"description":"Converge result: unchanged | created | updated | definitionRequired (hash miss; retry with the full definition) | plan (dryRun)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuestionSetEnsureResponse"}}}},"400":{"description":"Invalid request or invalid questions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EnsureQuestionSetConfigAsCodeConvergeRequestBadRequestError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions, or no organization context","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"The question set was removed while the converge ran","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EnsureQuestionSetConfigAsCodeConvergeRequestNotFoundError"}}}},"409":{"description":"Conflict: external_modification (the last write was not ensure; pass onConflict: \"overwrite\"), remote_changed (expectedRemoteHash guard), or a concurrent write","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuestionSetEnsureConflict"}}}},"422":{"description":"The submitted contentHash does not match the server-recomputed canonical hash","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuestionSetEnsureHashMismatch"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"contentHash":{"type":"string","pattern":"^[0-9a-f]{64}$"},"definition":{"$ref":"#/components/schemas/V1QuestionSetsEnsurePostRequestBodyContentApplicationJsonSchemaDefinition"},"dryRun":{"type":"boolean"},"expectedRemoteHash":{"type":"string","pattern":"^[0-9a-f]{64}$"},"onConflict":{"$ref":"#/components/schemas/V1QuestionSetsEnsurePostRequestBodyContentApplicationJsonSchemaOnConflict"},"release":{"$ref":"#/components/schemas/V1QuestionSetsEnsurePostRequestBodyContentApplicationJsonSchemaRelease"},"slug":{"type":"string","pattern":"^[a-z0-9][a-z0-9_-]{0,63}$","description":"Identity, unique in the organization: lowercase letters, digits, `-` and `_`, up to 64."}},"required":["slug"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/question-sets/pull":{"get":{"operationId":"questionSets_pullQuestionSetDefinitionConfigAsCode","summary":"Pull question set definition (config-as-code)","description":"Return the canonical config-as-code definition and provenance for a question set by slug. The definition is the latest version, and the contentHash is recomputed from the live row, so it is accurate right after a dashboard edit.","tags":["questionSets"],"parameters":[{"name":"slug","in":"query","description":"Identity, unique in the organization: lowercase letters, digits, `-` and `_`, up to 64.","required":true,"schema":{"type":"string","pattern":"^[a-z0-9][a-z0-9_-]{0,63}$"}}],"responses":{"200":{"description":"Canonical definition and provenance","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuestionSetPullResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions, or no organization context","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No question set with that slug in the organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/question-sets/{id}":{"get":{"operationId":"questionSets_getAQuestionSet","summary":"Get a question set","description":"A question set with its versions, newest first.","tags":["questionSets"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Question set","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Question_Sets_getAQuestionSet_Response_200"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuestionSetError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions, or no organization context","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuestionSetError"}}}}},"security":[{"BearerAuth":[]}]},"put":{"operationId":"questionSets_updateAQuestionSet","summary":"Update a question set","description":"Update the name or description, and append a new draft version when `questions`, `inputMapping` or `model` is present. Fields left out of a new version carry over from the latest version. No existing version is changed, and the slug is fixed.","tags":["questionSets"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Question_Sets_updateAQuestionSet_Response_200"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuestionSetError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions, or no organization context","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuestionSetError"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuestionSetError"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"description":{"type":["string","null"]},"inputMapping":{"type":["object","null"],"additionalProperties":{"type":"string","minLength":1}},"model":{"type":["string","null"],"minLength":1},"name":{"type":"string","minLength":1,"maxLength":255},"questions":{"type":"object","additionalProperties":{"description":"Any type"},"description":"Judgment questions keyed by question id. Each is `{ type: \"boolean\" | \"choice\" | \"score\", instructions, criteria }`. The id is never sent to the model, so instructions and criteria carry the meaning."}}}}}},"security":[{"BearerAuth":[]}]}},"/v1/question-sets/{id}/resolved":{"get":{"operationId":"questionSets_resolveAQuestionSet","summary":"Resolve a question set","description":"The question set exactly as an execution receives it: the current published version (or the published `version` named), with its current calibration. A draft-only set answers 404 QUESTION_SET_UNRESOLVED.","tags":["questionSets"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"version","in":"query","required":false,"schema":{"type":"integer","minimum":1}}],"responses":{"200":{"description":"Resolved","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResolvedQuestionSet"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuestionSetError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions, or no organization context","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuestionSetError"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/question-sets/{id}/versions":{"get":{"operationId":"questionSets_listAQuestionSetsVersions","summary":"List a question set's versions","description":"Every version, newest first.","tags":["questionSets"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Versions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Question_Sets_listAQuestionSetsVersions_Response_200"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuestionSetError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions, or no organization context","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuestionSetError"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/question-sets/{id}/versions/{versionNumber}/calibrations":{"get":{"operationId":"questionSets_listAQuestionSetVersionsCalibrations","summary":"List a question set version's calibrations","description":"The calibration history of one version, newest first, with cursor pagination.","tags":["questionSets"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"versionNumber","in":"path","required":true,"schema":{"type":"integer","minimum":1}},{"name":"limit","in":"query","description":"1-200, default 50.","required":false,"schema":{"type":"string"}},{"name":"cursor","in":"query","description":"`pagination.nextCursor` from a previous page.","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Calibrations","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Question_Sets_listAQuestionSetVersionsCalibrations_Response_200"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuestionSetError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions, or no organization context","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuestionSetError"}}}}},"security":[{"BearerAuth":[]}]},"post":{"operationId":"questionSets_recordACalibrationForAQuestionSetVersion","summary":"Record a calibration for a question set version","description":"Append a calibration measurement to a published version and make it the current one. Calibrations are never edited or deleted, so every past decision keeps the calibration it was taken under.","tags":["questionSets"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"versionNumber","in":"path","required":true,"schema":{"type":"integer","minimum":1}}],"responses":{"201":{"description":"Recorded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Question_Sets_recordACalibrationForAQuestionSetVersion_Response_201"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuestionSetError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions, or no organization context","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuestionSetError"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuestionSetError"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"evalRunId":{"type":"string","minLength":1,"description":"The eval run that measured this calibration. It must resolve in this account; the row is then recorded as `eval_suite`. Without it the row is `customer`."},"record":{"$ref":"#/components/schemas/V1QuestionSetsIdVersionsVersionNumberCalibrationsPostRequestBodyContentApplicationJsonSchemaRecord"}},"required":["record"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/question-sets/{id}/versions/{versionNumber}/publish":{"post":{"operationId":"questionSets_publishAQuestionSetVersion","summary":"Publish a question set version","description":"Freeze the version and make it the one executions resolve when they name no version. Publishing an already-published version moves the current pointer back to it.","tags":["questionSets"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"versionNumber","in":"path","required":true,"schema":{"type":"integer","minimum":1}},{"name":"onConflict","in":"query","description":"A set managed by code (`lastModifiedSource` is `sdk` or `terraform`) answers 409 `managed_by_code_conflict` unless this is `overwrite`.","required":false,"schema":{"$ref":"#/components/schemas/V1QuestionSetsIdVersionsVersionNumberPublishPostParametersOnConflict"}}],"responses":{"200":{"description":"Published","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Question_Sets_publishAQuestionSetVersion_Response_200"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuestionSetError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions, or no organization context","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuestionSetError"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuestionSetError"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/records":{"get":{"operationId":"records_listRecords","summary":"List records","description":"Get all records for the authenticated user with advanced filtering and cursor pagination.","tags":["records"],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"string"}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"}},{"name":"direction","in":"query","required":false,"schema":{"type":"string"}},{"name":"includeCount","in":"query","required":false,"schema":{"type":"string"}},{"name":"type","in":"query","required":false,"schema":{"type":"string"}},{"name":"search","in":"query","required":false,"schema":{"type":"string"}},{"name":"name","in":"query","required":false,"schema":{"type":"string"}},{"name":"ownerId","in":"query","required":false,"schema":{"type":"string"}},{"name":"distinct","in":"query","required":false,"schema":{"type":"string"}},{"name":"includeSummary","in":"query","description":"When set to \"true\" with distinct=types, includes per-type record counts and latest write timestamps in summaries.","required":false,"schema":{"type":"string"}},{"name":"includeFields","in":"query","required":false,"schema":{"type":"string"}},{"name":"product_surface_id","in":"query","required":false,"schema":{"type":"string"}},{"name":"metadata_keys","in":"query","required":false,"schema":{"type":"string"}},{"name":"metadata_keys_all","in":"query","required":false,"schema":{"type":"string"}},{"name":"min_fields","in":"query","required":false,"schema":{"type":"string"}},{"name":"max_fields","in":"query","required":false,"schema":{"type":"string"}},{"name":"metadata_types","in":"query","required":false,"schema":{"type":"string"}},{"name":"has_large_fields","in":"query","required":false,"schema":{"type":"string"}},{"name":"min_size_kb","in":"query","required":false,"schema":{"type":"string"}},{"name":"max_size_kb","in":"query","required":false,"schema":{"type":"string"}},{"name":"recordFilter","in":"query","required":false,"schema":{"type":"string"}},{"name":"view","in":"query","description":"Response representation. `full` (default) preserves complete values; `compact` shortens every string value longer than 100 characters to a 100-character preview followed by `…`.","required":false,"schema":{"$ref":"#/components/schemas/V1RecordsGetParametersView"}}],"responses":{"200":{"description":"Paginated list of records","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Records_listRecords_Response_200"}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalError"}}}},"503":{"description":"Database temporarily unavailable; nothing was read or written. Retry after the `Retry-After` interval (seconds).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatabaseUnavailableError"}}}}},"security":[{"BearerAuth":[]}]},"post":{"operationId":"records_createRecord","summary":"Create record","description":"Create a new record with metadata. Returns 409 if a record with the same type and name already exists in the tenant.","tags":["records"],"responses":{"201":{"description":"Created record","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Records_createRecord_Response_201"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Duplicate record","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Metadata violates the type's collection schema (enforce mode)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecordSchemaValidationError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalError"}}}},"503":{"description":"The type's collection schema could not be loaded, so the write was refused rather than left unvalidated; retry","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionLookupFailedError"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"messages":{"type":["array","null"],"items":{"$ref":"#/components/schemas/V1RecordsPostRequestBodyContentApplicationJsonSchemaMessagesItems"}},"metadata":{"type":"object","additionalProperties":{"description":"Any type"},"default":{}},"name":{"type":"string","minLength":1,"maxLength":500},"ownerId":{"type":["string","null"],"minLength":1,"maxLength":255,"description":"Owner key for this record, stored in the indexed owner_id column and filterable via ?ownerId=. Overrides a nested metadata.ownerId. Null means no owner."},"type":{"type":"string","minLength":1,"maxLength":255}},"required":["name","type"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/records/bulk-delete":{"post":{"operationId":"records_bulkDeleteRecords","summary":"Bulk delete records","description":"Delete multiple records by their IDs.","tags":["records"],"responses":{"200":{"description":"Bulk delete result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Records_bulkDeleteRecords_Response_200"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"array","items":{"type":"string","minLength":1}}},"required":["ids"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/records/bulk-edit":{"post":{"operationId":"records_bulkEditRecords","summary":"Bulk edit records","description":"Bulk update or delete metadata fields on multiple records. One request can target at most 5,000 records; a larger target set is rejected with 400 `bulk_edit_too_many_records` before anything is written, so narrow the selection and edit in batches.","tags":["records"],"responses":{"200":{"description":"Bulk edit result with before/after diffs","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Records_bulkEditRecords_Response_200"}}}},"400":{"description":"Validation error, or the edit targets more than 5,000 records (`bulk_edit_too_many_records`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkEditError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"A target record changed while the edit was applied (`record_conflict`); nothing was written, retry the edit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"A record's post-merge metadata violates its type's collection schema (enforce mode); the whole edit is rejected","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecordSchemaValidationError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"The type's collection schema could not be loaded, so the write was refused rather than left unvalidated; retry","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionLookupFailedError"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"applyToAll":{"type":"boolean","default":false},"conditions":{"type":"array","items":{"$ref":"#/components/schemas/V1RecordsBulkEditPostRequestBodyContentApplicationJsonSchemaConditionsItems"},"default":[]},"deleteFields":{"type":"array","items":{"type":"string"},"default":[]},"dryRun":{"type":"boolean","default":false},"recordFilter":{"$ref":"#/components/schemas/V1RecordsBulkEditPostRequestBodyContentApplicationJsonSchemaRecordFilter"},"recordIds":{"type":"array","items":{"type":"string","minLength":1}},"updates":{"type":"object","additionalProperties":{"description":"Any type"},"default":{}}}}}}},"security":[{"BearerAuth":[]}]}},"/v1/records/export":{"get":{"operationId":"records_exportRecordsAsCsv","summary":"Export records as CSV","description":"Export filtered records as a streamed CSV file. Returns 204 with no body when no records match.","tags":["records"],"parameters":[{"name":"type","in":"query","required":false,"schema":{"type":"string"}},{"name":"search","in":"query","required":false,"schema":{"type":"string"}},{"name":"name","in":"query","required":false,"schema":{"type":"string"}},{"name":"ownerId","in":"query","required":false,"schema":{"type":"string"}},{"name":"distinct","in":"query","required":false,"schema":{"type":"string"}},{"name":"includeFields","in":"query","required":false,"schema":{"type":"string"}},{"name":"product_surface_id","in":"query","required":false,"schema":{"type":"string"}},{"name":"metadata_keys","in":"query","required":false,"schema":{"type":"string"}},{"name":"metadata_keys_all","in":"query","required":false,"schema":{"type":"string"}},{"name":"min_fields","in":"query","required":false,"schema":{"type":"string"}},{"name":"max_fields","in":"query","required":false,"schema":{"type":"string"}},{"name":"metadata_types","in":"query","required":false,"schema":{"type":"string"}},{"name":"has_large_fields","in":"query","required":false,"schema":{"type":"string"}},{"name":"min_size_kb","in":"query","required":false,"schema":{"type":"string"}},{"name":"max_size_kb","in":"query","required":false,"schema":{"type":"string"}},{"name":"recordFilter","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"CSV export of the filtered records","content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalError"}}}},"503":{"description":"Database temporarily unavailable; nothing was read or written. Retry after the `Retry-After` interval (seconds).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatabaseUnavailableError"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/records/field-values":{"get":{"operationId":"records_getFieldValues","summary":"Get field values","description":"Get top distinct values for a metadata field, with per-value counts.","tags":["records"],"parameters":[{"name":"type","in":"query","required":true,"schema":{"type":"string"}},{"name":"field","in":"query","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Field values with counts","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Records_getFieldValues_Response_200"}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/records/preview-filter":{"post":{"operationId":"records_previewRecordFilter","summary":"Preview record filter","description":"Preview a filter — returns matching count and a small sample of records.","tags":["records"],"responses":{"200":{"description":"Filter preview result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Records_previewRecordFilter_Response_200"}}}},"400":{"description":"Invalid filter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","minLength":1,"maxLength":255},"where":{"$ref":"#/components/schemas/V1RecordsPreviewFilterPostRequestBodyContentApplicationJsonSchemaWhere"}},"required":["type"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/records/schema":{"get":{"operationId":"records_discoverRecordSchema","summary":"Discover record schema","description":"Discover available metadata fields for a record type by sampling records.","tags":["records"],"parameters":[{"name":"type","in":"query","required":true,"schema":{"type":"string"}},{"name":"sample","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Schema field discovery result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Records_discoverRecordSchema_Response_200"}}}},"400":{"description":"Missing type parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/records/upload-csv":{"post":{"operationId":"records_uploadCsvRecords","summary":"Upload CSV records","description":"Upload and process a CSV file to create records in bulk. Either supply `typeColumn` to read the type from a column, or `typeValue` to assign the same constant type to every row (skipping the column lookup). `typeValue` takes precedence when both are provided.","tags":["records"],"responses":{"201":{"description":"CSV upload result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Records_uploadCsvRecords_Response_201"}}}},"400":{"description":"Invalid CSV or missing file","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"file":{"description":"Any type"},"nameColumn":{"type":"string"},"typeColumn":{"type":"string"},"typeValue":{"type":"string","maxLength":255}}}}}},"security":[{"BearerAuth":[]}]}},"/v1/records/{id}":{"get":{"operationId":"records_getRecordDetails","summary":"Get record details","description":"Get a specific record by ID including its metadata.","tags":["records"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Record details","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Records_getRecordDetails_Response_200"}}}},"400":{"description":"Invalid record ID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Record not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]},"put":{"operationId":"records_updateRecord","summary":"Update record","description":"Update fields on an existing record.","tags":["records"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Updated record","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Records_updateRecord_Response_200"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Record not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Duplicate record (`duplicate_record`), or the record changed while this update was applied (`record_conflict`; re-read and retry)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Metadata violates the type's collection schema (enforce mode)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecordSchemaValidationError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"The type's collection schema could not be loaded, so the write was refused rather than left unvalidated; retry","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionLookupFailedError"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"messages":{"type":["array","null"],"items":{"$ref":"#/components/schemas/V1RecordsIdPutRequestBodyContentApplicationJsonSchemaMessagesItems"}},"metadata":{"type":"object","additionalProperties":{"description":"Any type"},"description":"Replaces the whole metadata object. Omit to leave metadata unchanged."},"name":{"type":"string","minLength":1,"maxLength":500},"ownerId":{"type":["string","null"],"minLength":1,"maxLength":255,"description":"Reassigns the owner (indexed owner_id column, filterable via ?ownerId=). Overrides a nested metadata.ownerId. Null clears the owner; omit to leave it unchanged."},"type":{"type":"string","minLength":1,"maxLength":255}}}}}},"security":[{"BearerAuth":[]}]},"delete":{"operationId":"records_deleteRecord","summary":"Delete record","description":"Delete a record by ID.","tags":["records"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Record deleted","content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"400":{"description":"Invalid record ID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Record not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/records/{id}/costs":{"get":{"operationId":"records_getRecordCosts","summary":"Get record costs","description":"Get aggregated cost breakdown for a specific record.","tags":["records"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Cost aggregation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Records_getRecordCosts_Response_200"}}}},"400":{"description":"Invalid record ID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Record not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/records/{id}/results":{"get":{"operationId":"records_getRecordResults","summary":"Get record results","description":"Get all execution results for a specific record with filtering and pagination.","tags":["records"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"page","in":"query","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"string"}},{"name":"status","in":"query","required":false,"schema":{"type":"string"}},{"name":"promptId","in":"query","required":false,"schema":{"type":"string"}},{"name":"flowId","in":"query","required":false,"schema":{"type":"string"}},{"name":"from","in":"query","required":false,"schema":{"type":"string"}},{"name":"to","in":"query","required":false,"schema":{"type":"string"}},{"name":"sortBy","in":"query","required":false,"schema":{"type":"string"}},{"name":"sortOrder","in":"query","required":false,"schema":{"type":"string"}},{"name":"includeCount","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Paginated record results","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Records_getRecordResults_Response_200"}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Record not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]},"delete":{"operationId":"records_deleteRecordResult","summary":"Delete record result","description":"Delete a specific execution result from a record.","tags":["records"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Result deleted","content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Record or result not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"resultId":{"type":"string","minLength":1}},"required":["resultId"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/records/{id}/step-results":{"get":{"operationId":"records_getRecordStepResults","summary":"Get record step results","description":"Get unified step results for a specific record with filtering and pagination.","tags":["records"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"flowId","in":"query","required":false,"schema":{"type":"string"}},{"name":"batchId","in":"query","required":false,"schema":{"type":"string"}},{"name":"status","in":"query","required":false,"schema":{"type":"string"}},{"name":"from","in":"query","required":false,"schema":{"type":"string"}},{"name":"to","in":"query","required":false,"schema":{"type":"string"}},{"name":"sortBy","in":"query","required":false,"schema":{"type":"string"}},{"name":"sortOrder","in":"query","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"string"}},{"name":"offset","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Paginated step results","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Records_getRecordStepResults_Response_200"}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Record not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/resources":{"get":{"operationId":"resources_getAvailableResources","summary":"Get available resources","description":"Consolidated endpoint returning all available resources: enabled models, custom tools, built-in tools, integration tools, and MCP servers.","tags":["resources"],"parameters":[{"name":"modelId","in":"query","description":"Model ID for built-in tool filtering","required":false,"schema":{"type":"string"}},{"name":"modelProvider","in":"query","description":"Model provider for built-in tool filtering (required with modelId)","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Available resources","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Resources_getAvailableResources_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/runs":{"get":{"operationId":"runs_listRuns","summary":"List runs","description":"Every agent and flow run in the span store, newest start first, including runs that write no control-plane row. The UNSCOPED feed is ROOT runs only: a subagent or nested-flow run folds under its parent, `childCount` says how many are folded there, and `parentExecutionId=<id>` reads them. Pass `includeChildren=true` for the flat enumeration. Any resource-scoped filter (`agentId`, `flowId`, `conversationId`, `surfaceId`, `recordId`, `batchExecutionId`, `parentExecutionId`, `rootExecutionId`, `executionId`) is already an explicit selection and never folds, so an agent that only ever runs as a subagent still lists under `agentId`. Each row carries `origin` (dashboard | api | internal | null), read from the caller's authenticated principal, and `test` as its derived alias for `origin === \"dashboard\"`; any entrance that resolves a principal stamps origin, including the Runtype MCP server tools and Code Mode (`api`) and the hosted `/v1/mcp` proxy (`internal`). A lane with no principal answers null for both by design: schedule, webhook, messaging, A2A, an agent exposed as an MCP surface, subagent, nested flow, a client-token product surface, an ingested run, and any row whose header predates the field. `overlay=live` adds live control-plane fields; the overlay never adds, drops or reorders a row. A cursor minted by the retired control-plane list lane (`cp.` prefix) restarts at page one and answers `pagination.cursorReset: true`. `includeCount=true` adds `pagination.totalCount`, counted up to 1000, and `pagination.totalCountCapped`. Each row carries `via` (schedule | surface | api | mcp | cli | test | eval, with the id and name of the thing that started it) where the entrance stated it; null otherwise.","tags":["runs"],"parameters":[{"name":"agentId","in":"query","description":"Filter by agent id; repeat for a set.","required":false,"schema":{"$ref":"#/components/schemas/V1RunsGetParametersAgentId"}},{"name":"flowId","in":"query","description":"Filter by flow id; repeat for a set.","required":false,"schema":{"$ref":"#/components/schemas/V1RunsGetParametersFlowId"}},{"name":"conversationId","in":"query","description":"Filter by conversation id; repeat for a set (at most 100 per request).","required":false,"schema":{"$ref":"#/components/schemas/V1RunsGetParametersConversationId"}},{"name":"surfaceId","in":"query","description":"Filter by surface id.","required":false,"schema":{"type":"string"}},{"name":"surfaceType","in":"query","description":"Filter by surface family.","required":false,"schema":{"type":"string"}},{"name":"recordId","in":"query","description":"Filter by record id.","required":false,"schema":{"type":"string"}},{"name":"batchExecutionId","in":"query","description":"Filter by batch id; repeat for a set.","required":false,"schema":{"$ref":"#/components/schemas/V1RunsGetParametersBatchExecutionId"}},{"name":"parentExecutionId","in":"query","description":"Runs spawned by this execution.","required":false,"schema":{"type":"string"}},{"name":"rootExecutionId","in":"query","description":"Runs in this execution tree.","required":false,"schema":{"type":"string"}},{"name":"includeChildren","in":"query","description":"true restores the flat enumeration on the UNSCOPED feed, in which a subagent run and a nested-flow run list beside their parent. The unscoped feed is roots only by default: a row whose parentExecutionId is set folds under its parent and is read with parentExecutionId=<executionId>. Any filter that scopes to a resource — agentId, flowId, conversationId, surfaceId, recordId, batchExecutionId, parentExecutionId, rootExecutionId or executionId — is already an explicit selection and never folds, so an agent that only ever runs as a subagent still lists under agentId. This parameter changes nothing on a scoped request.","required":false,"schema":{"$ref":"#/components/schemas/V1RunsGetParametersIncludeChildren"}},{"name":"executionId","in":"query","description":"Read specific runs by id; at most 100 per request.","required":false,"schema":{"$ref":"#/components/schemas/V1RunsGetParametersExecutionId"}},{"name":"source","in":"query","description":"Filter by producing lane.","required":false,"schema":{"$ref":"#/components/schemas/V1RunsGetParametersSource"}},{"name":"status","in":"query","description":"status accepts only running, completed or failed. queued, awaiting and cancelled exist only in the live overlay, which may never change which rows a page holds, so the server cannot filter on them.","required":false,"schema":{"$ref":"#/components/schemas/V1RunsGetParametersStatus"}},{"name":"traffic","in":"query","description":"live keeps runs real users and integrations started; test keeps runs started from the dashboard (Test, step tests, Ask); eval keeps eval-batch runs; sim keeps simulation turns; all, or omitted, keeps every run. A simulation turn is sim even when a schedule started it, a schedule run is live, and an eval batch run is eval whoever started it.","required":false,"schema":{"$ref":"#/components/schemas/V1RunsGetParametersTraffic"}},{"name":"signal","in":"query","description":"Runs where this signal fired: `key` for any fired value, or `key:value` for one choice value (for example frustration:churn_threat).","required":false,"schema":{"type":"string"}},{"name":"from","in":"query","description":"Window start (ISO 8601). Defaults to 24 hours ago.","required":false,"schema":{"type":"string"}},{"name":"to","in":"query","description":"Window end (ISO 8601). Defaults to now.","required":false,"schema":{"type":"string"}},{"name":"view","in":"query","description":"full (the default) returns every field. compact omits exactly these 17: model, stopReason, iterations, inputPreview, flowVersionId, agentVersionId, agentVersionLabel, agentVersionNumber, agentTargetResolution, otelProducer, lastHeartbeatAt, expiresAt, cancelRequestedAt, progress, pendingApproval, budgetExhausted and inputMessages. The status is still overlay-corrected on a compact page; only the fields differ.","required":false,"schema":{"$ref":"#/components/schemas/V1RunsGetParametersView"}},{"name":"overlay","in":"query","description":"live adds control-plane fields; defaults to live for a session, none for an API key.","required":false,"schema":{"$ref":"#/components/schemas/V1RunsGetParametersOverlay"}},{"name":"limit","in":"query","description":"Page size, at most 100.","required":false,"schema":{"type":"string"}},{"name":"cursor","in":"query","description":"Keyset cursor from a previous page.","required":false,"schema":{"type":"string"}},{"name":"includeCount","in":"query","description":"\"true\" adds pagination.totalCount and pagination.totalCountCapped: the number of runs matching this request's filters within its window, ignoring the cursor and limit, counted up to 1000. Past that the count stops at 1000 and totalCountCapped is true, so read it as \"more than 1000\". Omitted, or any other value, the response carries neither field.","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Runs returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Runs_listRuns_Response_200"}}}},"400":{"description":"Invalid request, including a filter whose value could not be read","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient API key permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Run store temporarily unavailable; nothing could be read. Retry after the `Retry-After` interval (seconds).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunStoreUnavailableError"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/runs/stats":{"get":{"operationId":"runs_countRuns","summary":"Count runs","description":"Totals, failures, latency percentiles and cost over exactly the runs `GET /v1/runs` lists for the same filters and window, grouped by flow, agent and surface. `failed` uses the list's own `status=failed` predicate, so a count and the rows it describes cannot disagree. `traffic` narrows to live, test, eval or sim runs; `byTraffic` reports all four before that filter. Cost never counts an unknown run as zero: `cost.unpricedRuns` says how many settled runs have no known cost.","tags":["runs"],"parameters":[{"name":"agentId","in":"query","description":"Filter by agent id; repeat for a set.","required":false,"schema":{"$ref":"#/components/schemas/V1RunsStatsGetParametersAgentId"}},{"name":"flowId","in":"query","description":"Filter by flow id; repeat for a set.","required":false,"schema":{"$ref":"#/components/schemas/V1RunsStatsGetParametersFlowId"}},{"name":"conversationId","in":"query","description":"Filter by conversation id; repeat for a set (at most 100 per request).","required":false,"schema":{"$ref":"#/components/schemas/V1RunsStatsGetParametersConversationId"}},{"name":"surfaceId","in":"query","description":"Filter by surface id.","required":false,"schema":{"type":"string"}},{"name":"surfaceType","in":"query","description":"Filter by surface family.","required":false,"schema":{"type":"string"}},{"name":"recordId","in":"query","description":"Filter by record id.","required":false,"schema":{"type":"string"}},{"name":"batchExecutionId","in":"query","description":"Filter by batch id; repeat for a set.","required":false,"schema":{"$ref":"#/components/schemas/V1RunsStatsGetParametersBatchExecutionId"}},{"name":"includeChildren","in":"query","description":"true restores the flat enumeration on the UNSCOPED feed, in which a subagent run and a nested-flow run list beside their parent. The unscoped feed is roots only by default: a row whose parentExecutionId is set folds under its parent and is read with parentExecutionId=<executionId>. Any filter that scopes to a resource — agentId, flowId, conversationId, surfaceId, recordId, batchExecutionId, parentExecutionId, rootExecutionId or executionId — is already an explicit selection and never folds, so an agent that only ever runs as a subagent still lists under agentId. This parameter changes nothing on a scoped request.","required":false,"schema":{"$ref":"#/components/schemas/V1RunsStatsGetParametersIncludeChildren"}},{"name":"source","in":"query","description":"Filter by producing lane.","required":false,"schema":{"$ref":"#/components/schemas/V1RunsStatsGetParametersSource"}},{"name":"status","in":"query","description":"status accepts only running, completed or failed. queued, awaiting and cancelled exist only in the live overlay, which may never change which rows a page holds, so the server cannot filter on them.","required":false,"schema":{"$ref":"#/components/schemas/V1RunsStatsGetParametersStatus"}},{"name":"traffic","in":"query","description":"live keeps runs real users and integrations started; test keeps runs started from the dashboard (Test, step tests, Ask); eval keeps eval-batch runs; sim keeps simulation turns; all, or omitted, keeps every run. A simulation turn is sim even when a schedule started it, a schedule run is live, and an eval batch run is eval whoever started it.","required":false,"schema":{"$ref":"#/components/schemas/V1RunsStatsGetParametersTraffic"}},{"name":"from","in":"query","description":"Window start (ISO 8601). Defaults to 24 hours ago.","required":false,"schema":{"type":"string"}},{"name":"to","in":"query","description":"Window end (ISO 8601). Defaults to now.","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Run counts returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Runs_countRuns_Response_200"}}}},"400":{"description":"Invalid request, including a filter whose value could not be read","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient API key permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Run store temporarily unavailable; nothing could be read. Retry after the `Retry-After` interval (seconds).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunStoreUnavailableError"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/runs/stats/products":{"get":{"operationId":"runs_countRunsPerProduct","summary":"Count runs per product","description":"Total and failed runs for several products in one read, over the same window and `traffic` filter as `GET /v1/runs/stats`. A product counts its agent capabilities' runs by `agentId` and its other capabilities' runs by `flowId`, each family read the way `/v1/runs/stats` reads it, and the two summed. Name at most 100 products; one the caller does not own is left out, as is one that does not exist. An API key needs PRODUCTS:READ, plus AGENTS:READ or FLOWS:READ for each family the named products run.","tags":["runs"],"parameters":[{"name":"traffic","in":"query","description":"live keeps runs real users and integrations started; test keeps runs started from the dashboard (Test, step tests, Ask); eval keeps eval-batch runs; sim keeps simulation turns; all, or omitted, keeps every run. A simulation turn is sim even when a schedule started it, a schedule run is live, and an eval batch run is eval whoever started it.","required":false,"schema":{"$ref":"#/components/schemas/V1RunsStatsProductsGetParametersTraffic"}},{"name":"from","in":"query","description":"Window start (ISO 8601). Defaults to 24 hours ago.","required":false,"schema":{"type":"string"}},{"name":"to","in":"query","description":"Window end (ISO 8601). Defaults to now.","required":false,"schema":{"type":"string"}},{"name":"productIds","in":"query","description":"Comma-separated product ids, at most 100. A product the caller does not own is left out of the answer.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Run counts per product returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Runs_countRunsPerProduct_Response_200"}}}},"400":{"description":"Invalid request, including a filter whose value could not be read","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient API key permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Run store temporarily unavailable; nothing could be read. Retry after the `Retry-After` interval (seconds).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunStoreUnavailableError"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/runs/{executionId}":{"get":{"operationId":"runs_readOneRun","summary":"Read one run","description":"One run the caller owns, in the row shape the list returns. An API key must hold the scope of the run's own execution kind (AGENTS:READ or FLOWS:READ, and both when the run states neither). Use `GET /v1/logs/trace/execution/{id}` for its span tree.","tags":["runs"],"parameters":[{"name":"executionId","in":"path","required":true,"schema":{"type":"string"}},{"name":"overlay","in":"query","description":"live adds control-plane fields; defaults to live for a session, none for an API key.","required":false,"schema":{"$ref":"#/components/schemas/V1RunsExecutionIdGetParametersOverlay"}},{"name":"view","in":"query","description":"full (the default) returns every field. compact omits exactly these 17: model, stopReason, iterations, inputPreview, flowVersionId, agentVersionId, agentVersionLabel, agentVersionNumber, agentTargetResolution, otelProducer, lastHeartbeatAt, expiresAt, cancelRequestedAt, progress, pendingApproval, budgetExhausted and inputMessages. The status is still overlay-corrected on a compact page; only the fields differ.","required":false,"schema":{"$ref":"#/components/schemas/V1RunsExecutionIdGetParametersView"}}],"responses":{"200":{"description":"Run returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Runs_readOneRun_Response_200"}}}},"400":{"description":"Invalid request, including a filter whose value could not be read","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient API key permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Run not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Run store temporarily unavailable; nothing could be read. Retry after the `Retry-After` interval (seconds).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunStoreUnavailableError"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/runtime/crawl":{"post":{"operationId":"selfHosting_executeASynchronousSiteCrawl","summary":"Execute a synchronous site crawl","description":"Hosted fulfillment of the runtime SiteCrawler seam. Executes the same crawl capability the `crawl` flow step uses (Cloudflare Browser Rendering: submit, poll to completion, paginate results) and resolves once with the collected pages. Synchronous only: the async crawl_pending pause machinery is not available on this endpoint. Consumed by standalone `@runtypelabs/runtime` deployments via `HostedSiteCrawler`. Requires an Enterprise plan: ineligible accounts receive 403 (code `BYOC_PLAN_REQUIRED`).","tags":["selfHosting"],"responses":{"200":{"description":"Crawl completed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Self-hosting_executeASynchronousSiteCrawl_Response_200"}}}},"400":{"description":"Invalid request, or Browser Rendering credentials are not configured","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExecuteASynchronousSiteCrawlRequestBadRequestError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Monthly spend limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions, or the account is not on an Enterprise plan (code `BYOC_PLAN_REQUIRED`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Daily execution limit or rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"501":{"description":"The crawl requested an async continuation, which the synchronous endpoint does not support","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExecuteASynchronousSiteCrawlRequestNotImplementedError"}}}},"502":{"description":"The crawl failed upstream (submit error, non-completed terminal status, …)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExecuteASynchronousSiteCrawlRequestBadGatewayError"}}}},"504":{"description":"The crawl did not reach a terminal status within completionTimeoutMs","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExecuteASynchronousSiteCrawlRequestGatewayTimeoutError"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"limits":{"$ref":"#/components/schemas/V1RuntimeCrawlPostRequestBodyContentApplicationJsonSchemaLimits"},"options":{"$ref":"#/components/schemas/V1RuntimeCrawlPostRequestBodyContentApplicationJsonSchemaOptions"},"url":{"type":"string","minLength":1,"description":"Fully-resolved seed URL, passed through to the crawl service untouched. Note the platform crawl service drops query strings from the seed URL and follows absolute links only (service behavior, inherited by design)."}},"required":["url"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/runtime/email/send":{"post":{"operationId":"selfHosting_sendARenderedEmailFromAStandaloneRuntime","summary":"Send a rendered email from a standalone runtime","description":"Hosted fulfillment of the runtime EmailSender seam. Accepts a fully RENDERED message (no template strings) and dispatches it through the platform email path with the managed-send-from-domain gate evaluated against the authenticated account. Requires a Runtype API key with the RUNTIME:EXECUTE scope (FLOWS:EXECUTE also accepted). Requires an Enterprise plan: ineligible accounts receive 403 (code `BYOC_PLAN_REQUIRED`).","tags":["selfHosting"],"responses":{"200":{"description":"Email dispatched","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Self-hosting_sendARenderedEmailFromAStandaloneRuntime_Response_200"}}}},"400":{"description":"Invalid request, or a custom sender without a custom email provider key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SendARenderedEmailFromAStandaloneRuntimeRequestBadRequestError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SendARenderedEmailFromAStandaloneRuntimeRequestUnauthorizedError"}}}},"402":{"description":"Platform key spend credit exhausted, or monthly spend limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RuntimeEmailAdmissionError"}}}},"403":{"description":"Not an API key, missing RUNTIME:EXECUTE scope, custom sender on the managed domain, or the account is not on an Enterprise plan (code `BYOC_PLAN_REQUIRED`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RuntimeEmailAdmissionError"}}}},"429":{"description":"Daily execution limit or rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SendARenderedEmailFromAStandaloneRuntimeRequestInternalServerError"}}}},"502":{"description":"Upstream email provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SendARenderedEmailFromAStandaloneRuntimeRequestBadGatewayError"}}}},"503":{"description":"Platform email sending is not configured","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SendARenderedEmailFromAStandaloneRuntimeRequestServiceUnavailableError"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"attachments":{"type":"array","items":{"$ref":"#/components/schemas/V1RuntimeEmailSendPostRequestBodyContentApplicationJsonSchemaAttachmentsItems"}},"bcc":{"type":"array","items":{"type":"string","minLength":1}},"cc":{"type":"array","items":{"type":"string","minLength":1}},"from":{"type":"string"},"html":{"type":"string"},"managedLocalPart":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,64}$","description":"Managed sender local part. Must be an identity the account owns: its user id, `virtual`, or an owned `flow_`/`agent_` id; anything else is refused. Defaults to the caller's user id."},"rawFrom":{"type":"string"},"replyTo":{"type":"string"},"subject":{"type":"string"},"text":{"type":"string"},"to":{"type":"array","items":{"type":"string","minLength":1}}},"required":["subject","to"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/runtime/memory/recall":{"post":{"operationId":"selfHosting_recallMemoriesHostedMemoryStoreRecall","summary":"Recall memories (hosted MemoryStore.recall)","description":"Hosted fulfillment of the runtime MemoryStore seam. Runs the model-backed recall over the authenticated caller's tenant-scoped profile bucket. Requires an Enterprise plan: ineligible accounts receive 403 (code `BYOC_PLAN_REQUIRED`).","tags":["selfHosting"],"responses":{"200":{"description":"Recall result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Self-hosting_recallMemoriesHostedMemoryStoreRecall_Response_200"}}}},"400":{"description":"Invalid request body or unresolvable profile id","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecallMemoriesHostedMemoryStoreRecallRequestBadRequestError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Monthly spend limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"API key lacks an execute permission, or the account is not on an Enterprise plan (code `BYOC_PLAN_REQUIRED`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Daily execution limit or rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Memory operation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecallMemoriesHostedMemoryStoreRecallRequestInternalServerError"}}}},"503":{"description":"The hosted memory service is not available in this environment","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecallMemoriesHostedMemoryStoreRecallRequestServiceUnavailableError"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"options":{"$ref":"#/components/schemas/V1RuntimeMemoryRecallPostRequestBodyContentApplicationJsonSchemaOptions"},"profileId":{"type":"string","minLength":1,"maxLength":256},"query":{"type":"string"}},"required":["profileId","query"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/runtime/memory/save":{"post":{"operationId":"selfHosting_saveAMemoryHostedMemoryStoreRemember","summary":"Save a memory (hosted MemoryStore.remember)","description":"Hosted fulfillment of the runtime MemoryStore seam. Persists one memory into the authenticated caller's tenant-scoped profile bucket. The body profileId is treated as an owner-relative shard key and re-namespaced server-side from the authenticated identity. Requires an Enterprise plan: ineligible accounts receive 403 (code `BYOC_PLAN_REQUIRED`).","tags":["selfHosting"],"responses":{"200":{"description":"The stored memory (dates as ISO-8601 strings)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Self-hosting_saveAMemoryHostedMemoryStoreRemember_Response_200"}}}},"400":{"description":"Invalid request body or unresolvable profile id","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaveAMemoryHostedMemoryStoreRememberRequestBadRequestError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Monthly spend limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"API key lacks an execute permission, or the account is not on an Enterprise plan (code `BYOC_PLAN_REQUIRED`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Daily execution limit or rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Memory operation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaveAMemoryHostedMemoryStoreRememberRequestInternalServerError"}}}},"503":{"description":"The hosted memory service is not available in this environment","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaveAMemoryHostedMemoryStoreRememberRequestServiceUnavailableError"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"memory":{"$ref":"#/components/schemas/V1RuntimeMemorySavePostRequestBodyContentApplicationJsonSchemaMemory"},"profileId":{"type":"string","minLength":1,"maxLength":256}},"required":["memory","profileId"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/runtime/memory/summary":{"post":{"operationId":"selfHosting_summarizeAMemoryProfileHostedMemoryStoreGetSummary","summary":"Summarize a memory profile (hosted MemoryStore.getSummary)","description":"Hosted fulfillment of the runtime MemoryStore seam. Returns the synthesized summary of the authenticated caller's tenant-scoped profile bucket. Requires an Enterprise plan: ineligible accounts receive 403 (code `BYOC_PLAN_REQUIRED`).","tags":["selfHosting"],"responses":{"200":{"description":"Profile summary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Self-hosting_summarizeAMemoryProfileHostedMemoryStoreGetSummary_Response_200"}}}},"400":{"description":"Invalid request body or unresolvable profile id","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SummarizeAMemoryProfileHostedMemoryStoreGetSummaryRequestBadRequestError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Monthly spend limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"API key lacks an execute permission, or the account is not on an Enterprise plan (code `BYOC_PLAN_REQUIRED`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Daily execution limit or rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Memory operation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SummarizeAMemoryProfileHostedMemoryStoreGetSummaryRequestInternalServerError"}}}},"503":{"description":"The hosted memory service is not available in this environment","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SummarizeAMemoryProfileHostedMemoryStoreGetSummaryRequestServiceUnavailableError"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"options":{"$ref":"#/components/schemas/V1RuntimeMemorySummaryPostRequestBodyContentApplicationJsonSchemaOptions"},"profileId":{"type":"string","minLength":1,"maxLength":256}},"required":["profileId"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/runtime/records/get":{"post":{"operationId":"selfHosting_getARecordByIdOrTypeNameHostedRecordStoreGet","summary":"Get a record by id or type+name (hosted RecordStore.get)","description":"Hosted fulfillment of the runtime RecordStore seam. Looks up a single record by `id` OR by `(type, name)`, scoped to the authenticated caller. Returns `{ record: null }` when nothing matches. Requires an Enterprise plan: ineligible accounts receive 403 (code `BYOC_PLAN_REQUIRED`).","tags":["selfHosting"],"responses":{"200":{"description":"The matched record or null","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Self-hosting_getARecordByIdOrTypeNameHostedRecordStoreGet_Response_200"}}}},"400":{"description":"Invalid request body (payload limits, filter compile, identity fields)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetARecordByIdOrTypeNameHostedRecordStoreGetRequestBadRequestError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Monthly spend limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"API key lacks an execute permission, or the account is not on an Enterprise plan (code `BYOC_PLAN_REQUIRED`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Daily execution limit or rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Record operation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetARecordByIdOrTypeNameHostedRecordStoreGetRequestInternalServerError"}}}},"503":{"description":"Database temporarily unavailable; nothing was read or written. Retry after the `Retry-After` interval (seconds).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatabaseUnavailableError"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Self-hosting_getARecordByIdOrTypeNameHostedRecordStoreGet_Request"}}}},"security":[{"BearerAuth":[]}]}},"/v1/runtime/records/query":{"post":{"operationId":"selfHosting_queryRecordsHostedRecordStoreQuery","summary":"Query records (hosted RecordStore.query)","description":"Hosted fulfillment of the runtime RecordStore seam. Returns every record matching the optional `type` / `name` / chip-filter `where`, scoped to the authenticated caller, ordered most-recently-updated first. Requires an Enterprise plan: ineligible accounts receive 403 (code `BYOC_PLAN_REQUIRED`).","tags":["selfHosting"],"responses":{"200":{"description":"The matching records (dates as ISO-8601 strings)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Self-hosting_queryRecordsHostedRecordStoreQuery_Response_200"}}}},"400":{"description":"Invalid request body (payload limits, filter compile, identity fields)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueryRecordsHostedRecordStoreQueryRequestBadRequestError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Monthly spend limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"API key lacks an execute permission, or the account is not on an Enterprise plan (code `BYOC_PLAN_REQUIRED`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Daily execution limit or rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Record operation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueryRecordsHostedRecordStoreQueryRequestInternalServerError"}}}},"503":{"description":"Database temporarily unavailable; nothing was read or written. Retry after the `Retry-After` interval (seconds).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatabaseUnavailableError"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1},"type":{"type":"string","minLength":1},"where":{"$ref":"#/components/schemas/V1RuntimeRecordsQueryPostRequestBodyContentApplicationJsonSchemaWhere"}}}}}},"security":[{"BearerAuth":[]}]}},"/v1/runtime/records/update":{"post":{"operationId":"selfHosting_updateARecordByIdHostedRecordStoreUpdate","summary":"Update a record by id (hosted RecordStore.update)","description":"Hosted fulfillment of the runtime RecordStore seam. Updates an existing record by `id` with the `merge` (shallow) / `replace` / `deep-merge` strategy, scoped to the authenticated caller. Returns `{ record: null }` when no row matched. Requires an Enterprise plan: ineligible accounts receive 403 (code `BYOC_PLAN_REQUIRED`).","tags":["selfHosting"],"responses":{"200":{"description":"The updated record or null","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Self-hosting_updateARecordByIdHostedRecordStoreUpdate_Response_200"}}}},"400":{"description":"Invalid request body (payload limits, filter compile, identity fields)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateARecordByIdHostedRecordStoreUpdateRequestBadRequestError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Monthly spend limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"API key lacks an execute permission, or the account is not on an Enterprise plan (code `BYOC_PLAN_REQUIRED`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Daily execution limit or rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Record operation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateARecordByIdHostedRecordStoreUpdateRequestInternalServerError"}}}},"503":{"description":"Database temporarily unavailable; nothing was read or written. Retry after the `Retry-After` interval (seconds).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatabaseUnavailableError"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","minLength":1},"mergeStrategy":{"$ref":"#/components/schemas/V1RuntimeRecordsUpdatePostRequestBodyContentApplicationJsonSchemaMergeStrategy"},"metadata":{"type":"object","additionalProperties":{"description":"Any type"}}},"required":["id","metadata"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/runtime/records/upsert":{"post":{"operationId":"selfHosting_upsertARecordHostedRecordStoreUpsert","summary":"Upsert a record (hosted RecordStore.upsert)","description":"Hosted fulfillment of the runtime RecordStore seam. Inserts or merges / replaces a record keyed by the authenticated caller's ownership `(org|user, type, name)`. Requires an Enterprise plan: ineligible accounts receive 403 (code `BYOC_PLAN_REQUIRED`).","tags":["selfHosting"],"responses":{"200":{"description":"The stored record + created flag (dates as ISO-8601 strings)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Self-hosting_upsertARecordHostedRecordStoreUpsert_Response_200"}}}},"400":{"description":"Invalid request body (payload limits, filter compile, identity fields)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpsertARecordHostedRecordStoreUpsertRequestBadRequestError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Monthly spend limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"API key lacks an execute permission, or the account is not on an Enterprise plan (code `BYOC_PLAN_REQUIRED`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Daily execution limit or rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Record operation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpsertARecordHostedRecordStoreUpsertRequestInternalServerError"}}}},"503":{"description":"Database temporarily unavailable; nothing was read or written. Retry after the `Retry-After` interval (seconds).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatabaseUnavailableError"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"mergeStrategy":{"$ref":"#/components/schemas/V1RuntimeRecordsUpsertPostRequestBodyContentApplicationJsonSchemaMergeStrategy"},"metadata":{"type":"object","additionalProperties":{"description":"Any type"}},"name":{"type":"string","minLength":1},"type":{"type":"string","minLength":1}},"required":["metadata","name","type"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/runtime/search":{"post":{"operationId":"selfHosting_executeAHostedWebSearchForAStandaloneRuntime","summary":"Execute a hosted web search for a standalone runtime","description":"Hosted fulfillment of the runtime's WebSearcher capability seam. Executes the same search-API provider call the search flow step uses internally (Exa), resolving the search credential api-side (customer key or platform fallback). The credential never appears in the response. Requires an Enterprise plan: ineligible accounts receive 403 (code `BYOC_PLAN_REQUIRED`).","tags":["selfHosting"],"responses":{"200":{"description":"Provider-mapped search results (results + citations + metadata)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Self-hosting_executeAHostedWebSearchForAStandaloneRuntime_Response_200"}}}},"400":{"description":"Invalid request, unsupported provider, or no Exa key available","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Monthly spend limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions, or the account is not on an Enterprise plan (code `BYOC_PLAN_REQUIRED`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Daily execution limit or rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"The search provider call failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"maxResults":{"type":"integer","minimum":1},"options":{"$ref":"#/components/schemas/V1RuntimeSearchPostRequestBodyContentApplicationJsonSchemaOptions"},"provider":{"type":"string","minLength":1,"description":"Search-API provider id. Supported: 'exa'."},"query":{"type":"string","minLength":1}},"required":["provider","query"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/sandbox-deployments":{"get":{"operationId":"sandboxDeployments_listManagedSandboxDeployments","summary":"List managed sandbox deployments","tags":["sandboxDeployments"],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"string"}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Deployments owned by the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Sandbox_Deployments_listManagedSandboxDeployments_Response_200"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Blocked by the organization managed deployment spend budget or credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"412":{"description":"Resource version precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Blocked by credential, source, or profile admission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Organization quota exhausted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]},"post":{"operationId":"sandboxDeployments_createAManagedSandboxDeployment","summary":"Create a managed sandbox deployment","description":"Records durable deployment intent and reserves organization capacity. 202 means the intent and its operation are persisted; readiness and ingress are reported separately.","tags":["sandboxDeployments"],"parameters":[{"name":"idempotency-key","in":"header","description":"Replays the stored response for the same authored body for seven days. Reusing a key with a different body returns 409.","required":false,"schema":{"type":"string"}}],"responses":{"202":{"description":"Deployment intent accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Sandbox_Deployments_createAManagedSandboxDeployment_Response_202"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Blocked by the organization managed deployment spend budget or credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"412":{"description":"Resource version precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Blocked by credential, source, or profile admission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Organization quota exhausted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Sandbox_Deployments_createAManagedSandboxDeployment_Request"}}}},"security":[{"BearerAuth":[]}]}},"/v1/sandbox-deployments/runtime-profiles":{"get":{"operationId":"sandboxDeployments_listRetainedManagedDeploymentRuntimeProfiles","summary":"List retained managed deployment runtime profiles","tags":["sandboxDeployments"],"responses":{"200":{"description":"Catalog support and provider admission; credential and spending checks remain required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Sandbox_Deployments_listRetainedManagedDeploymentRuntimeProfiles_Response_200"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Blocked by the organization managed deployment spend budget or credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"412":{"description":"Resource version precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Blocked by credential, source, or profile admission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Organization quota exhausted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/sandbox-deployments/sources":{"post":{"operationId":"sandboxDeployments_uploadAManagedDeploymentSourceBundle","summary":"Upload a managed deployment source bundle","description":"Streams one gzipped tar of authored source. The body is verified against the declared SHA-256 digest and rejected before storage on any traversal, link, device, duplicate-path, file-count or size violation. Identity is organization + environment + content hash, so re-uploading identical bytes returns the existing manifest.","tags":["sandboxDeployments"],"parameters":[{"name":"environment","in":"query","required":true,"schema":{"$ref":"#/components/schemas/V1SandboxDeploymentsSourcesPostParametersEnvironment"}},{"name":"language","in":"query","required":true,"schema":{"$ref":"#/components/schemas/V1SandboxDeploymentsSourcesPostParametersLanguage"}},{"name":"digest","in":"query","required":true,"schema":{"type":"string","pattern":"^[0-9a-f]{64}$"}}],"responses":{"201":{"description":"Source manifest registered","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Sandbox_Deployments_uploadAManagedDeploymentSourceBundle_Response_201"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Blocked by the organization managed deployment spend budget or credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"412":{"description":"Resource version precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Blocked by credential, source, or profile admission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Organization quota exhausted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Deployment source storage is not configured","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/octet-stream":{"schema":{"type":"string","format":"binary"}}}},"security":[{"BearerAuth":[]}]}},"/v1/sandbox-deployments/{id}":{"get":{"operationId":"sandboxDeployments_getAManagedSandboxDeployment","summary":"Get a managed sandbox deployment","tags":["sandboxDeployments"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Deployment","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Sandbox_Deployments_getAManagedSandboxDeployment_Response_200"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Blocked by the organization managed deployment spend budget or credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"412":{"description":"Resource version precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Blocked by credential, source, or profile admission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Organization quota exhausted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]},"put":{"operationId":"sandboxDeployments_replaceAManagedSandboxDeploymentSpec","summary":"Replace a managed sandbox deployment spec","description":"Requires If-Match against the control-plane resource version. An identical normalized spec returns 200 and writes no new revision; a changed spec returns 202 with a new desired revision.","tags":["sandboxDeployments"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"idempotency-key","in":"header","description":"Replays the stored response for the same authored body for seven days. Reusing a key with a different body returns 409.","required":false,"schema":{"type":"string"}},{"name":"if-match","in":"header","description":"Required for a fresh update: the expected resourceVersion. Missing or stale values return 412. Optional only for a matching Idempotency-Key replay, which returns its stored response before checking this precondition.","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"No change: the normalized desired spec already matches","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Sandbox_Deployments_replaceAManagedSandboxDeploymentSpec_Response_200"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Blocked by the organization managed deployment spend budget or credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"412":{"description":"Resource version precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Blocked by credential, source, or profile admission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Organization quota exhausted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Sandbox_Deployments_replaceAManagedSandboxDeploymentSpec_Request"}}}},"security":[{"BearerAuth":[]}]},"delete":{"operationId":"sandboxDeployments_destroyAManagedSandboxDeployment","summary":"Destroy a managed sandbox deployment","description":"Records terminal intent, revokes future admission, advances the fence and enqueues cleanup. Idempotent retries return the same terminal intent.","tags":["sandboxDeployments"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"idempotency-key","in":"header","description":"Replays the stored response for the same authored body for seven days. Reusing a key with a different body returns 409.","required":false,"schema":{"type":"string"}}],"responses":{"202":{"description":"Terminal intent recorded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Sandbox_Deployments_destroyAManagedSandboxDeployment_Response_202"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Blocked by the organization managed deployment spend budget or credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"412":{"description":"Resource version precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Blocked by credential, source, or profile admission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Organization quota exhausted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/sandbox-deployments/{id}/definition":{"get":{"operationId":"sandboxDeployments_readTheAcceptedDeploymentDefinition","summary":"Read the accepted deployment definition","tags":["sandboxDeployments"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Canonical configuration or explicit advanced-spec readback","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Sandbox_Deployments_readTheAcceptedDeploymentDefinition_Response_200"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Blocked by the organization managed deployment spend budget or credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"412":{"description":"Resource version precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Blocked by credential, source, or profile admission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Organization quota exhausted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/sandbox-deployments/{id}/ingress-credentials":{"get":{"operationId":"sandboxDeployments_listDeploymentIngressCredentials","summary":"List deployment ingress credentials","description":"Returns credential metadata only; no stored value can reconstruct a bearer.","tags":["sandboxDeployments"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Credential metadata","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Sandbox_Deployments_listDeploymentIngressCredentials_Response_200"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Blocked by the organization managed deployment spend budget or credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"412":{"description":"Resource version precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Blocked by credential, source, or profile admission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Organization quota exhausted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]},"post":{"operationId":"sandboxDeployments_issueADeploymentIngressCredential","summary":"Issue a deployment ingress credential","description":"Mints one deployment-scoped, invoke-only bearer for the stable ingress hostname. The credential grants HTTP invocation of this deployment only: it never authorizes mutation, secrets, or logs. The plaintext is returned once.","tags":["sandboxDeployments"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"201":{"description":"Credential issued","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Sandbox_Deployments_issueADeploymentIngressCredential_Response_201"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Blocked by the organization managed deployment spend budget or credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"412":{"description":"Resource version precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Blocked by credential, source, or profile admission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Organization quota exhausted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"displayName":{"type":"string","minLength":1,"maxLength":120},"expiresAt":{"type":"string","format":"date-time"}}}}}},"security":[{"BearerAuth":[]}]}},"/v1/sandbox-deployments/{id}/ingress-credentials/{credentialId}":{"delete":{"operationId":"sandboxDeployments_revokeADeploymentIngressCredential","summary":"Revoke a deployment ingress credential","description":"Idempotent. A revoked credential is refused on the next request it is presented on.","tags":["sandboxDeployments"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"credentialId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Credential revoked","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Sandbox_Deployments_revokeADeploymentIngressCredential_Response_200"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Blocked by the organization managed deployment spend budget or credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"412":{"description":"Resource version precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Blocked by credential, source, or profile admission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Organization quota exhausted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/sandbox-deployments/{id}/ingress-credentials/{credentialId}/rotate":{"post":{"operationId":"sandboxDeployments_rotateADeploymentIngressCredential","summary":"Rotate a deployment ingress credential","description":"Revokes the named credential and issues a replacement in one transaction, so the old value is never live beside the new one. The plaintext is returned once.","tags":["sandboxDeployments"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"credentialId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"201":{"description":"Credential rotated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Sandbox_Deployments_rotateADeploymentIngressCredential_Response_201"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Blocked by the organization managed deployment spend budget or credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"412":{"description":"Resource version precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Blocked by credential, source, or profile admission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Organization quota exhausted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/sandbox-deployments/{id}/operations/{operationId}":{"get":{"operationId":"sandboxDeployments_getOneDeploymentOperation","summary":"Get one deployment operation","tags":["sandboxDeployments"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"operationId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Operation intent","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Sandbox_Deployments_getOneDeploymentOperation_Response_200"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Blocked by the organization managed deployment spend budget or credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"412":{"description":"Resource version precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Blocked by credential, source, or profile admission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Organization quota exhausted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/sandbox-deployments/{id}/renew":{"post":{"operationId":"sandboxDeployments_renewAManagedSandboxDeployment","summary":"Renew a managed sandbox deployment","description":"The only mutation that moves the retention anchor, and only once per Idempotency-Key. Terminal deployments cannot be renewed.","tags":["sandboxDeployments"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"idempotency-key","in":"header","description":"Replays the stored response for the same authored body for seven days. Reusing a key with a different body returns 409.","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"202":{"description":"Renewal accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Sandbox_Deployments_renewAManagedSandboxDeployment_Response_202"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Blocked by the organization managed deployment spend budget or credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"412":{"description":"Resource version precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Blocked by credential, source, or profile admission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Organization quota exhausted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"retention":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdRenewPostRequestBodyContentApplicationJsonSchemaRetention"}},"required":["retention"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/sandbox-deployments/{id}/resume":{"post":{"operationId":"sandboxDeployments_resumeAManagedSandboxDeployment","summary":"Resume a managed sandbox deployment","tags":["sandboxDeployments"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"idempotency-key","in":"header","description":"Replays the stored response for the same authored body for seven days. Reusing a key with a different body returns 409.","required":false,"schema":{"type":"string"}}],"responses":{"202":{"description":"Resumption accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Sandbox_Deployments_resumeAManagedSandboxDeployment_Response_202"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Blocked by the organization managed deployment spend budget or credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"412":{"description":"Resource version precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Blocked by credential, source, or profile admission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Organization quota exhausted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/sandbox-deployments/{id}/suspend":{"post":{"operationId":"sandboxDeployments_suspendAManagedSandboxDeployment","summary":"Suspend a managed sandbox deployment","description":"Stops compute and ingress while retaining the spec. Suspension does not pause expiry.","tags":["sandboxDeployments"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"idempotency-key","in":"header","description":"Replays the stored response for the same authored body for seven days. Reusing a key with a different body returns 409.","required":false,"schema":{"type":"string"}}],"responses":{"202":{"description":"Suspension accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Sandbox_Deployments_suspendAManagedSandboxDeployment_Response_202"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Blocked by the organization managed deployment spend budget or credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"412":{"description":"Resource version precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Blocked by credential, source, or profile admission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Organization quota exhausted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/schedules":{"get":{"operationId":"schedules_listSchedules","summary":"List schedules","description":"Returns a paginated list of schedules for the authenticated user.","tags":["schedules"],"parameters":[{"name":"limit","in":"query","description":"Max results per page (default 50, max 100)","required":false,"schema":{"type":"string"}},{"name":"cursor","in":"query","description":"Pagination cursor","required":false,"schema":{"type":"string"}},{"name":"search","in":"query","description":"Search by name","required":false,"schema":{"type":"string"}},{"name":"status","in":"query","description":"Filter by status","required":false,"schema":{"$ref":"#/components/schemas/V1SchedulesGetParametersStatus"}},{"name":"agentId","in":"query","description":"Only schedules that run this agent","required":false,"schema":{"type":"string"}},{"name":"view","in":"query","description":"Response representation. `full` (default) preserves complete values; `compact` shortens every string value longer than 100 characters to a 100-character preview followed by `…`.","required":false,"schema":{"$ref":"#/components/schemas/V1SchedulesGetParametersView"}}],"responses":{"200":{"description":"List of schedules","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Schedules_listSchedules_Response_200"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]},"post":{"operationId":"schedules_createASchedule","summary":"Create a schedule","description":"Creates a new schedule for recurring or one-time flow/agent execution.","tags":["schedules"],"responses":{"200":{"description":"Schedule created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Schedules_createASchedule_Response_200"}}}},"400":{"description":"Validation error, SCHEDULE_AGENT_CONFIG_UNSUPPORTED for an agent a schedule cannot run, or RUNTIME_LANE_INELIGIBLE for a flow the batch host cannot run","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScheduleValidationError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScheduleEntitlementError"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Target not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"security":[{"BearerAuth":[]}]}},"/v1/schedules/batch/{batchId}/results":{"get":{"operationId":"schedules_getResultsForABatchExecution","summary":"Get results for a batch execution","description":"Returns the per-record results for a batch execution.","tags":["schedules"],"parameters":[{"name":"batchId","in":"path","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"string"}},{"name":"offset","in":"query","required":false,"schema":{"type":"string"}},{"name":"status","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Batch results","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Schedules_getResultsForABatchExecution_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Batch not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/schedules/ensure":{"post":{"operationId":"schedules_ensureScheduleConfigAsCodeConverge","summary":"Ensure schedule (config-as-code converge)","description":"Idempotently converge a repo-defined schedule on a standalone flow or agent. Identity is name + target + account scope; the target may name the flow or agent instead of carrying its id, so one definition works in every environment. Hash-only probes skip the payload in the steady state (a miss is a normal 200 `definitionRequired` response); full requests create the schedule or update it when the canonical content hash differs. Set dryRun to plan without writing (CI drift gate) and onConflict: \"overwrite\" to converge over dashboard/API edits. Omit `enabled` to leave a paused schedule paused. Ensure never deletes; schedules owned by a product surface are never matched.","tags":["schedules"],"responses":{"200":{"description":"Converge result: unchanged | created | updated | definitionRequired (hash miss — retry with the full definition) | plan (dryRun)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScheduleEnsureResponse"}}}},"400":{"description":"Validation error, SCHEDULE_AGENT_CONFIG_UNSUPPORTED for an agent a schedule cannot run, or RUNTIME_LANE_INELIGIBLE for a flow the batch host cannot run","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScheduleValidationError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Plan limit exceeded (cron frequency or active schedule count)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScheduleEntitlementError"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Target not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflict: external_modification (last write was not ensure; pass onConflict: \"overwrite\") or remote_changed (expectedRemoteHash guard)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScheduleEnsureConflict"}}}},"422":{"description":"Submitted contentHash does not match the server-recomputed canonical hash","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScheduleEnsureHashMismatch"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"contentHash":{"type":"string","pattern":"^[0-9a-f]{64}$"},"definition":{"$ref":"#/components/schemas/ScheduleEnsureDefinition"},"dryRun":{"type":"boolean"},"expectedRemoteHash":{"type":"string","pattern":"^[0-9a-f]{64}$"},"name":{"type":"string","minLength":1,"maxLength":255},"onConflict":{"$ref":"#/components/schemas/V1SchedulesEnsurePostRequestBodyContentApplicationJsonSchemaOnConflict"},"target":{"$ref":"#/components/schemas/ScheduleEnsureTarget"}},"required":["name","target"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/schedules/pull":{"get":{"operationId":"schedules_pullScheduleDefinitionConfigAsCode","summary":"Pull schedule definition (config-as-code)","description":"Return the canonical config-as-code definition and provenance for a standalone schedule by name and target — the absorb-drift direction of the ensure protocol. The target is echoed in the form the query used, and the definition always declares `enabled`.","tags":["schedules"],"parameters":[{"name":"name","in":"query","required":true,"schema":{"type":"string","minLength":1}},{"name":"flowId","in":"query","required":false,"schema":{"type":"string"}},{"name":"agentId","in":"query","required":false,"schema":{"type":"string"}},{"name":"flowName","in":"query","required":false,"schema":{"type":"string"}},{"name":"agentName","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Canonical definition + provenance","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SchedulePullResponse"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No schedule with that name on that target in the account scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/schedules/runs/all":{"get":{"operationId":"schedules_listAllScheduleRuns","summary":"List all schedule runs","description":"Returns a paginated list of all runs across the user's schedules.","tags":["schedules"],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"string"}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"}},{"name":"direction","in":"query","required":false,"schema":{"$ref":"#/components/schemas/V1SchedulesRunsAllGetParametersDirection"}}],"responses":{"200":{"description":"All runs","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Schedules_listAllScheduleRuns_Response_200"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/schedules/runs/{runId}/results":{"get":{"operationId":"schedules_getResultsForAScheduledRun","summary":"Get results for a scheduled run","description":"Returns the per-record results for a specific scheduled run.","tags":["schedules"],"parameters":[{"name":"runId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Run results","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Schedules_getResultsForAScheduledRun_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/schedules/sparklines":{"get":{"operationId":"schedules_getScheduleSparklines","summary":"Get schedule sparklines","description":"Returns 7-day run sparkline data for all schedules, grouped by schedule ID and UTC calendar day.","tags":["schedules"],"parameters":[{"name":"ids","in":"query","description":"Comma-separated schedule IDs (max 100)","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sparkline data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Schedules_getScheduleSparklines_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/schedules/{id}":{"get":{"operationId":"schedules_getASchedule","summary":"Get a schedule","description":"Returns the details of a specific schedule.","tags":["schedules"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Schedule details","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Schedules_getASchedule_Response_200"}}}},"400":{"description":"Invalid ID format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]},"put":{"operationId":"schedules_updateASchedule","summary":"Update a schedule","description":"Updates an existing schedule. Supports partial updates.","tags":["schedules"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Schedule updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Schedules_updateASchedule_Response_200"}}}},"400":{"description":"Validation error, SCHEDULE_AGENT_CONFIG_UNSUPPORTED for an agent a schedule cannot run, or RUNTIME_LANE_INELIGIBLE for a flow the batch host cannot run","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScheduleValidationError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScheduleEntitlementError"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"security":[{"BearerAuth":[]}]},"delete":{"operationId":"schedules_deleteASchedule","summary":"Delete a schedule","description":"Permanently deletes a schedule.","tags":["schedules"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Schedule deleted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Schedules_deleteASchedule_Response_200"}}}},"400":{"description":"Invalid ID format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/schedules/{id}/pause":{"post":{"operationId":"schedules_pauseASchedule","summary":"Pause a schedule","description":"Pauses a schedule, preventing future executions until resumed.","tags":["schedules"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Schedule paused","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Schedules_pauseASchedule_Response_200"}}}},"400":{"description":"Invalid ID format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/schedules/{id}/resume":{"post":{"operationId":"schedules_resumeASchedule","summary":"Resume a schedule","description":"Resumes a paused schedule, re-enabling future executions.","tags":["schedules"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Schedule resumed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Schedules_resumeASchedule_Response_200"}}}},"400":{"description":"Invalid ID format, RUNTIME_LANE_INELIGIBLE for a flow target the batch host cannot run, SCHEDULE_AGENT_CONFIG_UNSUPPORTED for an agent a schedule cannot run, or SCHEDULE_ONE_TIME_ELAPSED for a one-time schedule whose runAt has passed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScheduleValidationError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScheduleEntitlementError"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/schedules/{id}/run-now":{"post":{"operationId":"schedules_runAScheduleImmediately","summary":"Run a schedule immediately","description":"Triggers an immediate execution of a schedule, bypassing its normal trigger timing.","tags":["schedules"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Run triggered","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Schedules_runAScheduleImmediately_Response_200"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"The flow uses capabilities the batch host cannot run (RUNTIME_LANE_INELIGIBLE). Nothing is queued and no executions are counted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchLaneRefusalError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/schedules/{id}/runs":{"get":{"operationId":"schedules_listRunsForASchedule","summary":"List runs for a schedule","description":"Returns the run history for a specific schedule, newest first, including batch execution summaries. Returns every run when `limit` and `cursor` are both omitted. Pass `limit` to page: a value above 500 is reduced to 500, and a `cursor` without `limit` reads 500 runs. When `hasMore` is true, pass `nextCursor` back as `cursor` to read older runs.","tags":["schedules"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"string"}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Schedule runs","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Schedules_listRunsForASchedule_Response_200"}}}},"400":{"description":"Invalid ID format, limit, or cursor","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/schedules/{id}/stats":{"get":{"operationId":"schedules_getScheduleStatistics","summary":"Get schedule statistics","description":"Returns statistics for a schedule including success rate, average duration, average cost, and 7-day run history.","tags":["schedules"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Schedule statistics","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Schedules_getScheduleStatistics_Response_200"}}}},"400":{"description":"Invalid ID format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/secrets":{"get":{"operationId":"secrets_listSecretsMetadataOnly","summary":"List secrets (metadata only)","tags":["secrets"],"responses":{"200":{"description":"Secrets list","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Secrets_listSecretsMetadataOnly_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]},"post":{"operationId":"secrets_createASecret","summary":"Create a secret","tags":["secrets"],"responses":{"201":{"description":"Secret created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Secrets_createASecret_Response_201"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateASecretRequestBadRequestError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Duplicate key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalError"}}}},"503":{"description":"Database temporarily unavailable; nothing was read or written. Retry after the `Retry-After` interval (seconds).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatabaseUnavailableError"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"description":{"type":"string","maxLength":500},"docsUrl":{"type":"string","format":"uri","maxLength":2048},"endUserId":{"type":"string","minLength":1,"maxLength":255},"key":{"type":"string","minLength":2,"maxLength":100},"productTenantId":{"type":"string","minLength":1,"maxLength":255},"value":{"type":"string","minLength":8,"maxLength":10000}},"required":["key"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/secrets/check":{"post":{"operationId":"secrets_checkWhichSecretKeysExistAreMissingOrRevoked","summary":"Check which secret keys exist, are missing, or revoked","tags":["secrets"],"responses":{"200":{"description":"Check result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Secrets_checkWhichSecretKeysExistAreMissingOrRevoked_Response_200"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckWhichSecretKeysExistAreMissingOrRevokedRequestBadRequestError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"keys":{"type":"array","items":{"type":"string","minLength":1,"maxLength":100}}},"required":["keys"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/secrets/intake/manifest":{"post":{"operationId":"secrets_getIntakeManifestForSecretConfiguration","summary":"Get intake manifest for secret configuration","tags":["secrets"],"responses":{"200":{"description":"Intake manifest","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Secrets_getIntakeManifestForSecretConfiguration_Response_200"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetIntakeManifestForSecretConfigurationRequestBadRequestError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Product not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"returnUrl":{"type":"string"},"source":{"$ref":"#/components/schemas/V1SecretsIntakeManifestPostRequestBodyContentApplicationJsonSchemaSource"}},"required":["source"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/secrets/intake/submit":{"post":{"operationId":"secrets_submitSecretValuesFromIntakeScreen","summary":"Submit secret values from intake screen","tags":["secrets"],"responses":{"200":{"description":"Submit result with refreshed manifest","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Secrets_submitSecretValuesFromIntakeScreen_Response_200"}}}},"400":{"description":"Validation error or version required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubmitSecretValuesFromIntakeScreenRequestBadRequestError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Version mismatch","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/V1SecretsIntakeSubmitPostRequestBodyContentApplicationJsonSchemaItemsItems"}},"returnUrl":{"type":"string"},"source":{"$ref":"#/components/schemas/V1SecretsIntakeSubmitPostRequestBodyContentApplicationJsonSchemaSource"}},"required":["items","source"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/secrets/setup-url":{"post":{"operationId":"secrets_generateDashboardUrlForConfiguringMissingSecrets","summary":"Generate dashboard URL for configuring missing secrets","tags":["secrets"],"responses":{"200":{"description":"Setup URL result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Secrets_generateDashboardUrlForConfiguringMissingSecrets_Response_200"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenerateDashboardUrlForConfiguringMissingSecretsRequestBadRequestError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"context":{"$ref":"#/components/schemas/V1SecretsSetupUrlPostRequestBodyContentApplicationJsonSchemaContext"},"keys":{"type":"array","items":{"type":"string","minLength":1,"maxLength":100}}},"required":["keys"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/secrets/{id}":{"get":{"operationId":"secrets_getSecretMetadata","summary":"Get secret metadata","tags":["secrets"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Secret detail","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Secrets_getSecretMetadata_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]},"put":{"operationId":"secrets_updateOrRotateASecret","summary":"Update or rotate a secret","tags":["secrets"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Secret updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Secrets_updateOrRotateASecret_Response_200"}}}},"400":{"description":"Validation error or version required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateOrRotateASecretRequestBadRequestError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Version mismatch","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"description":{"type":"string","maxLength":500},"docsUrl":{"type":["string","null"],"format":"uri","maxLength":2048},"expectedVersion":{"type":"integer","minimum":0},"value":{"type":"string","minLength":8,"maxLength":10000}}}}}},"security":[{"BearerAuth":[]}]},"delete":{"operationId":"secrets_deleteASecret","summary":"Delete a secret","tags":["secrets"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Secret deleted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Secrets_deleteASecret_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/signal-bindings":{"get":{"operationId":"signals_listSignalBindings","summary":"List signal bindings","description":"Enabled bindings, newest first, including the implicit failure-detector binding (`implicit: true`); filter by agent or set, or include disabled ones (an opted-out implicit binding is a disabled one).","tags":["signals"],"parameters":[{"name":"agentId","in":"query","required":false,"schema":{"type":"string"}},{"name":"signalSetId","in":"query","required":false,"schema":{"type":"string"}},{"name":"includeDisabled","in":"query","required":false,"schema":{"$ref":"#/components/schemas/V1SignalBindingsGetParametersIncludeDisabled"}}],"responses":{"200":{"description":"Bindings","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Signals_listSignalBindings_Response_200"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignalError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions, or no organization context","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignalError"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignalError"}}}}},"security":[{"BearerAuth":[]}]},"post":{"operationId":"signals_bindASignalSetToAnAgent","summary":"Bind a signal set to an agent","description":"Evaluate a set version on every matching turn of an agent from now on. Its model calls bill to the organization’s usage like any other model call. Refused for an agent with loggingPolicy \"off\" and under zero data retention; an organization handling PHI must pass acknowledgeExternalProcessing.","tags":["signals"],"responses":{"201":{"description":"Bound","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Signals_bindASignalSetToAnAgent_Response_201"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignalError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions, or no organization context","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignalError"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignalError"}}}},"409":{"description":"Conflict, or external processing not yet acknowledged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignalError"}}}},"422":{"description":"Refused: the agent or organization posture forbids signal evaluation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignalError"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"acknowledgeExternalProcessing":{"type":"boolean","description":"Required for a PHI organization whose set uses a decision model outside Cloudflare Workers AI. Written to the audit log."},"budget":{"description":"Ignored. Bindings have no budget; their model calls bill to the organization’s usage.","deprecated":true},"coverage":{"$ref":"#/components/schemas/V1SignalBindingsPostRequestBodyContentApplicationJsonSchemaCoverage"},"filter":{"$ref":"#/components/schemas/V1SignalBindingsPostRequestBodyContentApplicationJsonSchemaFilter"},"signalSetId":{"type":"string"},"target":{"$ref":"#/components/schemas/V1SignalBindingsPostRequestBodyContentApplicationJsonSchemaTarget","description":"Native and external (OTLP) agents bind alike."},"uniformShare":{"type":"number","format":"double","minimum":0,"maximum":1,"description":"Share drawn uniformly at random BEFORE the filter, so live-traffic rates stay unbiased. Default 0.05."},"versionNumber":{"type":"integer","minimum":1,"description":"Defaults to the set’s current version."}},"required":["signalSetId","target"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/signal-bindings/{id}":{"delete":{"operationId":"signals_unbindASignalSet","summary":"Unbind a signal set","description":"Stop evaluating. Existing results stay readable on their traces until those traces expire. Unbinding the implicit failure-detector binding is an opt-out: it is never recreated for that agent.","tags":["signals"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Disabled","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Signals_unbindASignalSet_Response_200"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignalError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions, or no organization context","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignalError"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignalError"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/signal-sets":{"get":{"operationId":"signals_listSignalSets","summary":"List signal sets","description":"The organization's signal sets, newest first, with each one's latest version number.","tags":["signals"],"responses":{"200":{"description":"Signal sets","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Signals_listSignalSets_Response_200"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignalError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions, or no organization context","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignalError"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignalError"}}}}},"security":[{"BearerAuth":[]}]},"post":{"operationId":"signals_createASignalSet","summary":"Create a signal set","description":"Create a signal set and its first version from a preset or a definition. Preview it against recent traces, then bind it to an agent.","tags":["signals"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Signals_createASignalSet_Response_201"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignalError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions, or no organization context","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignalError"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignalError"}}}},"409":{"description":"Conflict, or external processing not yet acknowledged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignalError"}}}},"422":{"description":"Refused: the agent or organization posture forbids signal evaluation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignalError"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"definition":{"type":"object","additionalProperties":{"description":"Any type"},"description":"A signal set version: `{ unit: \"turn\", context: { priorTurns }, signals: { <key>: { type, instructions, options?, notable?, ... } }, bands: { act, review } }`. bool and choice signals go to the decision model; text, number, date, duration, list and estimate go to the extraction model."},"description":{"type":["string","null"],"maxLength":2000},"name":{"type":"string","minLength":1,"maxLength":255},"preset":{"type":"string","description":"Start from a preset, e.g. \"conversation_health\". `definition`, when also given, replaces it."}},"required":["name"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/signal-sets/presets":{"get":{"operationId":"signals_listSignalSetPresets","summary":"List signal set presets","description":"Named starting points for `create_signal_set` (`preset: \"conversation_health\"`), with their full definitions.","tags":["signals"],"responses":{"200":{"description":"Presets","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Signals_listSignalSetPresets_Response_200"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignalError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions, or no organization context","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignalError"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignalError"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/signal-sets/{id}":{"get":{"operationId":"signals_getASignalSet","summary":"Get a signal set","description":"One signal set with every version, newest first, and the current version.","tags":["signals"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Signal set","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Signals_getASignalSet_Response_200"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignalError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions, or no organization context","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignalError"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignalError"}}}}},"security":[{"BearerAuth":[]}]},"delete":{"operationId":"signals_deleteASignalSet","summary":"Delete a signal set","description":"Remove a set from every list and read and free its name. Results and stats already written keep naming it. Refused with SIGNAL_SET_BOUND (details.bindingIds) while any binding is enabled: unbind each first. Built-in sets cannot be deleted.","tags":["signals"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Deleted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Signals_deleteASignalSet_Response_200"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignalError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions, or no organization context","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignalError"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignalError"}}}},"409":{"description":"Still bound, or a built-in set","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignalError"}}}}},"security":[{"BearerAuth":[]}]},"patch":{"operationId":"signals_updateASignalSet","summary":"Update a signal set","description":"Rename or re-describe a set. Its signals change only by publishing a new version.","tags":["signals"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Signals_updateASignalSet_Response_200"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignalError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions, or no organization context","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignalError"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignalError"}}}},"409":{"description":"Conflict, or external processing not yet acknowledged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignalError"}}}},"422":{"description":"Refused: the agent or organization posture forbids signal evaluation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignalError"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"description":{"type":["string","null"],"maxLength":2000},"name":{"type":"string","minLength":1,"maxLength":255}}}}}},"security":[{"BearerAuth":[]}]}},"/v1/signal-sets/{id}/versions":{"post":{"operationId":"signals_publishASignalSetVersion","summary":"Publish a signal set version","description":"Publish a new immutable version and make it current. Existing bindings keep the version they name; rebind to move one.","tags":["signals"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Published","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Signals_publishASignalSetVersion_Response_201"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignalError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions, or no organization context","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignalError"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignalError"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"definition":{"type":"object","additionalProperties":{"description":"Any type"},"description":"A signal set version: `{ unit: \"turn\", context: { priorTurns }, signals: { <key>: { type, instructions, options?, notable?, ... } }, bands: { act, review } }`. bool and choice signals go to the decision model; text, number, date, duration, list and estimate go to the extraction model."}},"required":["definition"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/signal-sets/{id}/versions/{versionNumber}/preview":{"post":{"operationId":"signals_previewASignalSetVersion","summary":"Preview a signal set version","description":"Dry-run one version over an agent’s recent traces: per-signal fire rates, confidences, spans and projected monthly cost. Writes no results; the model calls are billed.","tags":["signals"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"versionNumber","in":"path","required":true,"schema":{"type":"integer","minimum":1}}],"responses":{"200":{"description":"Preview","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignalPreviewReport"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignalError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions, or no organization context","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignalError"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignalError"}}}},"409":{"description":"Conflict, or external processing not yet acknowledged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignalError"}}}},"422":{"description":"Refused: the agent or organization posture forbids signal evaluation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignalError"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"acknowledgeExternalProcessing":{"type":"boolean","description":"Required for a PHI organization whose set uses a decision model outside Cloudflare Workers AI, after a human confirms."},"agentId":{"type":"string","description":"Run the version over this agent’s most recent completed traces."},"limit":{"type":"integer","minimum":1,"maximum":50,"description":"Traces to read, default 20, at most 50."}},"required":["agentId"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/signals/stats":{"get":{"operationId":"signals_signalStats","summary":"Signal stats","description":"Hourly rollup counters summed over the window, by binding, agent version, set version, signal key, value and sample. Rates \"on live traffic\" read sample=uniform only; filtered counters describe the traffic a binding selects. Never add the two.","tags":["signals"],"parameters":[{"name":"agentId","in":"query","required":false,"schema":{"type":"string"}},{"name":"bindingId","in":"query","required":false,"schema":{"type":"string"}},{"name":"signalSetVersionId","in":"query","required":false,"schema":{"type":"string"}},{"name":"sample","in":"query","required":false,"schema":{"$ref":"#/components/schemas/V1SignalsStatsGetParametersSample"}},{"name":"from","in":"query","description":"ISO 8601; defaults to 7 days ago.","required":false,"schema":{"type":"string"}},{"name":"to","in":"query","description":"ISO 8601; defaults to now.","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Stats","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Signals_signalStats_Response_200"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignalError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions, or no organization context","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignalError"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignalError"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/skill-proposals":{"get":{"operationId":"skillProposals_listPendingSkillProposals","summary":"List pending skill proposals","tags":["skillProposals"],"responses":{"200":{"description":"Pending proposals","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Skill_Proposals_listPendingSkillProposals_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/skill-proposals/{id}/approve":{"post":{"operationId":"skillProposals_approveASkillProposal","summary":"Approve a skill proposal","description":"Approve a pending proposal — publishes the proposed skill version.","tags":["skillProposals"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Approved","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Skill_Proposals_approveASkillProposal_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Already reviewed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/skill-proposals/{id}/reject":{"post":{"operationId":"skillProposals_rejectASkillProposal","summary":"Reject a skill proposal","tags":["skillProposals"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Rejected","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Skill_Proposals_rejectASkillProposal_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"reason":{"type":"string"}}}}}},"security":[{"BearerAuth":[]}]}},"/v1/skills":{"get":{"operationId":"skills_listSkills","summary":"List skills","description":"List skills for the authenticated owner with cursor pagination, optionally filtered by status. Ordered newest-first (id descending).","tags":["skills"],"parameters":[{"name":"status","in":"query","required":false,"schema":{"$ref":"#/components/schemas/V1SkillsGetParametersStatus"}},{"name":"limit","in":"query","required":false,"schema":{"type":"string"}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"}},{"name":"direction","in":"query","required":false,"schema":{"type":"string"}},{"name":"includeCount","in":"query","required":false,"schema":{"type":"string"}},{"name":"view","in":"query","description":"Response representation. `full` (default) preserves complete values; `compact` shortens every string value longer than 100 characters to a 100-character preview followed by `…`.","required":false,"schema":{"$ref":"#/components/schemas/V1SkillsGetParametersView"}}],"responses":{"200":{"description":"Paginated list of skills","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Skills_listSkills_Response_200"}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]},"post":{"operationId":"skills_createASkill","summary":"Create a skill","description":"Create a skill from a SKILL.md string (`markdown`) or a structured manifest (`frontmatter` + `body`). Admin plane — no review queue.","tags":["skills"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","additionalProperties":{"description":"Any type"}}}}},"400":{"description":"Invalid manifest, or a manifest name that differs from the skill","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Unsupported capability","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":{"description":"Any type"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/skills/bind":{"post":{"operationId":"skills_bindASkillToAnAgent","summary":"Bind a skill to an agent","tags":["skills"],"responses":{"201":{"description":"Bound","content":{"application/json":{"schema":{"type":"object","additionalProperties":{"description":"Any type"}}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"agentId":{"type":"string"},"displayOrder":{"type":"number","format":"double"},"enabled":{"type":"boolean"},"skillId":{"type":"string"},"skillVersionId":{"type":["string","null"]}},"required":["agentId","skillId"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/skills/bindings":{"get":{"operationId":"skills_listAnAgentsSkillBindings","summary":"List an agent's skill bindings","tags":["skills"],"parameters":[{"name":"agentId","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Bindings","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Skills_listAnAgentsSkillBindings_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/skills/bindings/{bindingId}":{"delete":{"operationId":"skills_unbindASkillFromAnAgent","summary":"Unbind a skill from an agent","tags":["skills"],"parameters":[{"name":"bindingId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Unbound","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Skills_unbindASkillFromAnAgent_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/skills/ensure":{"post":{"operationId":"skills_ensureSkillConfigAsCodeConverge","summary":"Ensure skill (config-as-code converge)","description":"Idempotently converge a repo-defined skill (SKILL.md manifest) onto the platform. Identity is name + account scope. Hash-only probes skip the payload in the steady state (a miss is a normal 200 `definitionRequired` response, not an error); full requests create the skill or append a new version when the canonical content hash differs. The response always carries the server-computed canonical hash + the version id. Set dryRun to plan without writing (CI drift gate), onConflict: \"overwrite\" to converge over dashboard/API edits, and release: \"publish\" to publish the converged version. Optional version.label / version.notes stamp provenance (a git SHA, a release tag) on the appended version row. Admin/control plane only — no review queue.","tags":["skills"],"responses":{"200":{"description":"Converge result: unchanged | created | updated | definitionRequired (hash miss — retry with the full definition) | plan (dryRun)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SkillEnsureResponse"}}}},"400":{"description":"Validation error / invalid manifest","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflict: external_modification (last write was not ensure; pass onConflict: \"overwrite\") or remote_changed (expectedRemoteHash guard)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SkillEnsureConflict"}}}},"422":{"description":"Submitted contentHash does not match the server-recomputed canonical hash (code: content_hash_mismatch), or the manifest carries an unsupported capability such as mcpServers (code: unsupported_capability)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SkillEnsureUnprocessable"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"contentHash":{"type":"string","pattern":"^[0-9a-f]{64}$"},"definition":{"$ref":"#/components/schemas/V1SkillsEnsurePostRequestBodyContentApplicationJsonSchemaDefinition"},"dryRun":{"type":"boolean"},"expectedRemoteHash":{"type":"string","pattern":"^[0-9a-f]{64}$"},"name":{"type":"string","minLength":1},"onConflict":{"$ref":"#/components/schemas/V1SkillsEnsurePostRequestBodyContentApplicationJsonSchemaOnConflict"},"release":{"$ref":"#/components/schemas/V1SkillsEnsurePostRequestBodyContentApplicationJsonSchemaRelease"},"version":{"$ref":"#/components/schemas/EnsureVersionMetadata"}},"required":["name"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/skills/import":{"post":{"operationId":"skills_importASkillMd","summary":"Import a SKILL.md","description":"Import a single SKILL.md document. Lands with trustLevel=imported.","tags":["skills"],"responses":{"201":{"description":"Imported","content":{"application/json":{"schema":{"type":"object","additionalProperties":{"description":"Any type"}}}}},"400":{"description":"Invalid manifest","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Unsupported capability","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"markdown":{"type":"string"}},"required":["markdown"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/skills/propose":{"post":{"operationId":"skills_proposeASkillDeployedAgentDataPlane","summary":"Propose a skill (deployed-agent data plane)","description":"Agent self-authoring endpoint hit by the `propose_skill` runtime tool. Review-by-default; auto-publishes only under the owner-set opt-out. NOT the admin create path.","tags":["skills"],"responses":{"200":{"description":"Proposal outcome","content":{"application/json":{"schema":{"type":"object","additionalProperties":{"description":"Any type"}}}}},"400":{"description":"Invalid manifest","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Unsupported capability","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"body":{"type":"string"},"capabilities":{"type":"object","additionalProperties":{"description":"Any type"}},"description":{"type":"string"},"name":{"type":"string"},"proposingAgentExecutionId":{"type":"string"},"proposingAgentId":{"type":"string"}},"required":["body","description","name","proposingAgentExecutionId","proposingAgentId"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/skills/pull":{"get":{"operationId":"skills_pullSkillDefinitionConfigAsCode","summary":"Pull skill definition (config-as-code)","description":"Return the canonical config-as-code definition and provenance for a skill by name — the absorb-drift direction of the ensure protocol. The contentHash is recomputed from the live skill state, so it is accurate even immediately after a dashboard edit.","tags":["skills"],"parameters":[{"name":"name","in":"query","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Canonical definition + provenance","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SkillPullResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No skill with that name in the account scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/skills/{id}":{"get":{"operationId":"skills_getASkill","summary":"Get a skill","tags":["skills"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Skill","content":{"application/json":{"schema":{"type":"object","additionalProperties":{"description":"Any type"}}}}},"400":{"description":"Invalid id","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]},"put":{"operationId":"skills_appendANewSkillVersion","summary":"Append a new skill version","description":"Append a new draft version to a skill from an updated manifest.","tags":["skills"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"New version","content":{"application/json":{"schema":{"type":"object","additionalProperties":{"description":"Any type"}}}}},"400":{"description":"Invalid manifest","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Unsupported capability","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":{"description":"Any type"}}}}},"security":[{"BearerAuth":[]}]},"delete":{"operationId":"skills_deleteASkill","summary":"Delete a skill","tags":["skills"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Deleted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Skills_deleteASkill_Response_200"}}}},"400":{"description":"Invalid id","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/skills/{id}/bindings":{"get":{"operationId":"skills_listTheAgentsASkillIsBoundTo","summary":"List the agents a skill is bound to","description":"Every binding of this skill, joined with the bound agent's name and type. The by-agent twin (GET /skills/bindings?agentId=) answers the same question from the agent's side. Because the rows name agents, an API key needs AGENTS:READ as well as SKILLS:READ.","tags":["skills"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Bindings","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Skills_listTheAgentsASkillIsBoundTo_Response_200"}}}},"400":{"description":"Invalid id","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/skills/{id}/versions":{"get":{"operationId":"skills_listASkillsVersions","summary":"List a skill's versions","description":"List all versions of a skill, newest first. (The same array is embedded in GET /{id}; this endpoint exposes it standalone for clients that only need the version history.)","tags":["skills"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Versions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Skills_listASkillsVersions_Response_200"}}}},"400":{"description":"Invalid id","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/skills/{id}/versions/{versionId}/publish":{"post":{"operationId":"skills_publishASkillVersion","summary":"Publish a skill version","tags":["skills"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"versionId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Published","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Skills_publishASkillVersion_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/telemetry/ingest-health":{"get":{"operationId":"telemetry_getOtlpIngestHealth","summary":"Inspect OTLP admission, queryability, and durable recovery debt","description":"Owner-scoped delivery receipts retained for 30 days. Lag is acceptance to confirmation (a positive hot receipt read, or a successful raw send), not a production SLO guarantee. Idle is not proof of sink health. No transcripts or retained payloads are returned. Requires ANALYTICS:READ or AGENTS:READ; TELEMETRY:WRITE alone is append-only.","tags":["telemetry"],"parameters":[{"name":"traceId","in":"query","required":false,"schema":{"type":"string","pattern":"^[0-9a-f]{1,32}$"}}],"responses":{"200":{"description":"Admission and observed delivery health","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Telemetry_getOtlpIngestHealth_Response_200"}}}},"400":{"description":"Invalid trace identity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Read scope required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Health state temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/tool-approval-grants":{"get":{"operationId":"toolApprovalGrants_listRememberedToolApprovalGrants","summary":"List remembered tool-approval grants","description":"List the authenticated owner's active cross-session \"Always allow\" grants. Optionally filter to a single agent with ?agentId=. A null endUserRef is an account-level grant.","tags":["toolApprovalGrants"],"parameters":[{"name":"agentId","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Active grants","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Tool_Approval_Grants_listRememberedToolApprovalGrants_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/tool-approval-grants/{id}":{"delete":{"operationId":"toolApprovalGrants_revokeARememberedToolApprovalGrant","summary":"Revoke a remembered tool-approval grant","description":"Revoke (soft-delete) a grant so the tool prompts for approval again on future dispatches. Ownership-scoped.","tags":["toolApprovalGrants"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Revoked","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Tool_Approval_Grants_revokeARememberedToolApprovalGrant_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Grant not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/tools":{"get":{"operationId":"tools_listTools","summary":"List tools","description":"Get all tools for the authenticated user with filtering and cursor pagination.","tags":["tools"],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"string"}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"}},{"name":"direction","in":"query","required":false,"schema":{"type":"string"}},{"name":"includeCount","in":"query","required":false,"schema":{"type":"string"}},{"name":"distinct","in":"query","required":false,"schema":{"type":"string"}},{"name":"tool_type","in":"query","required":false,"schema":{"type":"string"}},{"name":"search","in":"query","required":false,"schema":{"type":"string"}},{"name":"isActive","in":"query","required":false,"schema":{"type":"string"}},{"name":"ids","in":"query","required":false,"schema":{"type":"string"}},{"name":"include","in":"query","required":false,"schema":{"type":"string"}},{"name":"view","in":"query","description":"Response representation. `full` (default) preserves complete values; `compact` shortens every string value longer than 100 characters to a 100-character preview followed by `…`.","required":false,"schema":{"$ref":"#/components/schemas/V1ToolsGetParametersView"}}],"responses":{"200":{"description":"Paginated list of tools","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Tools_listTools_Response_200"}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]},"post":{"operationId":"tools_createTool","summary":"Create tool","description":"Create a new tool definition.","tags":["tools"],"responses":{"200":{"description":"Created tool","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Tools_createTool_Response_200"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"config":{"type":"object","additionalProperties":{"description":"Any type"}},"description":{"type":"string","minLength":1,"maxLength":500},"name":{"type":"string","minLength":1,"maxLength":100},"parametersSchema":{"type":"object","additionalProperties":{"description":"Any type"}},"toolType":{"$ref":"#/components/schemas/V1ToolsPostRequestBodyContentApplicationJsonSchemaToolType"}},"required":["config","description","name","parametersSchema","toolType"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/tools/builtin":{"get":{"operationId":"tools_listBuiltInTools","summary":"List built-in tools","description":"List built-in tools available for prompt and agent tool configuration.","tags":["tools"],"responses":{"200":{"description":"Built-in tools","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Tools_listBuiltInTools_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/tools/builtin/compatible":{"get":{"operationId":"tools_listCompatibleBuiltInTools","summary":"List compatible built-in tools","description":"List built-in tools compatible with a specific model and provider.","tags":["tools"],"parameters":[{"name":"model","in":"query","required":true,"schema":{"type":"string"}},{"name":"provider","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Compatible built-in tools","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Tools_listCompatibleBuiltInTools_Response_200"}}}},"400":{"description":"Missing or invalid query parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/tools/builtin/{toolId}/schema":{"get":{"operationId":"tools_getBuiltInToolSchema","summary":"Get built-in tool schema","description":"Get the parameter schema and default configuration for a specific built-in tool.","tags":["tools"],"parameters":[{"name":"toolId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Built-in tool parameter schema","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Tools_getBuiltInToolSchema_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Built-in tool not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/tools/ensure":{"post":{"operationId":"tools_ensureToolConfigAsCodeConverge","summary":"Ensure tool (config-as-code converge)","description":"Idempotently converge a repo-defined tool definition onto the platform. Identity is name + account scope. Hash-only probes skip the payload in the steady state (a miss is a normal 200 `definitionRequired` response, not an error); full requests create the tool or update it when the canonical content hash differs. The response always carries the server-computed canonical hash. Set dryRun to plan without writing (CI drift gate), and onConflict: \"overwrite\" to converge over dashboard/API edits. Tools have no version snapshots, so there is no publish option.","tags":["tools"],"responses":{"200":{"description":"Converge result: unchanged | created | updated | definitionRequired (hash miss — retry with the full definition) | plan (dryRun)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ToolEnsureResponse"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflict: external_modification (last write was not ensure; pass onConflict: \"overwrite\") or remote_changed (expectedRemoteHash guard)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ToolEnsureConflict"}}}},"422":{"description":"Submitted contentHash does not match the server-recomputed canonical hash","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ToolEnsureHashMismatch"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"contentHash":{"type":"string","pattern":"^[0-9a-f]{64}$"},"definition":{"$ref":"#/components/schemas/V1ToolsEnsurePostRequestBodyContentApplicationJsonSchemaDefinition"},"dryRun":{"type":"boolean"},"expectedRemoteHash":{"type":"string","pattern":"^[0-9a-f]{64}$"},"name":{"type":"string","minLength":1},"onConflict":{"$ref":"#/components/schemas/V1ToolsEnsurePostRequestBodyContentApplicationJsonSchemaOnConflict"}},"required":["name"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/tools/flows/{flowId}/convert-to-tool":{"post":{"operationId":"tools_convertFlowToTool","summary":"Convert flow to tool","description":"Create a flow-type tool from an existing flow, generating its parameters schema from the flow steps.","tags":["tools"],"parameters":[{"name":"flowId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Created tool","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Tools_convertFlowToTool_Response_200"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Flow not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":{"description":"Any type"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/tools/pull":{"get":{"operationId":"tools_pullToolDefinitionConfigAsCode","summary":"Pull tool definition (config-as-code)","description":"Return the canonical config-as-code definition and provenance for a tool by name — the absorb-drift direction of the ensure protocol. The contentHash is recomputed from the live tool state, so it is accurate even immediately after a dashboard edit.","tags":["tools"],"parameters":[{"name":"name","in":"query","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Canonical definition + provenance","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ToolPullResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No tool with that name in the account scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/tools/sandbox/cf-sandbox/deploy":{"post":{"operationId":"tools_deployRuntypeSandbox","summary":"Deploy Runtype Sandbox","description":"Deploy a session-tier Runtype Sandbox preview. The preview URL is the credential and is bound to the container epoch: a new container mints a new URL, reported by effectivePolicy.freshContainer and previewUrlChanged. Omitted retention preserves unlimited retention; explicit retention is metered and rollout-gated, and the preview is refused from the retention deadline on. sleepPolicy { mode: \"never\" } keeps the container running until that deadline and requires retention of 10m, 1h or 24h. A redeploy stops the previous server first and fails if the new server never answers on the port.","tags":["tools"],"responses":{"200":{"description":"Sandbox deployment result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Tools_deployRuntypeSandbox_Response_200"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Sandbox lifecycle enrollment conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalError"}}}},"503":{"description":"Database temporarily unavailable; nothing was read or written. Retry after the `Retry-After` interval (seconds).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatabaseUnavailableError"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","minLength":1},"files":{"type":"object","additionalProperties":{"type":"string"}},"language":{"$ref":"#/components/schemas/V1ToolsSandboxCfSandboxDeployPostRequestBodyContentApplicationJsonSchemaLanguage"},"managed":{"type":"boolean"},"packageJson":{"type":"string"},"port":{"type":"integer","minimum":1,"maximum":65535},"retention":{"$ref":"#/components/schemas/V1ToolsSandboxCfSandboxDeployPostRequestBodyContentApplicationJsonSchemaRetention"},"sandboxId":{"type":"string","minLength":1},"sleepPolicy":{"$ref":"#/components/schemas/V1ToolsSandboxCfSandboxDeployPostRequestBodyContentApplicationJsonSchemaSleepPolicy"},"startCommand":{"type":"string"}},"required":["code"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/tools/sandbox/cf-sandbox/{sandboxId}":{"delete":{"operationId":"tools_cleanupRuntypeSandbox","summary":"Cleanup Runtype Sandbox","description":"Cleanup a deployed Runtype Sandbox container.","tags":["tools"],"parameters":[{"name":"sandboxId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sandbox cleaned up","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Tools_cleanupRuntypeSandbox_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/tools/sandbox/deploy":{"post":{"operationId":"tools_deployDaytonaSandbox","summary":"Deploy Daytona sandbox","description":"Deploy a live Daytona preview. Retention defaults to 10m; provider sleep or deletion can end availability earlier. Preview URLs are not durable hosting.","tags":["tools"],"responses":{"200":{"description":"Sandbox deployment result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Tools_deployDaytonaSandbox_Response_200"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Sandbox not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Sandbox metering unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"autoDeleteInterval":{"type":"integer","minimum":-1},"autoStopInterval":{"type":"integer","minimum":0},"code":{"type":"string","minLength":1},"files":{"type":"object","additionalProperties":{"type":"string"}},"labels":{"type":"object","additionalProperties":{"type":"string"}},"language":{"$ref":"#/components/schemas/V1ToolsSandboxDeployPostRequestBodyContentApplicationJsonSchemaLanguage"},"managed":{"type":"boolean"},"packageJson":{"type":"string"},"port":{"type":"integer","minimum":1,"maximum":65535},"retention":{"$ref":"#/components/schemas/V1ToolsSandboxDeployPostRequestBodyContentApplicationJsonSchemaRetention"},"sandboxId":{"type":"string","minLength":1},"sleepPolicy":{"$ref":"#/components/schemas/V1ToolsSandboxDeployPostRequestBodyContentApplicationJsonSchemaSleepPolicy"},"startCommand":{"type":"string"}},"required":["code"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/tools/sandbox/{sandboxId}":{"delete":{"operationId":"tools_cleanupDaytonaSandbox","summary":"Cleanup Daytona sandbox","description":"Cleanup a deployed Daytona sandbox.","tags":["tools"],"parameters":[{"name":"sandboxId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sandbox cleaned up","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Tools_cleanupDaytonaSandbox_Response_200"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Sandbox not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/tools/schema":{"get":{"operationId":"tools_getToolSchemas","summary":"Get tool schemas","description":"Get active saved tool definitions in an AI SDK compatible discovery format.","tags":["tools"],"parameters":[{"name":"toolIds","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Tool discovery payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Tools_getToolSchemas_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/tools/{id}":{"get":{"operationId":"tools_getToolDetails","summary":"Get tool details","description":"Get a tool by ID including its full configuration.","tags":["tools"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Tool details","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Tools_getToolDetails_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Tool not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]},"put":{"operationId":"tools_updateTool","summary":"Update tool","description":"Update fields on an existing tool.","tags":["tools"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Updated tool","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Tools_updateTool_Response_200"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Tool not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"config":{"type":"object","additionalProperties":{"description":"Any type"}},"description":{"type":"string","minLength":1,"maxLength":5000},"isActive":{"type":"boolean"},"name":{"type":"string","minLength":1,"maxLength":100},"parametersSchema":{"type":"object","additionalProperties":{"description":"Any type"}}}}}}},"security":[{"BearerAuth":[]}]},"delete":{"operationId":"tools_deleteTool","summary":"Delete tool","description":"Delete a tool by ID.","tags":["tools"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Tool deleted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Tools_deleteTool_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Tool not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/tools/{id}/execute":{"post":{"operationId":"tools_executeTool","summary":"Execute tool","description":"Execute a tool by ID with the provided parameters. Non-flow tools return the documented JSON result. Flow tools return a text/event-stream response whose frames use the ExecutionStreamEvent vocabulary; use a raw/streaming client helper for flow tools.","tags":["tools"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Tool execution result: BuiltinToolExecuteResult for a builtin: or platform: id, ExecuteToolResult for a saved non-flow tool, an SSE stream for a flow tool","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Tools_executeTool_Response_200"}}}},"400":{"description":"Invalid request, tool config, or judgment input","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ToolExecuteError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Tool not found, or a judgment question set that does not resolve","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ToolExecuteError"}}}},"422":{"description":"A judgment the gateway cannot serve (an unlisted model or no gateway credential), or a tool that templates `{{_identity.token}}`, which a management-API execute has no admitted end user to mint","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ToolExecuteError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"context":{"$ref":"#/components/schemas/V1ToolsIdExecutePostRequestBodyContentApplicationJsonSchemaContext"},"parameters":{"type":"object","additionalProperties":{"description":"Any type"}},"toolConfig":{"type":"object","additionalProperties":{"description":"Any type"},"description":"Built-in tools only: the instance config an agent's toolConfigs entry would carry, validated against the tool's configSchema. Rejected for a saved tool."},"toolId":{"type":"string"}},"required":["parameters"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/tools/{id}/test":{"post":{"operationId":"tools_testTool","summary":"Test tool","description":"Test a tool with sample parameters by forwarding to the execute endpoint.","tags":["tools"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Tool execution result, forwarded from the execute endpoint","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Tools_testTool_Response_200"}}}},"400":{"description":"Invalid request, tool config, or judgment input","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ToolExecuteError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Tool not found, or a judgment question set that does not resolve","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ToolExecuteError"}}}},"422":{"description":"A judgment the gateway cannot serve (an unlisted model or no gateway credential), or a tool that templates `{{_identity.token}}`, which a management-API execute has no admitted end user to mint","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ToolExecuteError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":{"description":"Any type"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/usage-limits":{"get":{"operationId":"usageLimits_getUsageStatistics","summary":"Get usage statistics","description":"Get usage statistics for the authenticated user. Returns V3 execution stats with backward-compatible token-style fields. Token usage is tracked via Analytics Engine.","tags":["usageLimits"],"responses":{"200":{"description":"Usage statistics","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UsageResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalError"}}}},"503":{"description":"Database temporarily unavailable; nothing was read or written. Retry after the `Retry-After` interval (seconds).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatabaseUnavailableError"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/usage-limits/daily":{"get":{"operationId":"usageLimits_getDailyExecutionUsage","summary":"Get daily execution usage","description":"Get current daily execution statistics for the authenticated user/organization. Used by the dashboard to display daily execution usage and limits.","tags":["usageLimits"],"responses":{"200":{"description":"Daily (or monthly) execution usage statistics","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DailyUsageResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalError"}}}},"503":{"description":"Database temporarily unavailable; nothing was read or written. Retry after the `Retry-After` interval (seconds).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatabaseUnavailableError"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/users/onboarding/complete":{"post":{"operationId":"users_completeOnboarding","summary":"Complete onboarding","description":"Mark onboarding as completed for the authenticated user (dashboard only).","tags":["users"],"responses":{"200":{"description":"Onboarding completion state","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Users_completeOnboarding_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/users/onboarding/intent":{"post":{"operationId":"users_setOnboardingIntent","summary":"Set onboarding intent","description":"Record what the authenticated user came to Runtype to do (dashboard only). Readable afterwards on GET /v1/auth/me.","tags":["users"],"responses":{"200":{"description":"Stored onboarding intent","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Users_setOnboardingIntent_Response_200"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"onboardingIntent":{"$ref":"#/components/schemas/V1UsersOnboardingIntentPostRequestBodyContentApplicationJsonSchemaOnboardingIntent"}},"required":["onboardingIntent"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/users/onboarding/reset":{"post":{"operationId":"users_resetOnboarding","summary":"Reset onboarding","description":"Clear the onboarding completed status for the authenticated user (dashboard only).","tags":["users"],"responses":{"200":{"description":"Onboarding completion state","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Users_resetOnboarding_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/users/profile":{"get":{"operationId":"users_getUserProfile","summary":"Get user profile","description":"Get the profile of the authenticated user.","tags":["users"],"responses":{"200":{"description":"User profile","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Users_getUserProfile_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]},"put":{"operationId":"users_updateUserProfile","summary":"Update user profile","description":"Update the profile of the authenticated user (dashboard only).","tags":["users"],"responses":{"200":{"description":"Updated user profile","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateUserProfileResponse"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string","format":"email"},"firstName":{"type":"string","minLength":1},"lastName":{"type":"string","minLength":1},"preferences":{"$ref":"#/components/schemas/V1UsersProfilePutRequestBodyContentApplicationJsonSchemaPreferences"}}}}}},"security":[{"BearerAuth":[]}]}},"/v1/users/stats":{"get":{"operationId":"users_getUserStatistics","summary":"Get user statistics","description":"Get usage statistics for the authenticated user.","tags":["users"],"responses":{"200":{"description":"User statistics","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Users_getUserStatistics_Response_200"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/validate/liquid-template":{"post":{"operationId":"validation_validateLiquidTemplate","summary":"Validate Liquid template","description":"Lightweight per-keystroke Liquid template validator for the dashboard template step editor.","tags":["validation"],"responses":{"200":{"description":"Validation result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Validation_validateLiquidTemplate_Response_200"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Template too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalError"}}}},"503":{"description":"Database temporarily unavailable; nothing was read or written. Retry after the `Retry-After` interval (seconds).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatabaseUnavailableError"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"inputs":{"type":"object","additionalProperties":{"type":"string"},"description":"Template input variables"},"partials":{"type":"object","additionalProperties":{"type":"string"},"description":"Template partials"},"template":{"type":"string","minLength":1,"description":"Liquid template string to validate"}},"required":["template"]}}}},"security":[{"BearerAuth":[]}]}},"/v1/validate/transform-code":{"post":{"operationId":"validation_validateTransformCode","summary":"Validate transform code","description":"Lightweight per-keystroke code validator for the dashboard transform-data step editor.","tags":["validation"],"responses":{"200":{"description":"Validation result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Validation_validateTransformCode_Response_200"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Code too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalError"}}}},"503":{"description":"Database temporarily unavailable; nothing was read or written. Retry after the `Retry-After` interval (seconds).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatabaseUnavailableError"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"availableVariables":{"type":"array","items":{"type":"string"},"description":"List of available variable names"},"code":{"type":"string","minLength":1,"description":"JavaScript code to validate"},"language":{"type":"string","description":"Code language (default: javascript)"},"sandboxProvider":{"type":"string","description":"Sandbox provider (default: cloudflare-worker)"}},"required":["code"]}}}},"security":[{"BearerAuth":[]}]}}},"tags":[{"name":"identityIntegrations"},{"name":"agentAliases"},{"name":"agentFeedback"},{"name":"agentVersions"},{"name":"agents"},{"name":"analytics"},{"name":"assets"},{"name":"authentication"},{"name":"batch"},{"name":"clientTokens"},{"name":"clientRuntime"},{"name":"collections"},{"name":"contextTemplates"},{"name":"conversations"},{"name":"dataConnections"},{"name":"decisionModels"},{"name":"delegateTasks"},{"name":"devices"},{"name":"dispatch"},{"name":"documentation"},{"name":"endUserAuth"},{"name":"endUserIntegrations"},{"name":"evals"},{"name":"events"},{"name":"executions"},{"name":"extractionModels"},{"name":"feedback"},{"name":"flowSteps"},{"name":"flowVersions"},{"name":"flows"},{"name":"integrationConfigs"},{"name":"integrations"},{"name":"logs"},{"name":"messagingConversations"},{"name":"emailImap"},{"name":"messagingValidations"},{"name":"modelConfigs"},{"name":"modelUsage"},{"name":"products"},{"name":"webhookManagement"},{"name":"a2A"},{"name":"surfaces"},{"name":"productMcp"},{"name":"prompts"},{"name":"providerKeys"},{"name":"providerStatus"},{"name":"flowValidation"},{"name":"productValidation"},{"name":"questionSets"},{"name":"records"},{"name":"resources"},{"name":"runs"},{"name":"selfHosting"},{"name":"sandboxDeployments"},{"name":"schedules"},{"name":"secrets"},{"name":"signals"},{"name":"skillProposals"},{"name":"skills"},{"name":"telemetry"},{"name":"toolApprovalGrants"},{"name":"tools"},{"name":"usageLimits"},{"name":"users"},{"name":"validation"}],"servers":[{"url":"https://api.runtype.com","description":"Production"},{"url":"https://api.runtype-staging.com","description":"Staging"}],"components":{"schemas":{"IdentityAssertionPublicJwk":{"type":"object","properties":{"alg":{"type":"string","description":"Always `ES256`."},"crv":{"type":"string","description":"Curve; always `P-256`."},"kid":{"type":"string","description":"Key id, matched against the token header `kid`."},"kty":{"type":"string","description":"Key type; always `EC`."},"use":{"type":"string","description":"Always `sig`."},"x":{"type":"string"},"y":{"type":"string"}},"required":["alg","crv","kid","kty","use","x","y"],"title":"IdentityAssertionPublicJwk"},"IdentityAssertionJwks":{"type":"object","properties":{"keys":{"type":"array","items":{"$ref":"#/components/schemas/IdentityAssertionPublicJwk"},"description":"Every key that may have signed a live assertion: the active key first, then verify-only keys kept for rotation."}},"required":["keys"],"title":"IdentityAssertionJwks"},"AgentIssuerMetadata":{"type":"object","properties":{"grant_types_supported":{"type":"array","items":{"type":"string"}},"issuer":{"type":"string","description":"`<API origin>/orgs/<organizationId>/agents`, matching this document URL."},"jwks_uri":{"type":"string"},"response_types_supported":{"type":"array","items":{"type":"string"}},"service_documentation":{"type":"string"},"token_endpoint":{"type":"string"},"token_endpoint_auth_methods_supported":{"type":"array","items":{"type":"string"}},"token_endpoint_auth_signing_alg_values_supported":{"type":"array","items":{"type":"string"}}},"required":["grant_types_supported","issuer","jwks_uri","response_types_supported","service_documentation","token_endpoint","token_endpoint_auth_methods_supported","token_endpoint_auth_signing_alg_values_supported"],"title":"AgentIssuerMetadata"},"V1IdentityIntegrationsGetResponsesContentApplicationJsonSchemaIdentityIntegrationsItemsConfiguredCredentialsItems":{"type":"string","enum":["clientSecret","managementApiKey"],"title":"V1IdentityIntegrationsGetResponsesContentApplicationJsonSchemaIdentityIntegrationsItemsConfiguredCredentialsItems"},"V1IdentityIntegrationsGetResponsesContentApplicationJsonSchemaIdentityIntegrationsItemsKind":{"type":"string","enum":["oidc-jwt","session","custom"],"title":"V1IdentityIntegrationsGetResponsesContentApplicationJsonSchemaIdentityIntegrationsItemsKind"},"V1IdentityIntegrationsGetResponsesContentApplicationJsonSchemaIdentityIntegrationsItemsStatus":{"type":"string","enum":["active","disabled"],"title":"V1IdentityIntegrationsGetResponsesContentApplicationJsonSchemaIdentityIntegrationsItemsStatus"},"V1IdentityIntegrationsGetResponsesContentApplicationJsonSchemaIdentityIntegrationsItems":{"type":"object","properties":{"configuredCredentials":{"type":"array","items":{"$ref":"#/components/schemas/V1IdentityIntegrationsGetResponsesContentApplicationJsonSchemaIdentityIntegrationsItemsConfiguredCredentialsItems"}},"createdAt":{"type":"string"},"descriptor":{"type":"object","additionalProperties":{"description":"Any type"}},"id":{"type":"string"},"issuer":{"type":["string","null"]},"kind":{"$ref":"#/components/schemas/V1IdentityIntegrationsGetResponsesContentApplicationJsonSchemaIdentityIntegrationsItemsKind"},"name":{"type":"string"},"provider":{"type":"string"},"status":{"$ref":"#/components/schemas/V1IdentityIntegrationsGetResponsesContentApplicationJsonSchemaIdentityIntegrationsItemsStatus"},"updatedAt":{"type":"string"}},"required":["configuredCredentials","createdAt","descriptor","id","issuer","kind","name","provider","status","updatedAt"],"title":"V1IdentityIntegrationsGetResponsesContentApplicationJsonSchemaIdentityIntegrationsItems"},"Identity_Integrations_listIdentityIntegrations_Response_200":{"type":"object","properties":{"identityIntegrations":{"type":"array","items":{"$ref":"#/components/schemas/V1IdentityIntegrationsGetResponsesContentApplicationJsonSchemaIdentityIntegrationsItems"}}},"required":["identityIntegrations"],"title":"Identity Integrations_listIdentityIntegrations_Response_200"},"ErrorDetailsItems":{"type":"object","properties":{"code":{"type":"string","description":"Stable Runtype validation code (e.g. MISSING_REQUIRED_FIELD, INVALID_ENUM)."},"message":{"type":"string"},"path":{"type":"string","description":"Dotted JSON path to the offending field."},"suggestion":{"type":"string","description":"Actionable hint (allowed values, accepted range, …)."}},"required":["message"],"title":"ErrorDetailsItems"},"Error":{"type":"object","properties":{"code":{"type":"string","description":"Stable error code. `insufficient_scope` marks an API key that lacks a scope this request needs."},"details":{"type":"array","items":{"$ref":"#/components/schemas/ErrorDetailsItems"}},"error":{"type":"string"},"requiredScopes":{"type":"array","items":{"type":"string"},"description":"On `insufficient_scope`: every API key scope this request needs."}},"required":["error"],"title":"Error"},"V1IdentityIntegrationsPostRequestBodyContentApplicationJsonSchemaCredentials":{"type":"object","properties":{"clientSecret":{"type":["string","null"],"minLength":1},"managementApiKey":{"type":["string","null"],"minLength":1}},"description":"Provider management/client credentials. Sealed at rest, bound to this integration, and never returned by any endpoint. Set a field to rotate it; null clears it.","title":"V1IdentityIntegrationsPostRequestBodyContentApplicationJsonSchemaCredentials"},"V1IdentityIntegrationsPostRequestBodyContentApplicationJsonSchemaProvider":{"type":"string","enum":["clerk","workos","auth0","okta","better-auth","oidc","custom"],"title":"V1IdentityIntegrationsPostRequestBodyContentApplicationJsonSchemaProvider"},"V1IdentityIntegrationsPostResponsesContentApplicationJsonSchemaConfiguredCredentialsItems":{"type":"string","enum":["clientSecret","managementApiKey"],"title":"V1IdentityIntegrationsPostResponsesContentApplicationJsonSchemaConfiguredCredentialsItems"},"V1IdentityIntegrationsPostResponsesContentApplicationJsonSchemaKind":{"type":"string","enum":["oidc-jwt","session","custom"],"title":"V1IdentityIntegrationsPostResponsesContentApplicationJsonSchemaKind"},"V1IdentityIntegrationsPostResponsesContentApplicationJsonSchemaStatus":{"type":"string","enum":["active","disabled"],"title":"V1IdentityIntegrationsPostResponsesContentApplicationJsonSchemaStatus"},"Identity_Integrations_createAnIdentityIntegration_Response_201":{"type":"object","properties":{"configuredCredentials":{"type":"array","items":{"$ref":"#/components/schemas/V1IdentityIntegrationsPostResponsesContentApplicationJsonSchemaConfiguredCredentialsItems"}},"createdAt":{"type":"string"},"descriptor":{"type":"object","additionalProperties":{"description":"Any type"}},"id":{"type":"string"},"issuer":{"type":["string","null"]},"kind":{"$ref":"#/components/schemas/V1IdentityIntegrationsPostResponsesContentApplicationJsonSchemaKind"},"name":{"type":"string"},"provider":{"type":"string"},"status":{"$ref":"#/components/schemas/V1IdentityIntegrationsPostResponsesContentApplicationJsonSchemaStatus"},"updatedAt":{"type":"string"}},"required":["configuredCredentials","createdAt","descriptor","id","issuer","kind","name","provider","status","updatedAt"],"title":"Identity Integrations_createAnIdentityIntegration_Response_201"},"V1IdentityIntegrationsPostResponsesContentApplicationJsonSchemaIssuesItems":{"type":"object","properties":{"message":{"type":"string"},"path":{"type":"string"}},"required":["message","path"],"title":"V1IdentityIntegrationsPostResponsesContentApplicationJsonSchemaIssuesItems"},"CreateAnIdentityIntegrationRequestBadRequestError":{"type":"object","properties":{"error":{"type":"string"},"issues":{"type":"array","items":{"$ref":"#/components/schemas/V1IdentityIntegrationsPostResponsesContentApplicationJsonSchemaIssuesItems"}}},"required":["error"],"title":"CreateAnIdentityIntegrationRequestBadRequestError"},"V1IdentityIntegrationsIdGetResponsesContentApplicationJsonSchemaConfiguredCredentialsItems":{"type":"string","enum":["clientSecret","managementApiKey"],"title":"V1IdentityIntegrationsIdGetResponsesContentApplicationJsonSchemaConfiguredCredentialsItems"},"V1IdentityIntegrationsIdGetResponsesContentApplicationJsonSchemaKind":{"type":"string","enum":["oidc-jwt","session","custom"],"title":"V1IdentityIntegrationsIdGetResponsesContentApplicationJsonSchemaKind"},"V1IdentityIntegrationsIdGetResponsesContentApplicationJsonSchemaStatus":{"type":"string","enum":["active","disabled"],"title":"V1IdentityIntegrationsIdGetResponsesContentApplicationJsonSchemaStatus"},"Identity_Integrations_getAnIdentityIntegration_Response_200":{"type":"object","properties":{"configuredCredentials":{"type":"array","items":{"$ref":"#/components/schemas/V1IdentityIntegrationsIdGetResponsesContentApplicationJsonSchemaConfiguredCredentialsItems"}},"createdAt":{"type":"string"},"descriptor":{"type":"object","additionalProperties":{"description":"Any type"}},"id":{"type":"string"},"issuer":{"type":["string","null"]},"kind":{"$ref":"#/components/schemas/V1IdentityIntegrationsIdGetResponsesContentApplicationJsonSchemaKind"},"name":{"type":"string"},"provider":{"type":"string"},"status":{"$ref":"#/components/schemas/V1IdentityIntegrationsIdGetResponsesContentApplicationJsonSchemaStatus"},"updatedAt":{"type":"string"}},"required":["configuredCredentials","createdAt","descriptor","id","issuer","kind","name","provider","status","updatedAt"],"title":"Identity Integrations_getAnIdentityIntegration_Response_200"},"Identity_Integrations_deleteAnIdentityIntegration_Response_200":{"type":"object","properties":{"success":{"type":"boolean"}},"required":["success"],"title":"Identity Integrations_deleteAnIdentityIntegration_Response_200"},"V1IdentityIntegrationsIdPatchRequestBodyContentApplicationJsonSchemaCredentials":{"type":"object","properties":{"clientSecret":{"type":["string","null"],"minLength":1},"managementApiKey":{"type":["string","null"],"minLength":1}},"description":"Provider management/client credentials. Sealed at rest, bound to this integration, and never returned by any endpoint. Set a field to rotate it; null clears it.","title":"V1IdentityIntegrationsIdPatchRequestBodyContentApplicationJsonSchemaCredentials"},"V1IdentityIntegrationsIdPatchRequestBodyContentApplicationJsonSchemaProvider":{"type":"string","enum":["clerk","workos","auth0","okta","better-auth","oidc","custom"],"title":"V1IdentityIntegrationsIdPatchRequestBodyContentApplicationJsonSchemaProvider"},"V1IdentityIntegrationsIdPatchRequestBodyContentApplicationJsonSchemaStatus":{"type":"string","enum":["active","disabled"],"title":"V1IdentityIntegrationsIdPatchRequestBodyContentApplicationJsonSchemaStatus"},"V1IdentityIntegrationsIdPatchResponsesContentApplicationJsonSchemaConfiguredCredentialsItems":{"type":"string","enum":["clientSecret","managementApiKey"],"title":"V1IdentityIntegrationsIdPatchResponsesContentApplicationJsonSchemaConfiguredCredentialsItems"},"V1IdentityIntegrationsIdPatchResponsesContentApplicationJsonSchemaKind":{"type":"string","enum":["oidc-jwt","session","custom"],"title":"V1IdentityIntegrationsIdPatchResponsesContentApplicationJsonSchemaKind"},"V1IdentityIntegrationsIdPatchResponsesContentApplicationJsonSchemaStatus":{"type":"string","enum":["active","disabled"],"title":"V1IdentityIntegrationsIdPatchResponsesContentApplicationJsonSchemaStatus"},"Identity_Integrations_updateAnIdentityIntegration_Response_200":{"type":"object","properties":{"configuredCredentials":{"type":"array","items":{"$ref":"#/components/schemas/V1IdentityIntegrationsIdPatchResponsesContentApplicationJsonSchemaConfiguredCredentialsItems"}},"createdAt":{"type":"string"},"descriptor":{"type":"object","additionalProperties":{"description":"Any type"}},"id":{"type":"string"},"issuer":{"type":["string","null"]},"kind":{"$ref":"#/components/schemas/V1IdentityIntegrationsIdPatchResponsesContentApplicationJsonSchemaKind"},"name":{"type":"string"},"provider":{"type":"string"},"status":{"$ref":"#/components/schemas/V1IdentityIntegrationsIdPatchResponsesContentApplicationJsonSchemaStatus"},"updatedAt":{"type":"string"}},"required":["configuredCredentials","createdAt","descriptor","id","issuer","kind","name","provider","status","updatedAt"],"title":"Identity Integrations_updateAnIdentityIntegration_Response_200"},"V1IdentityIntegrationsIdPatchResponsesContentApplicationJsonSchemaIssuesItems":{"type":"object","properties":{"message":{"type":"string"},"path":{"type":"string"}},"required":["message","path"],"title":"V1IdentityIntegrationsIdPatchResponsesContentApplicationJsonSchemaIssuesItems"},"UpdateAnIdentityIntegrationRequestBadRequestError":{"type":"object","properties":{"error":{"type":"string"},"issues":{"type":"array","items":{"$ref":"#/components/schemas/V1IdentityIntegrationsIdPatchResponsesContentApplicationJsonSchemaIssuesItems"}}},"required":["error"],"title":"UpdateAnIdentityIntegrationRequestBadRequestError"},"V1IdentityTokenPostRequestBodyContentApplicationXWwwFormUrlencodedSchemaClientAssertionType":{"type":"string","enum":["urn:ietf:params:oauth:client-assertion-type:jwt-bearer"],"title":"V1IdentityTokenPostRequestBodyContentApplicationXWwwFormUrlencodedSchemaClientAssertionType"},"V1IdentityTokenPostRequestBodyContentApplicationXWwwFormUrlencodedSchemaGrantType":{"type":"string","enum":["client_credentials"],"description":"Always `client_credentials`. Token exchange returns `unsupported_grant_type`.","title":"V1IdentityTokenPostRequestBodyContentApplicationXWwwFormUrlencodedSchemaGrantType"},"AgentAccessTokenResponseIssuedTokenType":{"type":"string","enum":["urn:ietf:params:oauth:token-type:access_token"],"title":"AgentAccessTokenResponseIssuedTokenType"},"AgentAccessTokenResponseTokenType":{"type":"string","enum":["Bearer"],"title":"AgentAccessTokenResponseTokenType"},"AgentAccessTokenResponse":{"type":"object","properties":{"access_token":{"type":"string","description":"An RFC 9068 `at+jwt` signed with the keys at `/.well-known/jwks.json`."},"expires_in":{"type":"integer","description":"Seconds until the token expires; at most 300."},"issued_token_type":{"$ref":"#/components/schemas/AgentAccessTokenResponseIssuedTokenType"},"scope":{"type":"string","description":"The granted scopes, when any were requested and allowed."},"token_type":{"$ref":"#/components/schemas/AgentAccessTokenResponseTokenType"}},"required":["access_token","expires_in","issued_token_type","token_type"],"title":"AgentAccessTokenResponse"},"AgentAccessTokenErrorError":{"type":"string","enum":["invalid_request","invalid_client","invalid_grant","unauthorized_client","unsupported_grant_type","invalid_target","invalid_scope","temporarily_unavailable","server_error"],"title":"AgentAccessTokenErrorError"},"AgentAccessTokenError":{"type":"object","properties":{"error":{"$ref":"#/components/schemas/AgentAccessTokenErrorError"},"error_description":{"type":"string"}},"required":["error"],"title":"AgentAccessTokenError"},"V1AgentAliasesGetResponsesContentApplicationJsonSchemaDataItems":{"type":"object","properties":{"agentId":{"type":"string"},"agentName":{"type":"string"},"alias":{"type":"string"},"archivedAt":{"type":["string","null"]},"expiresAt":{"type":["string","null"]},"revision":{"type":"number","format":"double"},"updatedAt":{"type":"string"},"versionId":{"type":"string"}},"required":["agentId","agentName","alias","archivedAt","expiresAt","revision","updatedAt","versionId"],"title":"V1AgentAliasesGetResponsesContentApplicationJsonSchemaDataItems"},"Agent_Aliases_listReleaseAliasesWithOneNameAcrossTheOrganization_Response_200":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1AgentAliasesGetResponsesContentApplicationJsonSchemaDataItems"}}},"required":["data"],"title":"Agent Aliases_listReleaseAliasesWithOneNameAcrossTheOrganization_Response_200"},"V1AgentsIdAliasesGetResponsesContentApplicationJsonSchemaDataItems":{"type":"object","properties":{"alias":{"type":"string"},"archivedAt":{"type":["string","null"]},"bindingNames":{"type":"array","items":{"type":"string"},"description":"Names of the per-alias secret bindings in force at this pointer. Executions that resolve through it read these ahead of the organization secret of the same name. Names only: a binding value is never returned by any read."},"contentHash":{"type":["string","null"]},"createdAt":{"type":"string"},"expiresAt":{"type":["string","null"]},"label":{"type":["string","null"]},"revision":{"type":"number","format":"double"},"updatedAt":{"type":"string"},"versionId":{"type":"string"},"versionNumber":{"type":["number","null"],"format":"double"}},"required":["alias","archivedAt","bindingNames","contentHash","createdAt","expiresAt","label","revision","updatedAt","versionId","versionNumber"],"title":"V1AgentsIdAliasesGetResponsesContentApplicationJsonSchemaDataItems"},"Agent_Aliases_listReleaseAliasesForAnAgent_Response_200":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1AgentsIdAliasesGetResponsesContentApplicationJsonSchemaDataItems"}},"liveDefault":{"type":"boolean","description":"Whether an execution that names no version selector already resolves this agent through its `live` alias. False means a save still changes what runs, so moving production needs a publish; true means `live` is authoritative and moving production is an alias activation."},"nextCursor":{"type":["string","null"]}},"required":["data","liveDefault","nextCursor"],"title":"Agent Aliases_listReleaseAliasesForAnAgent_Response_200"},"Agent_Aliases_getOneReleaseAlias_Response_200":{"type":"object","properties":{"alias":{"type":"string"},"archivedAt":{"type":["string","null"]},"bindingNames":{"type":"array","items":{"type":"string"},"description":"Names of the per-alias secret bindings in force at this pointer. Executions that resolve through it read these ahead of the organization secret of the same name. Names only: a binding value is never returned by any read."},"contentHash":{"type":["string","null"]},"createdAt":{"type":"string"},"expiresAt":{"type":["string","null"]},"label":{"type":["string","null"]},"revision":{"type":"number","format":"double"},"updatedAt":{"type":"string"},"versionId":{"type":"string"},"versionNumber":{"type":["number","null"],"format":"double"}},"required":["alias","archivedAt","bindingNames","contentHash","createdAt","expiresAt","label","revision","updatedAt","versionId","versionNumber"],"title":"Agent Aliases_getOneReleaseAlias_Response_200"},"V1AgentsIdAliasesAliasGetResponsesContentApplicationJsonSchemaCode":{"type":"string","enum":["alias_not_found"],"description":"Stable error code. `insufficient_scope` marks an API key that lacks a scope this request needs.","title":"V1AgentsIdAliasesAliasGetResponsesContentApplicationJsonSchemaCode"},"V1AgentsIdAliasesAliasGetResponsesContentApplicationJsonSchemaDetailsItems":{"type":"object","properties":{"code":{"type":"string","description":"Stable Runtype validation code (e.g. MISSING_REQUIRED_FIELD, INVALID_ENUM)."},"message":{"type":"string"},"path":{"type":"string","description":"Dotted JSON path to the offending field."},"suggestion":{"type":"string","description":"Actionable hint (allowed values, accepted range, …)."}},"required":["message"],"title":"V1AgentsIdAliasesAliasGetResponsesContentApplicationJsonSchemaDetailsItems"},"GetOneReleaseAliasRequestNotFoundError":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/V1AgentsIdAliasesAliasGetResponsesContentApplicationJsonSchemaCode","description":"Stable error code. `insufficient_scope` marks an API key that lacks a scope this request needs."},"details":{"type":"array","items":{"$ref":"#/components/schemas/V1AgentsIdAliasesAliasGetResponsesContentApplicationJsonSchemaDetailsItems"}},"error":{"type":"string"},"requiredScopes":{"type":"array","items":{"type":"string"},"description":"On `insufficient_scope`: every API key scope this request needs."},"agentId":{"type":"string"},"alias":{"type":"string"}},"required":["code","error","agentId","alias"],"title":"GetOneReleaseAliasRequestNotFoundError"},"AgentDeploymentPromotion":{"type":"object","properties":{"sourceAgentId":{"type":"string","maxLength":255},"sourceCommit":{"type":"string","maxLength":255},"sourceContentHash":{"type":"string","pattern":"^[0-9a-f]{64}$"},"sourceVersionId":{"type":"string","maxLength":255}},"description":"Source-organization ids and hashes this version was promoted from, linked on the receipt. Provenance only: it never authorizes anything, and the target credentials alone decide what the activation may do.","title":"AgentDeploymentPromotion"},"Agent_Aliases_activateAVersionAtAReleaseAlias_Response_200":{"type":"object","properties":{"_warnings":{"type":"array","items":{"type":"string"},"description":"Non-blocking advisories, e.g. SCHEDULE_AGENT_CONFIG_UNSUPPORTED when moving `live` makes active schedules unrunnable."},"alias":{"type":"string"},"bindingNames":{"type":"array","items":{"type":"string"},"description":"Per-alias secret binding names in force after this activation. Names only, never values."},"changed":{"type":"boolean"},"receiptId":{"type":"string"},"revision":{"type":"number","format":"double"},"versionId":{"type":"string"},"versionNumber":{"type":["number","null"],"format":"double"}},"required":["alias","bindingNames","changed","receiptId","revision","versionId","versionNumber"],"title":"Agent Aliases_activateAVersionAtAReleaseAlias_Response_200"},"V1AgentsIdAliasesAliasPutResponsesContentApplicationJsonSchemaCode":{"type":"string","enum":["alias_revision_required"],"description":"Stable error code. `insufficient_scope` marks an API key that lacks a scope this request needs.","title":"V1AgentsIdAliasesAliasPutResponsesContentApplicationJsonSchemaCode"},"V1AgentsIdAliasesAliasPutResponsesContentApplicationJsonSchemaDetailsItems":{"type":"object","properties":{"code":{"type":"string","description":"Stable Runtype validation code (e.g. MISSING_REQUIRED_FIELD, INVALID_ENUM)."},"message":{"type":"string"},"path":{"type":"string","description":"Dotted JSON path to the offending field."},"suggestion":{"type":"string","description":"Actionable hint (allowed values, accepted range, …)."}},"required":["message"],"title":"V1AgentsIdAliasesAliasPutResponsesContentApplicationJsonSchemaDetailsItems"},"ActivateAVersionAtAReleaseAliasRequestConflictError":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/V1AgentsIdAliasesAliasPutResponsesContentApplicationJsonSchemaCode","description":"Stable error code. `insufficient_scope` marks an API key that lacks a scope this request needs."},"details":{"type":"array","items":{"$ref":"#/components/schemas/V1AgentsIdAliasesAliasPutResponsesContentApplicationJsonSchemaDetailsItems"}},"error":{"type":"string"},"requiredScopes":{"type":"array","items":{"type":"string"},"description":"On `insufficient_scope`: every API key scope this request needs."}},"required":["code","error"],"title":"ActivateAVersionAtAReleaseAliasRequestConflictError"},"ActivateAVersionAtAReleaseAliasRequestPreconditionFailedError":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/V1AgentsIdAliasesAliasPutResponsesContentApplicationJsonSchemaCode","description":"Stable error code. `insufficient_scope` marks an API key that lacks a scope this request needs."},"details":{"type":"array","items":{"$ref":"#/components/schemas/V1AgentsIdAliasesAliasPutResponsesContentApplicationJsonSchemaDetailsItems"}},"error":{"type":"string"},"requiredScopes":{"type":"array","items":{"type":"string"},"description":"On `insufficient_scope`: every API key scope this request needs."},"actual":{"type":["number","null"],"format":"double"},"expected":{"type":"number","format":"double"}},"required":["code","error","actual","expected"],"title":"ActivateAVersionAtAReleaseAliasRequestPreconditionFailedError"},"ActivateAVersionAtAReleaseAliasRequestUnprocessableEntityError":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/V1AgentsIdAliasesAliasPutResponsesContentApplicationJsonSchemaCode","description":"Stable error code. `insufficient_scope` marks an API key that lacks a scope this request needs."},"details":{"type":"array","items":{"$ref":"#/components/schemas/V1AgentsIdAliasesAliasPutResponsesContentApplicationJsonSchemaDetailsItems"}},"error":{"type":"string"},"requiredScopes":{"type":"array","items":{"type":"string"},"description":"On `insufficient_scope`: every API key scope this request needs."},"refs":{"type":"array","items":{"type":"string"}}},"required":["code","error","refs"],"title":"ActivateAVersionAtAReleaseAliasRequestUnprocessableEntityError"},"ActivateAVersionAtAReleaseAliasRequestPreconditionError":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/V1AgentsIdAliasesAliasPutResponsesContentApplicationJsonSchemaCode","description":"Stable error code. `insufficient_scope` marks an API key that lacks a scope this request needs."},"details":{"type":"array","items":{"$ref":"#/components/schemas/V1AgentsIdAliasesAliasPutResponsesContentApplicationJsonSchemaDetailsItems"}},"error":{"type":"string"},"requiredScopes":{"type":"array","items":{"type":"string"},"description":"On `insufficient_scope`: every API key scope this request needs."},"alias":{"type":"string"}},"required":["code","error","alias"],"title":"ActivateAVersionAtAReleaseAliasRequestPreconditionError"},"Agent_Aliases_archiveAReleaseAlias_Response_200":{"type":"object","properties":{"alias":{"type":"string"},"archived":{"type":"boolean"},"receiptId":{"type":"string"},"revision":{"type":"number","format":"double"}},"required":["alias","archived","receiptId","revision"],"title":"Agent Aliases_archiveAReleaseAlias_Response_200"},"V1AgentsIdAliasesAliasDeleteResponsesContentApplicationJsonSchemaCode":{"type":"string","enum":["alias_revision_mismatch"],"description":"Stable error code. `insufficient_scope` marks an API key that lacks a scope this request needs.","title":"V1AgentsIdAliasesAliasDeleteResponsesContentApplicationJsonSchemaCode"},"V1AgentsIdAliasesAliasDeleteResponsesContentApplicationJsonSchemaDetailsItems":{"type":"object","properties":{"code":{"type":"string","description":"Stable Runtype validation code (e.g. MISSING_REQUIRED_FIELD, INVALID_ENUM)."},"message":{"type":"string"},"path":{"type":"string","description":"Dotted JSON path to the offending field."},"suggestion":{"type":"string","description":"Actionable hint (allowed values, accepted range, …)."}},"required":["message"],"title":"V1AgentsIdAliasesAliasDeleteResponsesContentApplicationJsonSchemaDetailsItems"},"ArchiveAReleaseAliasRequestNotFoundError":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/V1AgentsIdAliasesAliasDeleteResponsesContentApplicationJsonSchemaCode","description":"Stable error code. `insufficient_scope` marks an API key that lacks a scope this request needs."},"details":{"type":"array","items":{"$ref":"#/components/schemas/V1AgentsIdAliasesAliasDeleteResponsesContentApplicationJsonSchemaDetailsItems"}},"error":{"type":"string"},"requiredScopes":{"type":"array","items":{"type":"string"},"description":"On `insufficient_scope`: every API key scope this request needs."},"agentId":{"type":"string"},"alias":{"type":"string"}},"required":["code","error","agentId","alias"],"title":"ArchiveAReleaseAliasRequestNotFoundError"},"ArchiveAReleaseAliasRequestConflictError":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/V1AgentsIdAliasesAliasDeleteResponsesContentApplicationJsonSchemaCode","description":"Stable error code. `insufficient_scope` marks an API key that lacks a scope this request needs."},"details":{"type":"array","items":{"$ref":"#/components/schemas/V1AgentsIdAliasesAliasDeleteResponsesContentApplicationJsonSchemaDetailsItems"}},"error":{"type":"string"},"requiredScopes":{"type":"array","items":{"type":"string"},"description":"On `insufficient_scope`: every API key scope this request needs."}},"required":["code","error"],"title":"ArchiveAReleaseAliasRequestConflictError"},"ArchiveAReleaseAliasRequestPreconditionFailedError":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/V1AgentsIdAliasesAliasDeleteResponsesContentApplicationJsonSchemaCode","description":"Stable error code. `insufficient_scope` marks an API key that lacks a scope this request needs."},"details":{"type":"array","items":{"$ref":"#/components/schemas/V1AgentsIdAliasesAliasDeleteResponsesContentApplicationJsonSchemaDetailsItems"}},"error":{"type":"string"},"requiredScopes":{"type":"array","items":{"type":"string"},"description":"On `insufficient_scope`: every API key scope this request needs."},"actual":{"type":["number","null"],"format":"double"},"expected":{"type":"number","format":"double"}},"required":["code","error","actual","expected"],"title":"ArchiveAReleaseAliasRequestPreconditionFailedError"},"Agent_Aliases_readTheSecretBindingNamesOfAReleaseAlias_Response_200":{"type":"object","properties":{"alias":{"type":"string"},"changed":{"type":"boolean","description":"Present on a write: false when the set was already identical and nothing moved."},"names":{"type":"array","items":{"type":"string"}},"receiptId":{"type":["string","null"],"description":"The `bind` receipt this write appended, or null when it changed nothing."},"revision":{"type":"number","format":"double"}},"required":["alias","names","revision"],"title":"Agent Aliases_readTheSecretBindingNamesOfAReleaseAlias_Response_200"},"V1AgentsIdAliasesAliasBindingsGetResponsesContentApplicationJsonSchemaCode":{"type":"string","enum":["alias_not_found"],"description":"Stable error code. `insufficient_scope` marks an API key that lacks a scope this request needs.","title":"V1AgentsIdAliasesAliasBindingsGetResponsesContentApplicationJsonSchemaCode"},"V1AgentsIdAliasesAliasBindingsGetResponsesContentApplicationJsonSchemaDetailsItems":{"type":"object","properties":{"code":{"type":"string","description":"Stable Runtype validation code (e.g. MISSING_REQUIRED_FIELD, INVALID_ENUM)."},"message":{"type":"string"},"path":{"type":"string","description":"Dotted JSON path to the offending field."},"suggestion":{"type":"string","description":"Actionable hint (allowed values, accepted range, …)."}},"required":["message"],"title":"V1AgentsIdAliasesAliasBindingsGetResponsesContentApplicationJsonSchemaDetailsItems"},"ReadTheSecretBindingNamesOfAReleaseAliasRequestNotFoundError":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/V1AgentsIdAliasesAliasBindingsGetResponsesContentApplicationJsonSchemaCode","description":"Stable error code. `insufficient_scope` marks an API key that lacks a scope this request needs."},"details":{"type":"array","items":{"$ref":"#/components/schemas/V1AgentsIdAliasesAliasBindingsGetResponsesContentApplicationJsonSchemaDetailsItems"}},"error":{"type":"string"},"requiredScopes":{"type":"array","items":{"type":"string"},"description":"On `insufficient_scope`: every API key scope this request needs."},"agentId":{"type":"string"},"alias":{"type":"string"}},"required":["code","error","agentId","alias"],"title":"ReadTheSecretBindingNamesOfAReleaseAliasRequestNotFoundError"},"Agent_Aliases_replaceTheSecretBindingsOfAReleaseAlias_Response_200":{"type":"object","properties":{"alias":{"type":"string"},"changed":{"type":"boolean","description":"Present on a write: false when the set was already identical and nothing moved."},"names":{"type":"array","items":{"type":"string"}},"receiptId":{"type":["string","null"],"description":"The `bind` receipt this write appended, or null when it changed nothing."},"revision":{"type":"number","format":"double"}},"required":["alias","names","revision"],"title":"Agent Aliases_replaceTheSecretBindingsOfAReleaseAlias_Response_200"},"V1AgentsIdAliasesAliasBindingsPutResponsesContentApplicationJsonSchemaCode":{"type":"string","enum":["alias_revision_required"],"description":"Stable error code. `insufficient_scope` marks an API key that lacks a scope this request needs.","title":"V1AgentsIdAliasesAliasBindingsPutResponsesContentApplicationJsonSchemaCode"},"V1AgentsIdAliasesAliasBindingsPutResponsesContentApplicationJsonSchemaDetailsItems":{"type":"object","properties":{"code":{"type":"string","description":"Stable Runtype validation code (e.g. MISSING_REQUIRED_FIELD, INVALID_ENUM)."},"message":{"type":"string"},"path":{"type":"string","description":"Dotted JSON path to the offending field."},"suggestion":{"type":"string","description":"Actionable hint (allowed values, accepted range, …)."}},"required":["message"],"title":"V1AgentsIdAliasesAliasBindingsPutResponsesContentApplicationJsonSchemaDetailsItems"},"ReplaceTheSecretBindingsOfAReleaseAliasRequestBadRequestError":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/V1AgentsIdAliasesAliasBindingsPutResponsesContentApplicationJsonSchemaCode","description":"Stable error code. `insufficient_scope` marks an API key that lacks a scope this request needs."},"details":{"type":"array","items":{"$ref":"#/components/schemas/V1AgentsIdAliasesAliasBindingsPutResponsesContentApplicationJsonSchemaDetailsItems"}},"error":{"type":"string"},"requiredScopes":{"type":"array","items":{"type":"string"},"description":"On `insufficient_scope`: every API key scope this request needs."}},"required":["code","error"],"title":"ReplaceTheSecretBindingsOfAReleaseAliasRequestBadRequestError"},"ReplaceTheSecretBindingsOfAReleaseAliasRequestNotFoundError":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/V1AgentsIdAliasesAliasBindingsPutResponsesContentApplicationJsonSchemaCode","description":"Stable error code. `insufficient_scope` marks an API key that lacks a scope this request needs."},"details":{"type":"array","items":{"$ref":"#/components/schemas/V1AgentsIdAliasesAliasBindingsPutResponsesContentApplicationJsonSchemaDetailsItems"}},"error":{"type":"string"},"requiredScopes":{"type":"array","items":{"type":"string"},"description":"On `insufficient_scope`: every API key scope this request needs."},"agentId":{"type":"string"},"alias":{"type":"string"}},"required":["code","error","agentId","alias"],"title":"ReplaceTheSecretBindingsOfAReleaseAliasRequestNotFoundError"},"ReplaceTheSecretBindingsOfAReleaseAliasRequestPreconditionFailedError":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/V1AgentsIdAliasesAliasBindingsPutResponsesContentApplicationJsonSchemaCode","description":"Stable error code. `insufficient_scope` marks an API key that lacks a scope this request needs."},"details":{"type":"array","items":{"$ref":"#/components/schemas/V1AgentsIdAliasesAliasBindingsPutResponsesContentApplicationJsonSchemaDetailsItems"}},"error":{"type":"string"},"requiredScopes":{"type":"array","items":{"type":"string"},"description":"On `insufficient_scope`: every API key scope this request needs."},"actual":{"type":["number","null"],"format":"double"},"expected":{"type":"number","format":"double"}},"required":["code","error","actual","expected"],"title":"ReplaceTheSecretBindingsOfAReleaseAliasRequestPreconditionFailedError"},"ReplaceTheSecretBindingsOfAReleaseAliasRequestPreconditionError":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/V1AgentsIdAliasesAliasBindingsPutResponsesContentApplicationJsonSchemaCode","description":"Stable error code. `insufficient_scope` marks an API key that lacks a scope this request needs."},"details":{"type":"array","items":{"$ref":"#/components/schemas/V1AgentsIdAliasesAliasBindingsPutResponsesContentApplicationJsonSchemaDetailsItems"}},"error":{"type":"string"},"requiredScopes":{"type":"array","items":{"type":"string"},"description":"On `insufficient_scope`: every API key scope this request needs."},"alias":{"type":"string"}},"required":["code","error","alias"],"title":"ReplaceTheSecretBindingsOfAReleaseAliasRequestPreconditionError"},"Agent_Aliases_clearTheSecretBindingsOfAReleaseAlias_Response_200":{"type":"object","properties":{"alias":{"type":"string"},"changed":{"type":"boolean","description":"Present on a write: false when the set was already identical and nothing moved."},"names":{"type":"array","items":{"type":"string"}},"receiptId":{"type":["string","null"],"description":"The `bind` receipt this write appended, or null when it changed nothing."},"revision":{"type":"number","format":"double"}},"required":["alias","names","revision"],"title":"Agent Aliases_clearTheSecretBindingsOfAReleaseAlias_Response_200"},"V1AgentsIdAliasesAliasBindingsDeleteResponsesContentApplicationJsonSchemaCode":{"type":"string","enum":["alias_revision_required"],"description":"Stable error code. `insufficient_scope` marks an API key that lacks a scope this request needs.","title":"V1AgentsIdAliasesAliasBindingsDeleteResponsesContentApplicationJsonSchemaCode"},"V1AgentsIdAliasesAliasBindingsDeleteResponsesContentApplicationJsonSchemaDetailsItems":{"type":"object","properties":{"code":{"type":"string","description":"Stable Runtype validation code (e.g. MISSING_REQUIRED_FIELD, INVALID_ENUM)."},"message":{"type":"string"},"path":{"type":"string","description":"Dotted JSON path to the offending field."},"suggestion":{"type":"string","description":"Actionable hint (allowed values, accepted range, …)."}},"required":["message"],"title":"V1AgentsIdAliasesAliasBindingsDeleteResponsesContentApplicationJsonSchemaDetailsItems"},"ClearTheSecretBindingsOfAReleaseAliasRequestNotFoundError":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/V1AgentsIdAliasesAliasBindingsDeleteResponsesContentApplicationJsonSchemaCode","description":"Stable error code. `insufficient_scope` marks an API key that lacks a scope this request needs."},"details":{"type":"array","items":{"$ref":"#/components/schemas/V1AgentsIdAliasesAliasBindingsDeleteResponsesContentApplicationJsonSchemaDetailsItems"}},"error":{"type":"string"},"requiredScopes":{"type":"array","items":{"type":"string"},"description":"On `insufficient_scope`: every API key scope this request needs."},"agentId":{"type":"string"},"alias":{"type":"string"}},"required":["code","error","agentId","alias"],"title":"ClearTheSecretBindingsOfAReleaseAliasRequestNotFoundError"},"ClearTheSecretBindingsOfAReleaseAliasRequestPreconditionFailedError":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/V1AgentsIdAliasesAliasBindingsDeleteResponsesContentApplicationJsonSchemaCode","description":"Stable error code. `insufficient_scope` marks an API key that lacks a scope this request needs."},"details":{"type":"array","items":{"$ref":"#/components/schemas/V1AgentsIdAliasesAliasBindingsDeleteResponsesContentApplicationJsonSchemaDetailsItems"}},"error":{"type":"string"},"requiredScopes":{"type":"array","items":{"type":"string"},"description":"On `insufficient_scope`: every API key scope this request needs."},"actual":{"type":["number","null"],"format":"double"},"expected":{"type":"number","format":"double"}},"required":["code","error","actual","expected"],"title":"ClearTheSecretBindingsOfAReleaseAliasRequestPreconditionFailedError"},"ClearTheSecretBindingsOfAReleaseAliasRequestPreconditionError":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/V1AgentsIdAliasesAliasBindingsDeleteResponsesContentApplicationJsonSchemaCode","description":"Stable error code. `insufficient_scope` marks an API key that lacks a scope this request needs."},"details":{"type":"array","items":{"$ref":"#/components/schemas/V1AgentsIdAliasesAliasBindingsDeleteResponsesContentApplicationJsonSchemaDetailsItems"}},"error":{"type":"string"},"requiredScopes":{"type":"array","items":{"type":"string"},"description":"On `insufficient_scope`: every API key scope this request needs."},"alias":{"type":"string"}},"required":["code","error","alias"],"title":"ClearTheSecretBindingsOfAReleaseAliasRequestPreconditionError"},"Agent_Aliases_rollAReleaseAliasBackToItsPreviousVersion_Response_200":{"type":"object","properties":{"_warnings":{"type":"array","items":{"type":"string"},"description":"Non-blocking advisories, e.g. SCHEDULE_AGENT_CONFIG_UNSUPPORTED when moving `live` makes active schedules unrunnable."},"alias":{"type":"string"},"bindingNames":{"type":"array","items":{"type":"string"},"description":"Per-alias secret binding names in force after this activation. Names only, never values."},"changed":{"type":"boolean"},"receiptId":{"type":"string"},"revision":{"type":"number","format":"double"},"versionId":{"type":"string"},"versionNumber":{"type":["number","null"],"format":"double"}},"required":["alias","bindingNames","changed","receiptId","revision","versionId","versionNumber"],"title":"Agent Aliases_rollAReleaseAliasBackToItsPreviousVersion_Response_200"},"V1AgentsIdAliasesAliasRollbackPostResponsesContentApplicationJsonSchemaCode":{"type":"string","enum":["alias_revision_required"],"description":"Stable error code. `insufficient_scope` marks an API key that lacks a scope this request needs.","title":"V1AgentsIdAliasesAliasRollbackPostResponsesContentApplicationJsonSchemaCode"},"V1AgentsIdAliasesAliasRollbackPostResponsesContentApplicationJsonSchemaDetailsItems":{"type":"object","properties":{"code":{"type":"string","description":"Stable Runtype validation code (e.g. MISSING_REQUIRED_FIELD, INVALID_ENUM)."},"message":{"type":"string"},"path":{"type":"string","description":"Dotted JSON path to the offending field."},"suggestion":{"type":"string","description":"Actionable hint (allowed values, accepted range, …)."}},"required":["message"],"title":"V1AgentsIdAliasesAliasRollbackPostResponsesContentApplicationJsonSchemaDetailsItems"},"RollAReleaseAliasBackToItsPreviousVersionRequestNotFoundError":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/V1AgentsIdAliasesAliasRollbackPostResponsesContentApplicationJsonSchemaCode","description":"Stable error code. `insufficient_scope` marks an API key that lacks a scope this request needs."},"details":{"type":"array","items":{"$ref":"#/components/schemas/V1AgentsIdAliasesAliasRollbackPostResponsesContentApplicationJsonSchemaDetailsItems"}},"error":{"type":"string"},"requiredScopes":{"type":"array","items":{"type":"string"},"description":"On `insufficient_scope`: every API key scope this request needs."},"agentId":{"type":"string"},"alias":{"type":"string"}},"required":["code","error","agentId","alias"],"title":"RollAReleaseAliasBackToItsPreviousVersionRequestNotFoundError"},"RollAReleaseAliasBackToItsPreviousVersionRequestPreconditionFailedError":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/V1AgentsIdAliasesAliasRollbackPostResponsesContentApplicationJsonSchemaCode","description":"Stable error code. `insufficient_scope` marks an API key that lacks a scope this request needs."},"details":{"type":"array","items":{"$ref":"#/components/schemas/V1AgentsIdAliasesAliasRollbackPostResponsesContentApplicationJsonSchemaDetailsItems"}},"error":{"type":"string"},"requiredScopes":{"type":"array","items":{"type":"string"},"description":"On `insufficient_scope`: every API key scope this request needs."},"actual":{"type":["number","null"],"format":"double"},"expected":{"type":"number","format":"double"}},"required":["code","error","actual","expected"],"title":"RollAReleaseAliasBackToItsPreviousVersionRequestPreconditionFailedError"},"RollAReleaseAliasBackToItsPreviousVersionRequestUnprocessableEntityError":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/V1AgentsIdAliasesAliasRollbackPostResponsesContentApplicationJsonSchemaCode","description":"Stable error code. `insufficient_scope` marks an API key that lacks a scope this request needs."},"details":{"type":"array","items":{"$ref":"#/components/schemas/V1AgentsIdAliasesAliasRollbackPostResponsesContentApplicationJsonSchemaDetailsItems"}},"error":{"type":"string"},"requiredScopes":{"type":"array","items":{"type":"string"},"description":"On `insufficient_scope`: every API key scope this request needs."},"refs":{"type":"array","items":{"type":"string"}}},"required":["code","error","refs"],"title":"RollAReleaseAliasBackToItsPreviousVersionRequestUnprocessableEntityError"},"RollAReleaseAliasBackToItsPreviousVersionRequestPreconditionError":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/V1AgentsIdAliasesAliasRollbackPostResponsesContentApplicationJsonSchemaCode","description":"Stable error code. `insufficient_scope` marks an API key that lacks a scope this request needs."},"details":{"type":"array","items":{"$ref":"#/components/schemas/V1AgentsIdAliasesAliasRollbackPostResponsesContentApplicationJsonSchemaDetailsItems"}},"error":{"type":"string"},"requiredScopes":{"type":"array","items":{"type":"string"},"description":"On `insufficient_scope`: every API key scope this request needs."},"alias":{"type":"string"}},"required":["code","error","alias"],"title":"RollAReleaseAliasBackToItsPreviousVersionRequestPreconditionError"},"V1AgentsIdDeploymentsGetResponsesContentApplicationJsonSchemaDataItems":{"type":"object","properties":{"action":{"type":"string"},"actorUserId":{"type":["string","null"]},"alias":{"type":"string"},"aliasRevision":{"type":"number","format":"double"},"bindings":{"type":["object","null"],"additionalProperties":{"description":"Any type"},"description":"The per-alias secret binding NAMES in force when this receipt was written, as `{ names: [...] }`. Null when the pointer carried none. Values never appear here."},"createdAt":{"type":"string"},"dependencies":{"type":["object","null"],"additionalProperties":{"description":"Any type"}},"id":{"type":"string"},"previousVersionId":{"type":["string","null"]},"source":{"type":"object","additionalProperties":{"description":"Any type"}},"versionId":{"type":"string"}},"required":["action","actorUserId","alias","aliasRevision","bindings","createdAt","dependencies","id","previousVersionId","source","versionId"],"title":"V1AgentsIdDeploymentsGetResponsesContentApplicationJsonSchemaDataItems"},"Agent_Aliases_listDeploymentReceiptsForAnAgent_Response_200":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1AgentsIdDeploymentsGetResponsesContentApplicationJsonSchemaDataItems"}},"pagination":{"type":"object","additionalProperties":{"description":"Any type"}}},"required":["data","pagination"],"title":"Agent Aliases_listDeploymentReceiptsForAnAgent_Response_200"},"V1AgentFeedbackPostRequestBodyContentApplicationJsonSchemaCategory":{"type":"string","enum":["api","mcp","documentation","sdk","cli","dashboard","other"],"description":"Which part of Runtype the problem is in.","title":"V1AgentFeedbackPostRequestBodyContentApplicationJsonSchemaCategory"},"V1AgentFeedbackPostResponsesContentApplicationJsonSchemaStatus":{"type":"string","enum":["received"],"title":"V1AgentFeedbackPostResponsesContentApplicationJsonSchemaStatus"},"Agent_Feedback_reportAProblem_Response_202":{"type":"object","properties":{"id":{"type":"string","description":"Receipt ID for this report (agfb_...). Quote it in follow-ups."},"status":{"$ref":"#/components/schemas/V1AgentFeedbackPostResponsesContentApplicationJsonSchemaStatus"}},"required":["id","status"],"title":"Agent Feedback_reportAProblem_Response_202"},"V1AgentVersionsAgentIdGetParametersType":{"type":"string","enum":["published","draft","test","virtual"],"title":"V1AgentVersionsAgentIdGetParametersType"},"V1AgentVersionsAgentIdGetResponsesContentApplicationJsonSchemaVersionsItems":{"type":"object","properties":{"configSummary":{"type":["string","null"]},"createdAt":{"type":"string"},"id":{"type":"string"},"label":{"type":["string","null"]},"notes":{"type":["string","null"]},"versionNumber":{"type":"integer"},"versionType":{"type":"string"}},"required":["configSummary","createdAt","id","label","notes","versionNumber","versionType"],"title":"V1AgentVersionsAgentIdGetResponsesContentApplicationJsonSchemaVersionsItems"},"Agent_Versions_listVersionsForAnAgent_Response_200":{"type":"object","properties":{"agentId":{"type":"string"},"draftVersionId":{"type":["string","null"]},"publishedVersionId":{"type":["string","null"]},"versions":{"type":"array","items":{"$ref":"#/components/schemas/V1AgentVersionsAgentIdGetResponsesContentApplicationJsonSchemaVersionsItems"}}},"required":["agentId","draftVersionId","publishedVersionId","versions"],"title":"Agent Versions_listVersionsForAnAgent_Response_200"},"InternalErrorDetailsItems":{"type":"object","properties":{"code":{"type":"string","description":"Stable Runtype validation code (e.g. MISSING_REQUIRED_FIELD, INVALID_ENUM)."},"message":{"type":"string"},"path":{"type":"string","description":"Dotted JSON path to the offending field."},"suggestion":{"type":"string","description":"Actionable hint (allowed values, accepted range, …)."}},"required":["message"],"title":"InternalErrorDetailsItems"},"InternalError":{"type":"object","properties":{"code":{"type":"string","description":"Stable error code: `INTERNAL_ERROR` unless the route documents its own."},"details":{"type":"array","items":{"$ref":"#/components/schemas/InternalErrorDetailsItems"}},"error":{"type":"string"},"requiredScopes":{"type":"array","items":{"type":"string"},"description":"On `insufficient_scope`: every API key scope this request needs."},"message":{"type":"string","description":"Plain-language guidance: retry, then contact support with the `requestId`."},"requestId":{"type":"string","description":"The `X-Runtype-Request-ID` of the failed request, for support."}},"required":["code","error"],"title":"InternalError"},"DatabaseUnavailableErrorCode":{"type":"string","enum":["DATABASE_UNAVAILABLE"],"description":"Stable error code. `insufficient_scope` marks an API key that lacks a scope this request needs.","title":"DatabaseUnavailableErrorCode"},"DatabaseUnavailableErrorDetailsItems":{"type":"object","properties":{"code":{"type":"string","description":"Stable Runtype validation code (e.g. MISSING_REQUIRED_FIELD, INVALID_ENUM)."},"message":{"type":"string"},"path":{"type":"string","description":"Dotted JSON path to the offending field."},"suggestion":{"type":"string","description":"Actionable hint (allowed values, accepted range, …)."}},"required":["message"],"title":"DatabaseUnavailableErrorDetailsItems"},"DatabaseUnavailableError":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/DatabaseUnavailableErrorCode","description":"Stable error code. `insufficient_scope` marks an API key that lacks a scope this request needs."},"details":{"type":"array","items":{"$ref":"#/components/schemas/DatabaseUnavailableErrorDetailsItems"}},"error":{"type":"string"},"requiredScopes":{"type":"array","items":{"type":"string"},"description":"On `insufficient_scope`: every API key scope this request needs."},"requestId":{"type":"string","description":"The `X-Runtype-Request-ID` of the failed request, for support."}},"required":["code","error"],"title":"DatabaseUnavailableError"},"Agent_Versions_proposeANewAgentVersion_Response_200":{"type":"object","properties":{"agentId":{"type":"string"},"alias":{"type":"string"},"changed":{"type":"boolean","description":"False when this alias already pointed at these instructions."},"versionId":{"type":"string"}},"required":["agentId","alias","changed","versionId"],"title":"Agent Versions_proposeANewAgentVersion_Response_200"},"V1AgentVersionsAgentIdPublishPostRequestBodyContentApplicationJsonSchemaDeploymentAction":{"type":"string","enum":["activate","rollback"],"default":"activate","description":"What the deployment receipt records this move as. Send `rollback` when re-deploying the version a previous deployment replaced, so the history reads as a rollback rather than a fresh deployment.","title":"V1AgentVersionsAgentIdPublishPostRequestBodyContentApplicationJsonSchemaDeploymentAction"},"V1AgentVersionsAgentIdPublishPostRequestBodyContentApplicationJsonSchemaDeployment":{"type":"object","properties":{"action":{"$ref":"#/components/schemas/V1AgentVersionsAgentIdPublishPostRequestBodyContentApplicationJsonSchemaDeploymentAction","default":"activate","description":"What the deployment receipt records this move as. Send `rollback` when re-deploying the version a previous deployment replaced, so the history reads as a rollback rather than a fresh deployment."}},"title":"V1AgentVersionsAgentIdPublishPostRequestBodyContentApplicationJsonSchemaDeployment"},"V1AgentVersionsAgentIdPublishPostRequestBodyContentApplicationJsonSchemaOnConflict":{"type":"string","enum":["error","overwrite"],"default":"error","description":"Use overwrite only after confirming replacement of a code-managed agent.","title":"V1AgentVersionsAgentIdPublishPostRequestBodyContentApplicationJsonSchemaOnConflict"},"V1AgentVersionsAgentIdPublishPostResponsesContentApplicationJsonSchemaLastModifiedSource":{"type":"string","enum":["sdk","terraform"],"title":"V1AgentVersionsAgentIdPublishPostResponsesContentApplicationJsonSchemaLastModifiedSource"},"Agent_Versions_publishASpecificAgentVersion_Response_200":{"type":"object","properties":{"agentId":{"type":"string"},"applied":{"type":"object","additionalProperties":{"type":"boolean"},"description":"Which fields of the live agent row this publish wrote. Omitted when an `Idempotency-Key` replayed an earlier publish, which applies nothing itself and cannot reconstruct what the original wrote."},"lastModifiedSource":{"$ref":"#/components/schemas/V1AgentVersionsAgentIdPublishPostResponsesContentApplicationJsonSchemaLastModifiedSource"},"message":{"type":"string"},"success":{"type":"boolean"},"versionId":{"type":"string"},"warnings":{"type":"array","items":{"type":"string"}}},"required":["agentId","lastModifiedSource","message","success","versionId","warnings"],"title":"Agent Versions_publishASpecificAgentVersion_Response_200"},"V1AgentVersionsAgentIdPublishPostResponsesContentApplicationJsonSchemaDetailsItems":{"type":"object","properties":{"code":{"type":"string","description":"Stable Runtype validation code (e.g. MISSING_REQUIRED_FIELD, INVALID_ENUM)."},"message":{"type":"string"},"path":{"type":"string","description":"Dotted JSON path to the offending field."},"suggestion":{"type":"string","description":"Actionable hint (allowed values, accepted range, …)."}},"required":["message"],"title":"V1AgentVersionsAgentIdPublishPostResponsesContentApplicationJsonSchemaDetailsItems"},"PublishASpecificAgentVersionRequestBadRequestError":{"type":"object","properties":{"code":{"type":"string","description":"Stable error code. `insufficient_scope` marks an API key that lacks a scope this request needs."},"details":{"type":"array","items":{"$ref":"#/components/schemas/V1AgentVersionsAgentIdPublishPostResponsesContentApplicationJsonSchemaDetailsItems"}},"error":{"type":"string"},"requiredScopes":{"type":"array","items":{"type":"string"},"description":"On `insufficient_scope`: every API key scope this request needs."}},"required":["error"],"title":"PublishASpecificAgentVersionRequestBadRequestError"},"V1AgentVersionsAgentIdPublishPostResponsesContentApplicationJsonSchemaCode":{"type":"string","enum":["alias_revision_mismatch"],"description":"Stable error code. `insufficient_scope` marks an API key that lacks a scope this request needs.","title":"V1AgentVersionsAgentIdPublishPostResponsesContentApplicationJsonSchemaCode"},"PublishASpecificAgentVersionRequestConflictError":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/V1AgentVersionsAgentIdPublishPostResponsesContentApplicationJsonSchemaCode","description":"Stable error code. `insufficient_scope` marks an API key that lacks a scope this request needs."},"details":{"type":"array","items":{"$ref":"#/components/schemas/V1AgentVersionsAgentIdPublishPostResponsesContentApplicationJsonSchemaDetailsItems"}},"error":{"type":"string"},"requiredScopes":{"type":"array","items":{"type":"string"},"description":"On `insufficient_scope`: every API key scope this request needs."},"expectedVersionId":{"type":["string","null"]},"lastModifiedSource":{"$ref":"#/components/schemas/V1AgentVersionsAgentIdPublishPostResponsesContentApplicationJsonSchemaLastModifiedSource"}},"required":["code","error"],"title":"PublishASpecificAgentVersionRequestConflictError"},"PublishASpecificAgentVersionRequestPreconditionFailedError":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/V1AgentVersionsAgentIdPublishPostResponsesContentApplicationJsonSchemaCode","description":"Stable error code. `insufficient_scope` marks an API key that lacks a scope this request needs."},"details":{"type":"array","items":{"$ref":"#/components/schemas/V1AgentVersionsAgentIdPublishPostResponsesContentApplicationJsonSchemaDetailsItems"}},"error":{"type":"string"},"requiredScopes":{"type":"array","items":{"type":"string"},"description":"On `insufficient_scope`: every API key scope this request needs."},"actual":{"type":["number","null"],"format":"double"},"expected":{"type":"number","format":"double"}},"required":["code","error","actual","expected"],"title":"PublishASpecificAgentVersionRequestPreconditionFailedError"},"Agent_Versions_getThePublishedVersionForAnAgent_Response_200":{"type":"object","properties":{"agentConfig":{"type":["object","null"],"additionalProperties":{"description":"Any type"}},"agentId":{"type":"string"},"createdAt":{"type":"string"},"id":{"type":"string"},"label":{"type":["string","null"]},"notes":{"type":["string","null"]},"versionNumber":{"type":"integer"},"versionType":{"type":"string"}},"required":["agentConfig","agentId","createdAt","id","label","notes","versionNumber","versionType"],"title":"Agent Versions_getThePublishedVersionForAnAgent_Response_200"},"Agent_Versions_getASpecificAgentVersion_Response_200":{"type":"object","properties":{"agentConfig":{"type":["object","null"],"additionalProperties":{"description":"Any type"}},"agentId":{"type":"string"},"createdAt":{"type":"string"},"id":{"type":"string"},"label":{"type":["string","null"]},"notes":{"type":["string","null"]},"versionNumber":{"type":"integer"},"versionType":{"type":"string"}},"required":["agentConfig","agentId","createdAt","id","label","notes","versionNumber","versionType"],"title":"Agent Versions_getASpecificAgentVersion_Response_200"},"V1AgentsGetParametersAgentType":{"type":"string","enum":["runtype","external","claude_managed"],"description":"Filter to a single agent type.","title":"V1AgentsGetParametersAgentType"},"V1AgentsGetParametersManagedInCode":{"type":"string","enum":["true","false"],"description":"Filter by code provenance. `true` returns only agents whose `lastModifiedSource` is `sdk` or `terraform`; `false` returns every other agent, including one with no recorded source.","title":"V1AgentsGetParametersManagedInCode"},"V1AgentsGetParametersView":{"type":"string","enum":["full","compact"],"description":"Response representation. `full` (default) preserves complete values; `compact` shortens every string value longer than 100 characters to a 100-character preview followed by `…`.","title":"V1AgentsGetParametersView"},"V1AgentsGetResponsesContentApplicationJsonSchemaDataItemsSandboxCapabilityIssuesItemsCode":{"type":"string","enum":["unsupported_sandbox_capability"],"title":"V1AgentsGetResponsesContentApplicationJsonSchemaDataItemsSandboxCapabilityIssuesItemsCode"},"V1AgentsGetResponsesContentApplicationJsonSchemaDataItemsSandboxCapabilityIssuesItems":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/V1AgentsGetResponsesContentApplicationJsonSchemaDataItemsSandboxCapabilityIssuesItemsCode"},"message":{"type":"string"},"path":{"type":"string"},"requested":{"type":"string"},"supported":{"type":"array","items":{"type":"string"}}},"required":["code","message","path","requested","supported"],"title":"V1AgentsGetResponsesContentApplicationJsonSchemaDataItemsSandboxCapabilityIssuesItems"},"V1AgentsGetResponsesContentApplicationJsonSchemaDataItems":{"type":"object","properties":{"agentType":{"type":"string"},"callable":{"type":"boolean","description":"On an external agent only: whether the agent has an endpoint Runtype can call. Absent on every other agent type."},"capabilityCount":{"type":"integer"},"config":{"type":["object","null"],"additionalProperties":{"description":"Any type"}},"createdAt":{"type":"string"},"description":{"type":["string","null"]},"draftVersionId":{"type":["string","null"]},"framework":{"type":"string","description":"On an external agent only: the framework the agent is built with, when it is set on the agent's external configuration."},"icon":{"type":["string","null"]},"id":{"type":"string"},"lastModifiedSource":{"type":["string","null"],"description":"Which surface last wrote this agent (`sdk`, `terraform`, `dashboard`, `api`, `mcp`). `sdk` and `terraform` mean the agent is managed in code. `null` on an agent last written before provenance was recorded."},"lastRunAt":{"type":["string","null"]},"name":{"type":"string"},"publishedVersionId":{"type":["string","null"],"description":"The live version id, or null while the agent has never been published."},"sandboxCapabilityIssues":{"type":"array","items":{"$ref":"#/components/schemas/V1AgentsGetResponsesContentApplicationJsonSchemaDataItemsSandboxCapabilityIssuesItems"}},"status":{"type":"string"},"updatedAt":{"type":"string"}},"required":["agentType","capabilityCount","config","createdAt","description","draftVersionId","icon","id","lastModifiedSource","name","publishedVersionId","status","updatedAt"],"title":"V1AgentsGetResponsesContentApplicationJsonSchemaDataItems"},"Pagination":{"type":"object","properties":{"currentOffset":{"type":"integer"},"currentPage":{"type":"integer"},"hasMore":{"type":"boolean"},"hasPrev":{"type":"boolean"},"limit":{"type":"integer"},"nextCursor":{"type":["string","null"]},"prevCursor":{"type":["string","null"]},"totalCount":{"type":"integer"},"totalPages":{"type":"integer"}},"required":["currentOffset","hasMore","hasPrev","limit","nextCursor","prevCursor"],"title":"Pagination"},"Agents_listAgents_Response_200":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1AgentsGetResponsesContentApplicationJsonSchemaDataItems"}},"pagination":{"$ref":"#/components/schemas/Pagination"}},"required":["data","pagination"],"title":"Agents_listAgents_Response_200"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaAgentType":{"type":"string","enum":["runtype","external","claude_managed"],"default":"runtype","title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaAgentType"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaCapabilitiesItems":{"type":"object","properties":{"enabled":{"type":"boolean"},"flowId":{"type":"string"},"parametersSchema":{"description":"Any type"},"subAgentId":{"type":"string"},"toolDescription":{"type":"string"},"toolId":{"type":"string"},"toolName":{"type":"string","minLength":1,"maxLength":100}},"required":["toolName"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaCapabilitiesItems"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaClaudeManagedConfigCachedAgentInfoToolsItems":{"type":"object","properties":{"name":{"type":"string"},"type":{"type":"string"}},"required":["type"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaClaudeManagedConfigCachedAgentInfoToolsItems"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaClaudeManagedConfigCachedAgentInfo":{"type":"object","properties":{"description":{"type":"string"},"fetchedAt":{"type":"string"},"model":{"type":"string"},"name":{"type":"string"},"tools":{"type":"array","items":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaClaudeManagedConfigCachedAgentInfoToolsItems"}},"version":{"type":"number","format":"double"}},"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaClaudeManagedConfigCachedAgentInfo"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaClaudeManagedConfigCustomToolsItems":{"type":"object","properties":{"capabilityId":{"type":"string"},"parametersSchema":{"type":"object","additionalProperties":{"description":"Any type"}},"toolDescription":{"type":"string"},"toolName":{"type":"string"}},"required":["capabilityId","toolDescription","toolName"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaClaudeManagedConfigCustomToolsItems"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaClaudeManagedConfigMcpServersItems":{"type":"object","properties":{"name":{"type":"string"},"target":{"description":"Any type"},"url":{"type":"string","format":"uri"}},"required":["url"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaClaudeManagedConfigMcpServersItems"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaClaudeManagedConfigSetupMode":{"type":"string","enum":["create","connect"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaClaudeManagedConfigSetupMode"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaClaudeManagedConfigToolPermissions":{"type":"object","properties":{"bash":{"type":"boolean"},"edit":{"type":"boolean"},"glob":{"type":"boolean"},"grep":{"type":"boolean"},"read":{"type":"boolean"},"webFetch":{"type":"boolean"},"webSearch":{"type":"boolean"},"write":{"type":"boolean"}},"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaClaudeManagedConfigToolPermissions"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaClaudeManagedConfig":{"type":"object","properties":{"anthropicAgentId":{"type":"string","minLength":1},"anthropicAgentVersion":{"type":"integer"},"anthropicEnvironmentId":{"type":"string"},"cachedAgentInfo":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaClaudeManagedConfigCachedAgentInfo"},"customTools":{"type":"array","items":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaClaudeManagedConfigCustomToolsItems"}},"mcpServers":{"type":"array","items":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaClaudeManagedConfigMcpServersItems"}},"model":{"type":"string"},"outputHandoff":{"type":"boolean","description":"Scheduled and batch runs only. When true, files the agent writes to /mnt/session/outputs/ are stored as runtype-asset:// handles and the session is resumed for one delivery turn that lists them (for example, to attach them with send_email)."},"setupMode":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaClaudeManagedConfigSetupMode"},"systemPrompt":{"type":"string"},"timeoutMs":{"type":["integer","null"],"minimum":10000,"maximum":1800000},"toolPermissions":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaClaudeManagedConfigToolPermissions"}},"required":["setupMode"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaClaudeManagedConfig"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigAdvisor":{"type":"object","properties":{"model":{"type":"string"},"systemPrompt":{"type":"string"}},"required":["model"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigAdvisor"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigArtifactsTypesItems":{"type":"string","enum":["markdown","component"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigArtifactsTypesItems"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigArtifacts":{"type":"object","properties":{"enabled":{"type":"boolean"},"types":{"type":"array","items":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigArtifactsTypesItems"}}},"required":["enabled","types"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigArtifacts"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigBusyMessageRoutingMode":{"type":"string","enum":["enforced","off"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigBusyMessageRoutingMode"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigBusyMessageRouting":{"type":"object","properties":{"classifierModel":{"type":"string","minLength":1,"maxLength":200},"mode":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigBusyMessageRoutingMode"}},"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigBusyMessageRouting"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigContextManagementCompactionStrategy":{"type":"string","enum":["auto","provider_native","summary"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigContextManagementCompactionStrategy"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigContextManagementCompaction":{"type":"object","properties":{"enabled":{"type":"boolean"},"instructions":{"type":"string","maxLength":4000},"model":{"type":"string"},"retainRecentTokens":{"type":"integer","minimum":0},"strategy":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigContextManagementCompactionStrategy"},"thresholdRatio":{"type":"number","format":"double","minimum":0.3,"maximum":0.98},"thresholdTokens":{"type":"integer","minimum":50000}},"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigContextManagementCompaction"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigContextManagementToolResultsPruneMode":{"type":"string","enum":["mask","off"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigContextManagementToolResultsPruneMode"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigContextManagementToolResults":{"type":"object","properties":{"inlineThresholdChars":{"type":"integer","minimum":1024,"description":"Deprecated and ignored. Tool results are never spilled.","deprecated":true},"pruneHotWindowTokens":{"type":"integer","minimum":4000},"pruneMode":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigContextManagementToolResultsPruneMode"}},"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigContextManagementToolResults"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigContextManagement":{"type":"object","properties":{"compaction":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigContextManagementCompaction"},"toolResults":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigContextManagementToolResults"}},"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigContextManagement"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigDurabilityForced":{"type":"string","enum":["durable","in_process"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigDurabilityForced"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigDurability":{"type":"object","properties":{"forced":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigDurabilityForced"},"maxBudgetMs":{"type":["integer","null"],"minimum":1000,"maximum":86400000},"watchLeaseMs":{"type":["integer","null"],"minimum":10000,"maximum":1800000}},"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigDurability"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigErrorHandlingFallbacksItemsOneOf0Type":{"type":"string","enum":["retry"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigErrorHandlingFallbacksItemsOneOf0Type"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigErrorHandlingFallbacksItems0":{"type":"object","properties":{"delay":{"type":"integer","minimum":0,"maximum":60000},"type":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigErrorHandlingFallbacksItemsOneOf0Type"}},"required":["type"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigErrorHandlingFallbacksItems0"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigErrorHandlingFallbacksItemsOneOf1Type":{"type":"string","enum":["model"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigErrorHandlingFallbacksItemsOneOf1Type"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigErrorHandlingFallbacksItems1":{"type":"object","properties":{"delay":{"type":"integer","minimum":0,"maximum":60000},"maxTokens":{"type":"integer","minimum":1},"model":{"type":"string"},"temperature":{"type":"number","format":"double","minimum":0,"maximum":2},"type":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigErrorHandlingFallbacksItemsOneOf1Type"}},"required":["model","type"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigErrorHandlingFallbacksItems1"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigErrorHandlingFallbacksItemsOneOf2Type":{"type":"string","enum":["message"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigErrorHandlingFallbacksItemsOneOf2Type"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigErrorHandlingFallbacksItems2":{"type":"object","properties":{"delay":{"type":"integer","minimum":0,"maximum":60000},"message":{"type":"string"},"type":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigErrorHandlingFallbacksItemsOneOf2Type"}},"required":["message","type"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigErrorHandlingFallbacksItems2"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigErrorHandlingFallbacksItems":{"oneOf":[{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigErrorHandlingFallbacksItems0"},{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigErrorHandlingFallbacksItems1"},{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigErrorHandlingFallbacksItems2"}],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigErrorHandlingFallbacksItems"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigErrorHandlingOnError":{"type":"string","enum":["fail","continue","fallback"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigErrorHandlingOnError"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigErrorHandlingTriggersItemsType":{"type":"string","enum":["error","empty-output"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigErrorHandlingTriggersItemsType"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigErrorHandlingTriggersItems":{"type":"object","properties":{"type":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigErrorHandlingTriggersItemsType"}},"required":["type"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigErrorHandlingTriggersItems"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigErrorHandling":{"type":"object","properties":{"fallbacks":{"type":"array","items":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigErrorHandlingFallbacksItems"}},"onError":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigErrorHandlingOnError"},"triggers":{"type":"array","items":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigErrorHandlingTriggersItems"}}},"required":["onError"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigErrorHandling"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigLoggingPolicy":{"type":"string","enum":["default","on","off"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigLoggingPolicy"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigLoopConfig":{"type":"object","properties":{"enableReflection":{"type":"boolean"},"maxCost":{"type":"number","format":"double","minimum":0},"maxTurns":{"type":"integer","minimum":1,"maximum":100},"reflectionInterval":{"type":"integer","minimum":1,"maximum":50},"treatLengthCutoffAsFailure":{"type":"boolean"}},"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigLoopConfig"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigMemoryPointerScope":{"type":"string","enum":["shared","alias","version"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigMemoryPointerScope"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigMemory":{"type":"object","properties":{"enabled":{"type":"boolean"},"injectSummary":{"type":"boolean"},"pointerScope":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigMemoryPointerScope"},"profileTemplate":{"type":"string"}},"required":["enabled"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigMemory"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigOutputValidatorsItemsOneOf0Type":{"type":"string","enum":["candidate-question","requested-json","no-action","json-schema"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigOutputValidatorsItemsOneOf0Type"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigOutputValidatorsItems0":{"type":"object","properties":{"maxBounces":{"type":"integer","minimum":0,"maximum":10},"schema":{"type":"object","additionalProperties":{"description":"Any type"}},"type":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigOutputValidatorsItemsOneOf0Type"}},"required":["type"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigOutputValidatorsItems0"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigOutputValidatorsItemsOneOf1Type":{"type":"string","enum":["custom"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigOutputValidatorsItemsOneOf1Type"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigOutputValidatorsItems1":{"type":"object","properties":{"maxBounces":{"type":"integer","minimum":0,"maximum":10},"name":{"type":"string","minLength":1,"maxLength":128},"timeoutMs":{"type":"integer","minimum":1,"maximum":300000},"type":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigOutputValidatorsItemsOneOf1Type"}},"required":["name","type"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigOutputValidatorsItems1"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigOutputValidatorsItemsOneOf2Type":{"type":"string","enum":["flow"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigOutputValidatorsItemsOneOf2Type"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigOutputValidatorsItems2":{"type":"object","properties":{"flowId":{"type":"string","minLength":1},"maxBounces":{"type":"integer","minimum":0,"maximum":10},"outputVariable":{"type":"string","minLength":1,"maxLength":128},"timeoutMs":{"type":"integer","minimum":1,"maximum":300000},"type":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigOutputValidatorsItemsOneOf2Type"}},"required":["flowId","type"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigOutputValidatorsItems2"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigOutputValidatorsItemsOneOf3Type":{"type":"string","enum":["tool"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigOutputValidatorsItemsOneOf3Type"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigOutputValidatorsItems3":{"type":"object","properties":{"maxBounces":{"type":"integer","minimum":0,"maximum":10},"timeoutMs":{"type":"integer","minimum":1,"maximum":300000},"toolId":{"type":"string","minLength":1},"type":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigOutputValidatorsItemsOneOf3Type"}},"required":["toolId","type"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigOutputValidatorsItems3"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigOutputValidatorsItems":{"oneOf":[{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigOutputValidatorsItems0"},{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigOutputValidatorsItems1"},{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigOutputValidatorsItems2"},{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigOutputValidatorsItems3"}],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigOutputValidatorsItems"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigOutput":{"type":"object","properties":{"validators":{"type":"array","items":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigOutputValidatorsItems"}}},"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigOutput"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigPiiRedaction":{"type":"string","enum":["default","off","redact"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigPiiRedaction"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigReasoningOneOf1ReasoningEffort":{"type":"string","enum":["minimal","low","medium","high","xhigh","max"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigReasoningOneOf1ReasoningEffort"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigReasoningOneOf1ReasoningSummary":{"type":"string","enum":["auto","detailed"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigReasoningOneOf1ReasoningSummary"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigReasoning1":{"type":"object","properties":{"budgetTokens":{"type":"integer","minimum":1000,"maximum":100000},"effort":{"type":"string","minLength":1,"maxLength":32},"enabled":{"type":"boolean"},"includeThoughts":{"type":"boolean"},"reasoningEffort":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigReasoningOneOf1ReasoningEffort"},"reasoningSummary":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigReasoningOneOf1ReasoningSummary"},"thinkingBudget":{"type":"integer","minimum":1024,"maximum":65536},"thinkingLevel":{"type":"string","minLength":1,"maxLength":32}},"required":["enabled"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigReasoning1"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigReasoning":{"oneOf":[{"type":"boolean"},{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigReasoning1"}],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigReasoning"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigSandboxCodingAgentsItems":{"type":"string","enum":["opencode"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigSandboxCodingAgentsItems"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigSandboxInstanceType":{"type":"string","enum":["standard-1","standard-2","standard-3","standard-4"],"description":"Only standard-4 is supported on the hosted Agent Sandbox path; other sizes cannot be enabled.","title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigSandboxInstanceType"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigSandboxNetworkAccess0":{"type":"string","enum":["none","essentials","open"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigSandboxNetworkAccess0"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigSandboxNetworkAccessOneOf1Profile":{"type":"string","enum":["none","essentials","open"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigSandboxNetworkAccessOneOf1Profile"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigSandboxNetworkAccess1":{"type":"object","properties":{"allow":{"type":"array","items":{"type":"string"}},"profile":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigSandboxNetworkAccessOneOf1Profile"}},"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigSandboxNetworkAccess1"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigSandboxNetworkAccess":{"oneOf":[{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigSandboxNetworkAccess0"},{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigSandboxNetworkAccess1"}],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigSandboxNetworkAccess"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigSandboxPersistence":{"type":"string","enum":["ephemeral","conversation","named"],"description":"Supported: ephemeral or conversation. Named remains parseable for stored configs but cannot be enabled.","title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigSandboxPersistence"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigSandboxProvider":{"type":"string","enum":["runtype-sandbox","daytona"],"description":"Only runtype-sandbox is currently supported. Daytona is retained for stored-config parsing but rejected at authoring/execution.","title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigSandboxProvider"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigSandboxSleepAfter":{"type":"string","enum":["5m","15m","30m","1h"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigSandboxSleepAfter"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigSandboxTtl":{"type":"string","enum":["5m","1h","24h","unlimited"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigSandboxTtl"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigSandbox":{"type":"object","properties":{"codingAgents":{"type":"array","items":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigSandboxCodingAgentsItems"},"description":"Coding agents the Sandbox can run as typed sessions. Non-empty adds the agent_session_* tools; empty or absent adds none."},"enabled":{"type":"boolean"},"instanceType":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigSandboxInstanceType","description":"Only standard-4 is supported on the hosted Agent Sandbox path; other sizes cannot be enabled."},"networkAccess":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigSandboxNetworkAccess"},"persistence":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigSandboxPersistence","description":"Supported: ephemeral or conversation. Named remains parseable for stored configs but cannot be enabled."},"provider":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigSandboxProvider","description":"Only runtype-sandbox is currently supported. Daytona is retained for stored-config parsing but rejected at authoring/execution."},"secretEnv":{"type":"object","additionalProperties":{"type":"string","minLength":1}},"setupCommands":{"type":"array","items":{"type":"string","minLength":1}},"sleepAfter":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigSandboxSleepAfter"},"ttl":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigSandboxTtl"}},"required":["enabled"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigSandbox"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigStateMergeStrategy":{"type":"string","enum":["replace","merge"],"default":"merge","title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigStateMergeStrategy"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigStatePredictStateItems":{"type":"object","properties":{"stateKey":{"type":"string","minLength":1},"tool":{"type":"string","minLength":1},"toolArgument":{"type":"string","minLength":1}},"required":["stateKey","tool","toolArgument"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigStatePredictStateItems"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigState":{"type":"object","properties":{"initial":{"type":"object","additionalProperties":{"description":"Any type"}},"mergeStrategy":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigStateMergeStrategy","default":"merge"},"predictState":{"type":"array","items":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigStatePredictStateItems"}},"schema":{"type":"object","additionalProperties":{"description":"Any type"}}},"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigState"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigTemporal":{"type":"object","properties":{"elapsedThresholdSeconds":{"type":"integer","minimum":0},"groundNow":{"type":"boolean"},"injectElapsed":{"type":"boolean"},"timezone":{"type":"string"}},"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigTemporal"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigTenancyStrategyAssuranceFloorEndUser":{"type":"string","enum":["asserted","verified"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigTenancyStrategyAssuranceFloorEndUser"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigTenancyStrategyAssuranceFloorTenant":{"type":"string","enum":["asserted","verified"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigTenancyStrategyAssuranceFloorTenant"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigTenancyStrategyAssuranceFloor":{"type":"object","properties":{"endUser":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigTenancyStrategyAssuranceFloorEndUser"},"tenant":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigTenancyStrategyAssuranceFloorTenant"}},"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigTenancyStrategyAssuranceFloor"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigTenancyStrategyPreset":{"type":"string","enum":["internal","tenant-isolated","end-user-isolated"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigTenancyStrategyPreset"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigTenancyStrategy":{"type":"object","properties":{"assuranceFloor":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigTenancyStrategyAssuranceFloor"},"preset":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigTenancyStrategyPreset"}},"required":["preset"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigTenancyStrategy"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigToolsApprovalApprover":{"type":"string","enum":["owner","end-user"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigToolsApprovalApprover"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigToolsApprovalChoices":{"type":"object","properties":{"alwaysAllow":{"type":"boolean"},"alwaysDeny":{"type":"boolean"}},"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigToolsApprovalChoices"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigToolsApprovalRequire":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"boolean"}],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigToolsApprovalRequire"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigToolsApproval":{"type":"object","properties":{"approver":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigToolsApprovalApprover"},"choices":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigToolsApprovalChoices"},"notifyUser":{"type":"boolean"},"requestReason":{"type":"boolean"},"require":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigToolsApprovalRequire"},"timeout":{"type":"number","format":"double"}},"required":["require"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigToolsApproval"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigToolsCodeModeConfig":{"type":"object","properties":{"description":{"type":"string"},"timeoutMs":{"type":"integer","minimum":1000,"maximum":600000},"toolPool":{"type":"array","items":{"type":"string"}}},"required":["toolPool"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigToolsCodeModeConfig"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigToolsIntent":{"type":"string","enum":["mandatory","best-effort"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigToolsIntent"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigToolsMcpServersItemsAuthType":{"type":"string","enum":["api_key","bearer","basic","custom_header","headers","none"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigToolsMcpServersItemsAuthType"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigToolsMcpServersItemsAuth":{"type":"object","properties":{"headerName":{"type":"string"},"headers":{"type":"object","additionalProperties":{"type":"string"}},"password":{"type":"string"},"token":{"type":"string"},"type":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigToolsMcpServersItemsAuthType"},"username":{"type":"string"}},"required":["type"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigToolsMcpServersItemsAuth"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigToolsMcpServersItemsTargetKind":{"type":"string","enum":["sandbox-deployment"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigToolsMcpServersItemsTargetKind"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigToolsMcpServersItemsTarget":{"type":"object","properties":{"bearerSecretName":{"type":"string"},"deploymentId":{"type":"string","pattern":"^sbd_[0-9abcdefghjkmnpqrstvwxyz]{20,32}$"},"kind":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigToolsMcpServersItemsTargetKind"},"path":{"type":"string"}},"required":["deploymentId","kind"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigToolsMcpServersItemsTarget"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigToolsMcpServersItemsTransport":{"type":"string","enum":["streamable_http","rest"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigToolsMcpServersItemsTransport"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigToolsMcpServersItems":{"type":"object","properties":{"allowedTools":{"type":"array","items":{"type":"string"}},"auth":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigToolsMcpServersItemsAuth"},"enabled":{"type":"boolean"},"id":{"type":"string"},"identityAudiences":{"type":"array","items":{"type":"string"}},"name":{"type":"string"},"target":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigToolsMcpServersItemsTarget"},"timeout":{"type":"number","format":"double"},"transport":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigToolsMcpServersItemsTransport"},"url":{"type":"string"}},"required":["id"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigToolsMcpServersItems"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigToolsPerToolLimits":{"type":"object","properties":{"maxCalls":{"type":"number","format":"double"},"required":{"type":"boolean"}},"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigToolsPerToolLimits"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigToolsRuntimeToolsItemsToolType":{"type":"string","enum":["flow","custom","external","local","advisor","subagent","search"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigToolsRuntimeToolsItemsToolType"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigToolsRuntimeToolsItems":{"type":"object","properties":{"config":{"type":"object","additionalProperties":{"description":"Any type"}},"description":{"type":"string"},"hiddenParameterNames":{"type":"array","items":{"type":"string","minLength":1}},"idempotent":{"type":"boolean"},"name":{"type":"string"},"parametersSchema":{"type":"object","additionalProperties":{"description":"Any type"}},"toolType":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigToolsRuntimeToolsItemsToolType"}},"required":["config","description","name","parametersSchema","toolType"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigToolsRuntimeToolsItems"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigToolsSubagentConfigDefaultExecutionMode":{"type":"string","enum":["attached","detached"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigToolsSubagentConfigDefaultExecutionMode"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigToolsSubagentConfigDefaultNotify":{"type":"string","enum":["none","narrate","react"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigToolsSubagentConfigDefaultNotify"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigToolsSubagentConfigExecutionModesItems":{"type":"string","enum":["attached","detached"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigToolsSubagentConfigExecutionModesItems"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigToolsSubagentConfig":{"type":"object","properties":{"allowNesting":{"type":"boolean"},"defaultExecutionMode":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigToolsSubagentConfigDefaultExecutionMode"},"defaultMaxTurns":{"type":"integer","minimum":1,"maximum":100},"defaultModel":{"type":"string"},"defaultNotify":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigToolsSubagentConfigDefaultNotify"},"defaultTimeoutMs":{"type":"integer","minimum":1000,"maximum":600000},"detachedMaxBudgetMs":{"type":"integer","minimum":1000,"maximum":86400000},"detachedNoProgressBudgetMs":{"type":"integer","minimum":1000,"maximum":86400000},"executionModes":{"type":"array","items":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigToolsSubagentConfigExecutionModesItems"}},"maxSpawnsPerRun":{"type":"integer","minimum":1,"maximum":50},"maxTurnsLimit":{"type":"integer","minimum":1,"maximum":100},"toolPool":{"type":"array","items":{"type":"string"}}},"required":["toolPool"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigToolsSubagentConfig"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigToolsToolCallStrategy":{"type":"string","enum":["auto","required","none"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigToolsToolCallStrategy"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigToolsToolSearch":{"type":"object","properties":{"alwaysLoaded":{"type":"array","items":{"type":"string"}},"enabled":{"type":"boolean"},"threshold":{"type":"number","format":"double"}},"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigToolsToolSearch"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigTools":{"type":"object","properties":{"approval":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigToolsApproval"},"codeModeConfig":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigToolsCodeModeConfig"},"intent":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigToolsIntent"},"maxToolCalls":{"type":"integer","minimum":1,"maximum":100},"mcpServers":{"type":"array","items":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigToolsMcpServersItems"}},"perToolLimits":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigToolsPerToolLimits"}},"runtimeTools":{"type":"array","items":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigToolsRuntimeToolsItems"}},"subagentConfig":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigToolsSubagentConfig"},"toolCallStrategy":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigToolsToolCallStrategy"},"toolConfigs":{"type":"object","additionalProperties":{"type":"object","additionalProperties":{"description":"Any type"}}},"toolIds":{"type":"array","items":{"type":"string"}},"toolSearch":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigToolsToolSearch"}},"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigTools"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigVoiceDirectTools":{"type":"object","properties":{"enabled":{"type":"boolean"},"model":{"type":"string","minLength":1}},"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigVoiceDirectTools"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigVoiceElevenLabs":{"type":"object","properties":{"modelId":{"type":"string","minLength":1},"similarity":{"type":"number","format":"double","minimum":0,"maximum":1},"stability":{"type":"number","format":"double","minimum":0,"maximum":1},"voiceId":{"type":"string","minLength":1}},"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigVoiceElevenLabs"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigVoiceEndpointingStrategy":{"type":"string","enum":["provider_vad","server_vad","client_commit","manual"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigVoiceEndpointingStrategy"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigVoiceEndpointing":{"type":"object","properties":{"silenceMs":{"type":"integer","minimum":0,"maximum":30000},"strategy":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigVoiceEndpointingStrategy"}},"required":["strategy"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigVoiceEndpointing"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigVoiceInterruptionMode":{"type":"string","enum":["none","cancel","barge-in"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigVoiceInterruptionMode"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigVoiceSpeechMode":{"type":"string","enum":["pipeline","speech_to_speech","provider_managed"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigVoiceSpeechMode"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigVoiceSpeechSynthesizerSettings":{"type":"object","properties":{"similarity":{"type":"number","format":"double","minimum":0,"maximum":1},"stability":{"type":"number","format":"double","minimum":0,"maximum":1}},"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigVoiceSpeechSynthesizerSettings"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigVoiceSpeechSynthesizer":{"type":"object","properties":{"model":{"type":"string","minLength":1},"provider":{"type":"string","minLength":1},"settings":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigVoiceSpeechSynthesizerSettings"},"voiceId":{"type":"string","minLength":1}},"required":["provider"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigVoiceSpeechSynthesizer"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigVoiceSpeechTranscriber":{"type":"object","properties":{"model":{"type":"string","minLength":1},"provider":{"type":"string","minLength":1}},"required":["provider"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigVoiceSpeechTranscriber"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigVoiceSpeech":{"type":"object","properties":{"mode":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigVoiceSpeechMode"},"synthesizer":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigVoiceSpeechSynthesizer"},"transcriber":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigVoiceSpeechTranscriber"}},"required":["mode","synthesizer","transcriber"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigVoiceSpeech"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigVoice":{"type":"object","properties":{"directTools":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigVoiceDirectTools"},"disclosure":{"type":"boolean"},"elevenLabs":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigVoiceElevenLabs"},"enabled":{"type":"boolean"},"endpointing":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigVoiceEndpointing"},"greeting":{"type":"string","maxLength":2000},"interruptionMode":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigVoiceInterruptionMode"},"language":{"type":"string","minLength":1,"maxLength":64},"provider":{"type":"string","minLength":1},"speech":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigVoiceSpeech"}},"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigVoice"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfig":{"type":"object","properties":{"advisor":{"oneOf":[{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigAdvisor"},{"type":"null"}]},"artifacts":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigArtifacts"},"busyMessageRouting":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigBusyMessageRouting"},"contextManagement":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigContextManagement"},"durability":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigDurability"},"errorHandling":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigErrorHandling"},"frequencyPenalty":{"type":"number","format":"double","minimum":-2,"maximum":2},"loggingPolicy":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigLoggingPolicy"},"loopConfig":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigLoopConfig"},"maxTokens":{"type":"integer","minimum":1},"memory":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigMemory"},"model":{"type":"string"},"output":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigOutput"},"piiRedaction":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigPiiRedaction"},"presencePenalty":{"type":"number","format":"double","minimum":-2,"maximum":2},"reasoning":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigReasoning"},"sandbox":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigSandbox"},"seed":{"type":"integer"},"state":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigState"},"systemPrompt":{"type":"string"},"temperature":{"type":"number","format":"double","minimum":0,"maximum":2},"temporal":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigTemporal"},"tenancyStrategy":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigTenancyStrategy"},"tools":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigTools"},"topK":{"type":"integer","minimum":1,"maximum":500},"topP":{"type":"number","format":"double","minimum":0,"maximum":1},"voice":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaConfigVoice"}},"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaConfig"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaExternalConfigAuthType":{"type":"string","enum":["none","bearer","api_key","basic"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaExternalConfigAuthType"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaExternalConfigAuth":{"type":"object","properties":{"credentials":{"type":"string"},"headerName":{"type":"string"},"type":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaExternalConfigAuthType"}},"required":["type"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaExternalConfigAuth"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaExternalConfigCachedAgentCardCapabilitiesStatefulness":{"type":"string","enum":["none","task","session"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaExternalConfigCachedAgentCardCapabilitiesStatefulness"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaExternalConfigCachedAgentCardCapabilities":{"type":"object","properties":{"pushNotifications":{"type":"boolean"},"statefulness":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaExternalConfigCachedAgentCardCapabilitiesStatefulness"},"streaming":{"type":"boolean"}},"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaExternalConfigCachedAgentCardCapabilities"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaExternalConfigCachedAgentCardSkillsItems":{"type":"object","properties":{"description":{"type":"string"},"id":{"type":"string"},"inputSchema":{"type":"object","additionalProperties":{"description":"Any type"}},"name":{"type":"string"},"outputSchema":{"type":"object","additionalProperties":{"description":"Any type"}}},"required":["id","name"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaExternalConfigCachedAgentCardSkillsItems"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaExternalConfigCachedAgentCard":{"type":"object","properties":{"capabilities":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaExternalConfigCachedAgentCardCapabilities"},"description":{"type":"string"},"fetchedAt":{"type":"string"},"name":{"type":"string"},"protocolVersion":{"type":"string"},"skills":{"type":"array","items":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaExternalConfigCachedAgentCardSkillsItems"}},"version":{"type":"string"}},"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaExternalConfigCachedAgentCard"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaExternalConfigFramework":{"type":"string","enum":["langchain","vercel_ai","crewai","cloudflare","autogen","flue","mastra","custom"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaExternalConfigFramework"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaExternalConfigProtocol":{"type":"string","enum":["a2a","runtype-stream"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaExternalConfigProtocol"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaExternalConfigSkillOrchestration0":{"type":"string","enum":["delegate","managed"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaExternalConfigSkillOrchestration0"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaExternalConfigSkillOrchestration1":{"type":"string","enum":["agent_skill","runtype","none"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaExternalConfigSkillOrchestration1"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaExternalConfigSkillOrchestration":{"oneOf":[{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaExternalConfigSkillOrchestration0"},{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaExternalConfigSkillOrchestration1"}],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaExternalConfigSkillOrchestration"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaExternalConfigSkillOrchestratorReasoningOneOf1ReasoningEffort":{"type":"string","enum":["minimal","low","medium","high","xhigh","max"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaExternalConfigSkillOrchestratorReasoningOneOf1ReasoningEffort"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaExternalConfigSkillOrchestratorReasoningOneOf1ReasoningSummary":{"type":"string","enum":["auto","detailed"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaExternalConfigSkillOrchestratorReasoningOneOf1ReasoningSummary"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaExternalConfigSkillOrchestratorReasoning1":{"type":"object","properties":{"budgetTokens":{"type":"integer","minimum":1000,"maximum":100000},"effort":{"type":"string","minLength":1,"maxLength":32},"enabled":{"type":"boolean"},"includeThoughts":{"type":"boolean"},"reasoningEffort":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaExternalConfigSkillOrchestratorReasoningOneOf1ReasoningEffort"},"reasoningSummary":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaExternalConfigSkillOrchestratorReasoningOneOf1ReasoningSummary"},"thinkingBudget":{"type":"integer","minimum":1024,"maximum":65536},"thinkingLevel":{"type":"string","minLength":1,"maxLength":32}},"required":["enabled"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaExternalConfigSkillOrchestratorReasoning1"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaExternalConfigSkillOrchestratorReasoning":{"oneOf":[{"type":"boolean"},{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaExternalConfigSkillOrchestratorReasoning1"}],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaExternalConfigSkillOrchestratorReasoning"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaExternalConfigSkillOrchestrator":{"type":"object","properties":{"frequencyPenalty":{"type":"number","format":"double","minimum":-2,"maximum":2},"model":{"type":"string"},"presencePenalty":{"type":"number","format":"double","minimum":-2,"maximum":2},"reasoning":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaExternalConfigSkillOrchestratorReasoning"},"seed":{"type":"integer"},"systemPrompt":{"type":"string"},"temperature":{"type":"number","format":"double","minimum":0,"maximum":1},"topK":{"type":"integer","minimum":1,"maximum":500},"topP":{"type":"number","format":"double","minimum":0,"maximum":1}},"required":["model"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaExternalConfigSkillOrchestrator"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaExternalConfigSkillsOverrideItemsRole":{"type":"string","enum":["orchestrator","tool","standalone","hidden"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaExternalConfigSkillsOverrideItemsRole"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaExternalConfigSkillsOverrideItems":{"type":"object","properties":{"enabled":{"type":"boolean"},"exposedDescription":{"type":"string"},"exposedName":{"type":"string"},"id":{"type":"string"},"isNew":{"type":"boolean"},"role":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaExternalConfigSkillsOverrideItemsRole"}},"required":["enabled","id"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaExternalConfigSkillsOverrideItems"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaExternalConfigTransport":{"type":"string","enum":["http","device"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaExternalConfigTransport"},"V1AgentsPostRequestBodyContentApplicationJsonSchemaExternalConfig":{"type":"object","properties":{"agentCardUrl":{"type":"string","format":"uri"},"auth":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaExternalConfigAuth"},"cachedAgentCard":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaExternalConfigCachedAgentCard"},"deviceId":{"type":"string","minLength":1,"maxLength":128},"endpoint":{"type":"string","format":"uri"},"framework":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaExternalConfigFramework"},"identityAssertion":{"type":"boolean","description":"Send a short-lived, Runtype-signed identity assertion (ES256 JWT, `aud` = endpoint host) in the `X-Runtype-Identity` header. Requires a tenancy strategy and a resolved tenant or end user; a call without one is refused before it reaches the agent."},"protocol":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaExternalConfigProtocol"},"retryCount":{"type":"integer","minimum":0,"maximum":10},"skillOrchestration":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaExternalConfigSkillOrchestration"},"skillOrchestrator":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaExternalConfigSkillOrchestrator"},"skillsOverride":{"type":"array","items":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaExternalConfigSkillsOverrideItems"}},"timeoutMs":{"type":"integer","minimum":1000,"maximum":300000},"transport":{"$ref":"#/components/schemas/V1AgentsPostRequestBodyContentApplicationJsonSchemaExternalConfigTransport"}},"required":["endpoint"],"title":"V1AgentsPostRequestBodyContentApplicationJsonSchemaExternalConfig"},"V1AgentsPostResponsesContentApplicationJsonSchemaCapabilitiesItems":{"type":"object","properties":{"agentId":{"type":"string"},"createdAt":{"type":"string"},"displayOrder":{"type":["integer","null"]},"enabled":{"type":"boolean"},"flowId":{"type":["string","null"]},"id":{"type":"string"},"parametersSchema":{"description":"Any type"},"subAgentId":{"type":["string","null"]},"toolDescription":{"type":["string","null"]},"toolId":{"type":["string","null"]},"toolName":{"type":"string"}},"required":["displayOrder","enabled","flowId","id","subAgentId","toolDescription","toolId","toolName"],"title":"V1AgentsPostResponsesContentApplicationJsonSchemaCapabilitiesItems"},"V1AgentsPostResponsesContentApplicationJsonSchemaSandboxCapabilityIssuesItemsCode":{"type":"string","enum":["unsupported_sandbox_capability"],"title":"V1AgentsPostResponsesContentApplicationJsonSchemaSandboxCapabilityIssuesItemsCode"},"V1AgentsPostResponsesContentApplicationJsonSchemaSandboxCapabilityIssuesItems":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/V1AgentsPostResponsesContentApplicationJsonSchemaSandboxCapabilityIssuesItemsCode"},"message":{"type":"string"},"path":{"type":"string"},"requested":{"type":"string"},"supported":{"type":"array","items":{"type":"string"}}},"required":["code","message","path","requested","supported"],"title":"V1AgentsPostResponsesContentApplicationJsonSchemaSandboxCapabilityIssuesItems"},"Agents_createAgent_Response_201":{"type":"object","properties":{"_warnings":{"type":"array","items":{"type":"string"}},"agentType":{"type":"string"},"capabilities":{"type":"array","items":{"$ref":"#/components/schemas/V1AgentsPostResponsesContentApplicationJsonSchemaCapabilitiesItems"}},"claudeManagedConfig":{"type":["object","null"],"additionalProperties":{"description":"Any type"}},"config":{"type":["object","null"],"additionalProperties":{"description":"Any type"}},"configHash":{"type":["string","null"]},"createdAt":{"type":"string"},"dashboardUrl":{"type":"string"},"description":{"type":["string","null"]},"draftVersionId":{"type":["string","null"]},"externalConfig":{"type":["object","null"],"additionalProperties":{"description":"Any type"},"description":"External-agent configuration. Configured auth.credentials values are write-only and returned as <redacted>, never plaintext."},"healthStatus":{"type":["string","null"]},"icon":{"type":["string","null"]},"id":{"type":"string"},"lastHealthCheckAt":{"type":["string","null"]},"lastModifiedSource":{"type":["string","null"]},"name":{"type":"string"},"organizationId":{"type":["string","null"]},"publishedVersionId":{"type":["string","null"]},"sandboxCapabilityIssues":{"type":"array","items":{"$ref":"#/components/schemas/V1AgentsPostResponsesContentApplicationJsonSchemaSandboxCapabilityIssuesItems"}},"status":{"type":"string"},"updatedAt":{"type":"string"},"userId":{"type":"string"}},"required":["agentType","capabilities","claudeManagedConfig","config","configHash","createdAt","description","draftVersionId","externalConfig","healthStatus","icon","id","lastHealthCheckAt","lastModifiedSource","name","organizationId","publishedVersionId","status","updatedAt","userId"],"title":"Agents_createAgent_Response_201"},"AgentEnsureCapability":{"type":"object","properties":{"agent":{"type":"string","minLength":1,"description":"The name of another agent in this account scope, called as a sub-agent."},"description":{"type":"string"},"enabled":{"type":"boolean","description":"Defaults to true."},"flow":{"type":"string","minLength":1,"description":"The name of a flow in this account scope."},"parametersSchema":{"type":"object","additionalProperties":{"description":"Any type"},"description":"JSON Schema for the capability's input. Omit to derive it from the flow's inputs or the tool's own schema."},"tool":{"type":"string","minLength":1,"description":"The name of a saved tool in this account scope."},"toolName":{"type":"string","minLength":1,"maxLength":100,"description":"The name the agent calls this capability by."}},"required":["toolName"],"title":"AgentEnsureCapability"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigAdvisor":{"type":"object","properties":{"model":{"type":"string"},"systemPrompt":{"type":"string"}},"required":["model"],"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigAdvisor"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigArtifactsTypesItems":{"type":"string","enum":["markdown","component"],"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigArtifactsTypesItems"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigArtifacts":{"type":"object","properties":{"enabled":{"type":"boolean"},"types":{"type":"array","items":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigArtifactsTypesItems"}}},"required":["enabled","types"],"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigArtifacts"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigBusyMessageRoutingMode":{"type":"string","enum":["enforced","off"],"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigBusyMessageRoutingMode"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigBusyMessageRouting":{"type":"object","properties":{"classifierModel":{"type":"string","minLength":1,"maxLength":200},"mode":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigBusyMessageRoutingMode"}},"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigBusyMessageRouting"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigContextManagementCompactionStrategy":{"type":"string","enum":["auto","provider_native","summary"],"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigContextManagementCompactionStrategy"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigContextManagementCompaction":{"type":"object","properties":{"enabled":{"type":"boolean"},"instructions":{"type":"string","maxLength":4000},"model":{"type":"string"},"retainRecentTokens":{"type":"integer","minimum":0},"strategy":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigContextManagementCompactionStrategy"},"thresholdRatio":{"type":"number","format":"double","minimum":0.3,"maximum":0.98},"thresholdTokens":{"type":"integer","minimum":50000}},"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigContextManagementCompaction"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigContextManagementToolResultsPruneMode":{"type":"string","enum":["mask","off"],"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigContextManagementToolResultsPruneMode"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigContextManagementToolResults":{"type":"object","properties":{"inlineThresholdChars":{"type":"integer","minimum":1024,"description":"Deprecated and ignored. Tool results are never spilled.","deprecated":true},"pruneHotWindowTokens":{"type":"integer","minimum":4000},"pruneMode":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigContextManagementToolResultsPruneMode"}},"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigContextManagementToolResults"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigContextManagement":{"type":"object","properties":{"compaction":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigContextManagementCompaction"},"toolResults":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigContextManagementToolResults"}},"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigContextManagement"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigDurabilityForced":{"type":"string","enum":["durable","in_process"],"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigDurabilityForced"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigDurability":{"type":"object","properties":{"forced":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigDurabilityForced"},"maxBudgetMs":{"type":["integer","null"],"minimum":1000,"maximum":86400000},"watchLeaseMs":{"type":["integer","null"],"minimum":10000,"maximum":1800000}},"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigDurability"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigErrorHandlingFallbacksItemsOneOf0Type":{"type":"string","enum":["retry"],"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigErrorHandlingFallbacksItemsOneOf0Type"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigErrorHandlingFallbacksItems0":{"type":"object","properties":{"delay":{"type":"integer","minimum":0,"maximum":60000},"type":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigErrorHandlingFallbacksItemsOneOf0Type"}},"required":["type"],"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigErrorHandlingFallbacksItems0"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigErrorHandlingFallbacksItemsOneOf1Type":{"type":"string","enum":["model"],"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigErrorHandlingFallbacksItemsOneOf1Type"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigErrorHandlingFallbacksItems1":{"type":"object","properties":{"delay":{"type":"integer","minimum":0,"maximum":60000},"maxTokens":{"type":"integer","minimum":1},"model":{"type":"string"},"temperature":{"type":"number","format":"double","minimum":0,"maximum":2},"type":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigErrorHandlingFallbacksItemsOneOf1Type"}},"required":["model","type"],"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigErrorHandlingFallbacksItems1"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigErrorHandlingFallbacksItemsOneOf2Type":{"type":"string","enum":["message"],"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigErrorHandlingFallbacksItemsOneOf2Type"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigErrorHandlingFallbacksItems2":{"type":"object","properties":{"delay":{"type":"integer","minimum":0,"maximum":60000},"message":{"type":"string"},"type":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigErrorHandlingFallbacksItemsOneOf2Type"}},"required":["message","type"],"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigErrorHandlingFallbacksItems2"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigErrorHandlingFallbacksItems":{"oneOf":[{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigErrorHandlingFallbacksItems0"},{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigErrorHandlingFallbacksItems1"},{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigErrorHandlingFallbacksItems2"}],"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigErrorHandlingFallbacksItems"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigErrorHandlingOnError":{"type":"string","enum":["fail","continue","fallback"],"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigErrorHandlingOnError"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigErrorHandlingTriggersItemsType":{"type":"string","enum":["error","empty-output"],"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigErrorHandlingTriggersItemsType"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigErrorHandlingTriggersItems":{"type":"object","properties":{"type":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigErrorHandlingTriggersItemsType"}},"required":["type"],"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigErrorHandlingTriggersItems"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigErrorHandling":{"type":"object","properties":{"fallbacks":{"type":"array","items":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigErrorHandlingFallbacksItems"}},"onError":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigErrorHandlingOnError"},"triggers":{"type":"array","items":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigErrorHandlingTriggersItems"}}},"required":["onError"],"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigErrorHandling"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigLoggingPolicy":{"type":"string","enum":["default","on","off"],"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigLoggingPolicy"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigLoopConfig":{"type":"object","properties":{"enableReflection":{"type":"boolean"},"maxCost":{"type":"number","format":"double","minimum":0},"maxTurns":{"type":"integer","minimum":1,"maximum":100},"reflectionInterval":{"type":"integer","minimum":1,"maximum":50},"treatLengthCutoffAsFailure":{"type":"boolean"}},"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigLoopConfig"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigMemoryPointerScope":{"type":"string","enum":["shared","alias","version"],"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigMemoryPointerScope"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigMemory":{"type":"object","properties":{"enabled":{"type":"boolean"},"injectSummary":{"type":"boolean"},"pointerScope":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigMemoryPointerScope"},"profileTemplate":{"type":"string"}},"required":["enabled"],"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigMemory"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigOutputValidatorsItemsOneOf0Type":{"type":"string","enum":["candidate-question","requested-json","no-action","json-schema"],"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigOutputValidatorsItemsOneOf0Type"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigOutputValidatorsItems0":{"type":"object","properties":{"maxBounces":{"type":"integer","minimum":0,"maximum":10},"schema":{"type":"object","additionalProperties":{"description":"Any type"}},"type":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigOutputValidatorsItemsOneOf0Type"}},"required":["type"],"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigOutputValidatorsItems0"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigOutputValidatorsItemsOneOf1Type":{"type":"string","enum":["custom"],"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigOutputValidatorsItemsOneOf1Type"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigOutputValidatorsItems1":{"type":"object","properties":{"maxBounces":{"type":"integer","minimum":0,"maximum":10},"name":{"type":"string","minLength":1,"maxLength":128},"timeoutMs":{"type":"integer","minimum":1,"maximum":300000},"type":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigOutputValidatorsItemsOneOf1Type"}},"required":["name","type"],"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigOutputValidatorsItems1"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigOutputValidatorsItemsOneOf2Type":{"type":"string","enum":["flow"],"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigOutputValidatorsItemsOneOf2Type"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigOutputValidatorsItems2":{"type":"object","properties":{"flowId":{"type":"string","minLength":1},"maxBounces":{"type":"integer","minimum":0,"maximum":10},"outputVariable":{"type":"string","minLength":1,"maxLength":128},"timeoutMs":{"type":"integer","minimum":1,"maximum":300000},"type":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigOutputValidatorsItemsOneOf2Type"}},"required":["flowId","type"],"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigOutputValidatorsItems2"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigOutputValidatorsItemsOneOf3Type":{"type":"string","enum":["tool"],"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigOutputValidatorsItemsOneOf3Type"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigOutputValidatorsItems3":{"type":"object","properties":{"maxBounces":{"type":"integer","minimum":0,"maximum":10},"timeoutMs":{"type":"integer","minimum":1,"maximum":300000},"toolId":{"type":"string","minLength":1},"type":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigOutputValidatorsItemsOneOf3Type"}},"required":["toolId","type"],"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigOutputValidatorsItems3"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigOutputValidatorsItems":{"oneOf":[{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigOutputValidatorsItems0"},{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigOutputValidatorsItems1"},{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigOutputValidatorsItems2"},{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigOutputValidatorsItems3"}],"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigOutputValidatorsItems"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigOutput":{"type":"object","properties":{"validators":{"type":"array","items":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigOutputValidatorsItems"}}},"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigOutput"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigPiiRedaction":{"type":"string","enum":["default","off","redact"],"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigPiiRedaction"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigReasoningOneOf1ReasoningEffort":{"type":"string","enum":["minimal","low","medium","high","xhigh","max"],"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigReasoningOneOf1ReasoningEffort"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigReasoningOneOf1ReasoningSummary":{"type":"string","enum":["auto","detailed"],"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigReasoningOneOf1ReasoningSummary"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigReasoning1":{"type":"object","properties":{"budgetTokens":{"type":"integer","minimum":1000,"maximum":100000},"effort":{"type":"string","minLength":1,"maxLength":32},"enabled":{"type":"boolean"},"includeThoughts":{"type":"boolean"},"reasoningEffort":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigReasoningOneOf1ReasoningEffort"},"reasoningSummary":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigReasoningOneOf1ReasoningSummary"},"thinkingBudget":{"type":"integer","minimum":1024,"maximum":65536},"thinkingLevel":{"type":"string","minLength":1,"maxLength":32}},"required":["enabled"],"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigReasoning1"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigReasoning":{"oneOf":[{"type":"boolean"},{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigReasoning1"}],"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigReasoning"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigSandboxCodingAgentsItems":{"type":"string","enum":["opencode"],"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigSandboxCodingAgentsItems"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigSandboxInstanceType":{"type":"string","enum":["standard-1","standard-2","standard-3","standard-4"],"description":"Only standard-4 is supported on the hosted Agent Sandbox path; other sizes cannot be enabled.","title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigSandboxInstanceType"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigSandboxNetworkAccess0":{"type":"string","enum":["none","essentials","open"],"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigSandboxNetworkAccess0"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigSandboxNetworkAccessOneOf1Profile":{"type":"string","enum":["none","essentials","open"],"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigSandboxNetworkAccessOneOf1Profile"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigSandboxNetworkAccess1":{"type":"object","properties":{"allow":{"type":"array","items":{"type":"string"}},"profile":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigSandboxNetworkAccessOneOf1Profile"}},"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigSandboxNetworkAccess1"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigSandboxNetworkAccess":{"oneOf":[{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigSandboxNetworkAccess0"},{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigSandboxNetworkAccess1"}],"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigSandboxNetworkAccess"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigSandboxPersistence":{"type":"string","enum":["ephemeral","conversation","named"],"description":"Supported: ephemeral or conversation. Named remains parseable for stored configs but cannot be enabled.","title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigSandboxPersistence"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigSandboxProvider":{"type":"string","enum":["runtype-sandbox","daytona"],"description":"Only runtype-sandbox is currently supported. Daytona is retained for stored-config parsing but rejected at authoring/execution.","title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigSandboxProvider"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigSandboxSleepAfter":{"type":"string","enum":["5m","15m","30m","1h"],"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigSandboxSleepAfter"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigSandboxTtl":{"type":"string","enum":["5m","1h","24h","unlimited"],"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigSandboxTtl"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigSandbox":{"type":"object","properties":{"codingAgents":{"type":"array","items":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigSandboxCodingAgentsItems"},"description":"Coding agents the Sandbox can run as typed sessions. Non-empty adds the agent_session_* tools; empty or absent adds none."},"enabled":{"type":"boolean"},"instanceType":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigSandboxInstanceType","description":"Only standard-4 is supported on the hosted Agent Sandbox path; other sizes cannot be enabled."},"networkAccess":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigSandboxNetworkAccess"},"persistence":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigSandboxPersistence","description":"Supported: ephemeral or conversation. Named remains parseable for stored configs but cannot be enabled."},"provider":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigSandboxProvider","description":"Only runtype-sandbox is currently supported. Daytona is retained for stored-config parsing but rejected at authoring/execution."},"secretEnv":{"type":"object","additionalProperties":{"type":"string","minLength":1}},"setupCommands":{"type":"array","items":{"type":"string","minLength":1}},"sleepAfter":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigSandboxSleepAfter"},"ttl":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigSandboxTtl"}},"required":["enabled"],"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigSandbox"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigStateMergeStrategy":{"type":"string","enum":["replace","merge"],"default":"merge","title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigStateMergeStrategy"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigStatePredictStateItems":{"type":"object","properties":{"stateKey":{"type":"string","minLength":1},"tool":{"type":"string","minLength":1},"toolArgument":{"type":"string","minLength":1}},"required":["stateKey","tool","toolArgument"],"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigStatePredictStateItems"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigState":{"type":"object","properties":{"initial":{"type":"object","additionalProperties":{"description":"Any type"}},"mergeStrategy":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigStateMergeStrategy","default":"merge"},"predictState":{"type":"array","items":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigStatePredictStateItems"}},"schema":{"type":"object","additionalProperties":{"description":"Any type"}}},"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigState"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigTemporal":{"type":"object","properties":{"elapsedThresholdSeconds":{"type":"integer","minimum":0},"groundNow":{"type":"boolean"},"injectElapsed":{"type":"boolean"},"timezone":{"type":"string"}},"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigTemporal"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigTenancyStrategyAssuranceFloorEndUser":{"type":"string","enum":["asserted","verified"],"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigTenancyStrategyAssuranceFloorEndUser"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigTenancyStrategyAssuranceFloorTenant":{"type":"string","enum":["asserted","verified"],"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigTenancyStrategyAssuranceFloorTenant"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigTenancyStrategyAssuranceFloor":{"type":"object","properties":{"endUser":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigTenancyStrategyAssuranceFloorEndUser"},"tenant":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigTenancyStrategyAssuranceFloorTenant"}},"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigTenancyStrategyAssuranceFloor"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigTenancyStrategyPreset":{"type":"string","enum":["internal","tenant-isolated","end-user-isolated"],"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigTenancyStrategyPreset"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigTenancyStrategy":{"type":"object","properties":{"assuranceFloor":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigTenancyStrategyAssuranceFloor"},"preset":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigTenancyStrategyPreset"}},"required":["preset"],"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigTenancyStrategy"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigToolsApprovalApprover":{"type":"string","enum":["owner","end-user"],"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigToolsApprovalApprover"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigToolsApprovalChoices":{"type":"object","properties":{"alwaysAllow":{"type":"boolean"},"alwaysDeny":{"type":"boolean"}},"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigToolsApprovalChoices"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigToolsApprovalRequire":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"boolean"}],"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigToolsApprovalRequire"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigToolsApproval":{"type":"object","properties":{"approver":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigToolsApprovalApprover"},"choices":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigToolsApprovalChoices"},"notifyUser":{"type":"boolean"},"requestReason":{"type":"boolean"},"require":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigToolsApprovalRequire"},"timeout":{"type":"number","format":"double"}},"required":["require"],"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigToolsApproval"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigToolsCodeModeConfig":{"type":"object","properties":{"description":{"type":"string"},"timeoutMs":{"type":"integer","minimum":1000,"maximum":600000},"toolPool":{"type":"array","items":{"type":"string"}}},"required":["toolPool"],"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigToolsCodeModeConfig"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigToolsIntent":{"type":"string","enum":["mandatory","best-effort"],"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigToolsIntent"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigToolsMcpServersItemsAuthType":{"type":"string","enum":["api_key","bearer","basic","custom_header","headers","none"],"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigToolsMcpServersItemsAuthType"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigToolsMcpServersItemsAuth":{"type":"object","properties":{"headerName":{"type":"string"},"headers":{"type":"object","additionalProperties":{"type":"string"}},"password":{"type":"string"},"token":{"type":"string"},"type":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigToolsMcpServersItemsAuthType"},"username":{"type":"string"}},"required":["type"],"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigToolsMcpServersItemsAuth"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigToolsMcpServersItemsTargetKind":{"type":"string","enum":["sandbox-deployment"],"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigToolsMcpServersItemsTargetKind"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigToolsMcpServersItemsTarget":{"type":"object","properties":{"bearerSecretName":{"type":"string"},"deploymentId":{"type":"string","pattern":"^sbd_[0-9abcdefghjkmnpqrstvwxyz]{20,32}$"},"kind":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigToolsMcpServersItemsTargetKind"},"path":{"type":"string"}},"required":["deploymentId","kind"],"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigToolsMcpServersItemsTarget"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigToolsMcpServersItemsTransport":{"type":"string","enum":["streamable_http","rest"],"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigToolsMcpServersItemsTransport"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigToolsMcpServersItems":{"type":"object","properties":{"allowedTools":{"type":"array","items":{"type":"string"}},"auth":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigToolsMcpServersItemsAuth"},"enabled":{"type":"boolean"},"id":{"type":"string"},"identityAudiences":{"type":"array","items":{"type":"string"}},"name":{"type":"string"},"target":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigToolsMcpServersItemsTarget"},"timeout":{"type":"number","format":"double"},"transport":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigToolsMcpServersItemsTransport"},"url":{"type":"string"}},"required":["id"],"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigToolsMcpServersItems"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigToolsPerToolLimits":{"type":"object","properties":{"maxCalls":{"type":"number","format":"double"},"required":{"type":"boolean"}},"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigToolsPerToolLimits"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigToolsRuntimeToolsItemsToolType":{"type":"string","enum":["flow","custom","external","local","advisor","subagent","search"],"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigToolsRuntimeToolsItemsToolType"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigToolsRuntimeToolsItems":{"type":"object","properties":{"config":{"type":"object","additionalProperties":{"description":"Any type"}},"description":{"type":"string"},"hiddenParameterNames":{"type":"array","items":{"type":"string","minLength":1}},"idempotent":{"type":"boolean"},"name":{"type":"string"},"parametersSchema":{"type":"object","additionalProperties":{"description":"Any type"}},"toolType":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigToolsRuntimeToolsItemsToolType"}},"required":["config","description","name","parametersSchema","toolType"],"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigToolsRuntimeToolsItems"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigToolsSubagentConfigDefaultExecutionMode":{"type":"string","enum":["attached","detached"],"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigToolsSubagentConfigDefaultExecutionMode"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigToolsSubagentConfigDefaultNotify":{"type":"string","enum":["none","narrate","react"],"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigToolsSubagentConfigDefaultNotify"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigToolsSubagentConfigExecutionModesItems":{"type":"string","enum":["attached","detached"],"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigToolsSubagentConfigExecutionModesItems"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigToolsSubagentConfig":{"type":"object","properties":{"allowNesting":{"type":"boolean"},"defaultExecutionMode":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigToolsSubagentConfigDefaultExecutionMode"},"defaultMaxTurns":{"type":"integer","minimum":1,"maximum":100},"defaultModel":{"type":"string"},"defaultNotify":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigToolsSubagentConfigDefaultNotify"},"defaultTimeoutMs":{"type":"integer","minimum":1000,"maximum":600000},"detachedMaxBudgetMs":{"type":"integer","minimum":1000,"maximum":86400000},"detachedNoProgressBudgetMs":{"type":"integer","minimum":1000,"maximum":86400000},"executionModes":{"type":"array","items":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigToolsSubagentConfigExecutionModesItems"}},"maxSpawnsPerRun":{"type":"integer","minimum":1,"maximum":50},"maxTurnsLimit":{"type":"integer","minimum":1,"maximum":100},"toolPool":{"type":"array","items":{"type":"string"}}},"required":["toolPool"],"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigToolsSubagentConfig"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigToolsToolCallStrategy":{"type":"string","enum":["auto","required","none"],"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigToolsToolCallStrategy"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigToolsToolSearch":{"type":"object","properties":{"alwaysLoaded":{"type":"array","items":{"type":"string"}},"enabled":{"type":"boolean"},"threshold":{"type":"number","format":"double"}},"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigToolsToolSearch"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigTools":{"type":"object","properties":{"approval":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigToolsApproval"},"codeModeConfig":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigToolsCodeModeConfig"},"intent":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigToolsIntent"},"maxToolCalls":{"type":"integer","minimum":1,"maximum":100},"mcpServers":{"type":"array","items":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigToolsMcpServersItems"}},"perToolLimits":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigToolsPerToolLimits"}},"runtimeTools":{"type":"array","items":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigToolsRuntimeToolsItems"}},"subagentConfig":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigToolsSubagentConfig"},"toolCallStrategy":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigToolsToolCallStrategy"},"toolConfigs":{"type":"object","additionalProperties":{"type":"object","additionalProperties":{"description":"Any type"}}},"toolIds":{"type":"array","items":{"type":"string"}},"toolSearch":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigToolsToolSearch"}},"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigTools"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigVoiceDirectTools":{"type":"object","properties":{"enabled":{"type":"boolean"},"model":{"type":"string","minLength":1}},"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigVoiceDirectTools"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigVoiceElevenLabs":{"type":"object","properties":{"modelId":{"type":"string","minLength":1},"similarity":{"type":"number","format":"double","minimum":0,"maximum":1},"stability":{"type":"number","format":"double","minimum":0,"maximum":1},"voiceId":{"type":"string","minLength":1}},"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigVoiceElevenLabs"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigVoiceEndpointingStrategy":{"type":"string","enum":["provider_vad","server_vad","client_commit","manual"],"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigVoiceEndpointingStrategy"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigVoiceEndpointing":{"type":"object","properties":{"silenceMs":{"type":"integer","minimum":0,"maximum":30000},"strategy":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigVoiceEndpointingStrategy"}},"required":["strategy"],"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigVoiceEndpointing"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigVoiceInterruptionMode":{"type":"string","enum":["none","cancel","barge-in"],"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigVoiceInterruptionMode"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigVoiceSpeechMode":{"type":"string","enum":["pipeline","speech_to_speech","provider_managed"],"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigVoiceSpeechMode"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigVoiceSpeechSynthesizerSettings":{"type":"object","properties":{"similarity":{"type":"number","format":"double","minimum":0,"maximum":1},"stability":{"type":"number","format":"double","minimum":0,"maximum":1}},"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigVoiceSpeechSynthesizerSettings"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigVoiceSpeechSynthesizer":{"type":"object","properties":{"model":{"type":"string","minLength":1},"provider":{"type":"string","minLength":1},"settings":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigVoiceSpeechSynthesizerSettings"},"voiceId":{"type":"string","minLength":1}},"required":["provider"],"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigVoiceSpeechSynthesizer"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigVoiceSpeechTranscriber":{"type":"object","properties":{"model":{"type":"string","minLength":1},"provider":{"type":"string","minLength":1}},"required":["provider"],"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigVoiceSpeechTranscriber"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigVoiceSpeech":{"type":"object","properties":{"mode":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigVoiceSpeechMode"},"synthesizer":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigVoiceSpeechSynthesizer"},"transcriber":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigVoiceSpeechTranscriber"}},"required":["mode","synthesizer","transcriber"],"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigVoiceSpeech"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigVoice":{"type":"object","properties":{"directTools":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigVoiceDirectTools"},"disclosure":{"type":"boolean"},"elevenLabs":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigVoiceElevenLabs"},"enabled":{"type":"boolean"},"endpointing":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigVoiceEndpointing"},"greeting":{"type":"string","maxLength":2000},"interruptionMode":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigVoiceInterruptionMode"},"language":{"type":"string","minLength":1,"maxLength":64},"provider":{"type":"string","minLength":1},"speech":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigVoiceSpeech"}},"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigVoice"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfig":{"type":"object","properties":{"advisor":{"oneOf":[{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigAdvisor"},{"type":"null"}]},"artifacts":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigArtifacts"},"busyMessageRouting":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigBusyMessageRouting"},"contextManagement":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigContextManagement"},"durability":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigDurability"},"errorHandling":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigErrorHandling"},"frequencyPenalty":{"type":"number","format":"double","minimum":-2,"maximum":2},"loggingPolicy":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigLoggingPolicy"},"loopConfig":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigLoopConfig"},"maxTokens":{"type":"integer","minimum":1},"memory":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigMemory"},"model":{"type":"string"},"output":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigOutput"},"piiRedaction":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigPiiRedaction"},"presencePenalty":{"type":"number","format":"double","minimum":-2,"maximum":2},"reasoning":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigReasoning"},"sandbox":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigSandbox"},"seed":{"type":"integer"},"state":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigState"},"systemPrompt":{"type":"string"},"temperature":{"type":"number","format":"double","minimum":0,"maximum":2},"temporal":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigTemporal"},"tenancyStrategy":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigTenancyStrategy"},"tools":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigTools"},"topK":{"type":"integer","minimum":1,"maximum":500},"topP":{"type":"number","format":"double","minimum":0,"maximum":1},"voice":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfigVoice"}},"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfig"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinition":{"type":"object","properties":{"config":{"$ref":"#/components/schemas/V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionConfig"},"description":{"type":"string"},"icon":{"type":"string","maxLength":50},"name":{"type":"string","minLength":1}},"required":["name"],"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaDefinition"},"AgentEnsureDeployTarget":{"type":"object","properties":{"alias":{"type":"string"},"bindings":{"type":"object","additionalProperties":{"type":"string"},"description":"The complete set of `{{secret:NAME}}` values executions resolve when they reach this agent through this pointer, ahead of the organization secret of the same name. One preview per pull request can aim its HTTP tools at that pull request environment while the version content stays byte-identical to what `live` runs. Whole-set replacement: a name you stop sending stops resolving, and an empty object clears them. Values are encrypted at rest and never returned; only their names appear on the deployment receipt."}},"required":["alias"],"description":"Atomically save this definition and activate it at a release alias. Use { alias: \"live\" } to deploy to production, or any name matching ^[a-z0-9][a-z0-9-]{0,62}$ for a preview pointer. A non-live alias appends a candidate version and moves that one pointer: it never writes the agent row, its config hash, its capabilities, its draft pointer or its live pointer, so onConflict and expectedRemoteHash describe writes it never performs and are rejected with a 400 alongside it. A release alias is organization-owned, so a non-live deploy on a personal-scope agent is a 400 with code alias_requires_organization. Mutually exclusive with release.","title":"AgentEnsureDeployTarget"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaOnConflict":{"type":"string","enum":["error","overwrite"],"title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaOnConflict"},"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaRelease":{"type":"string","enum":["none","publish"],"description":"Compatibility input, translated to a deploy: \"publish\" activates live, \"none\" saves without activating. Prefer deploy.","title":"V1AgentsEnsurePostRequestBodyContentApplicationJsonSchemaRelease"},"AgentEnsureSkillBinding":{"type":"object","properties":{"enabled":{"type":"boolean","description":"Defaults to true."},"name":{"type":"string","minLength":1,"maxLength":64,"description":"The skill slug."},"version":{"type":"integer","exclusiveMinimum":0,"description":"Pin this skill versionNumber. Omit to follow the skill's published version."}},"required":["name"],"title":"AgentEnsureSkillBinding"},"EnsureVersionMetadata":{"type":"object","properties":{"label":{"type":"string","maxLength":100,"description":"Short provenance label recorded on the appended version row (e.g. a git SHA or release tag). Defaults to \"sdk-ensure\". An empty string is treated as omitted."},"notes":{"type":"string","maxLength":2000,"description":"Free-form notes recorded on the appended version row, used verbatim. Defaults to the server-generated converge summary. An empty string is treated as omitted."}},"description":"Provenance recorded on the version row this converge appends. Omit to keep the default \"sdk-ensure\" label and the server-generated notes.","title":"EnsureVersionMetadata"},"AgentEnsureCapabilityChangeAction":{"type":"string","enum":["add","update","remove","unchanged"],"description":"What this converge did (on a dry run, would do) to the capability.","title":"AgentEnsureCapabilityChangeAction"},"AgentEnsureCapabilityChangeKind":{"type":"string","enum":["flow","agent","tool"],"title":"AgentEnsureCapabilityChangeKind"},"AgentEnsureCapabilityChange":{"type":"object","properties":{"action":{"$ref":"#/components/schemas/AgentEnsureCapabilityChangeAction","description":"What this converge did (on a dry run, would do) to the capability."},"enabled":{"type":"boolean"},"kind":{"$ref":"#/components/schemas/AgentEnsureCapabilityChangeKind"},"source":{"type":["string","null"],"description":"The flow, agent or tool name the capability calls."},"toolName":{"type":"string"}},"required":["action","enabled","kind","source","toolName"],"title":"AgentEnsureCapabilityChange"},"AgentEnsureDeployment":{"type":"object","properties":{"alias":{"type":"string","description":"The release alias this converge aimed."},"bindingNames":{"type":"array","items":{"type":"string"},"description":"Per-alias secret binding names in force after this converge (on a dry run carrying deploy.bindings, the names it would leave in force). Never values."},"bindingsChanged":{"type":"boolean","description":"Present on a dry run carrying deploy.bindings: whether the binding names differ from the ones the alias carries now."},"changed":{"type":"boolean","description":"Whether this converge moved the pointer (on a dry run, whether it would move it)."},"receiptId":{"type":"string","description":"The deployment receipt this converge appended. Absent when the pointer did not move."},"revision":{"type":["number","null"],"format":"double","description":"Compare-and-swap revision of the alias, null when the alias does not exist yet."},"versionId":{"type":["string","null"],"description":"The version the alias selects as of this response (null on a dry run against an alias that does not exist yet)."},"versionNumber":{"type":["number","null"],"format":"double","description":"Version number of that version, when known."}},"required":["alias","changed","revision","versionId","versionNumber"],"description":"Present when the converge carried release or deploy and the activation was applied.","title":"AgentEnsureDeployment"},"AgentEnsureResponseOneOf0Result":{"type":"string","enum":["unchanged","created","updated"],"title":"AgentEnsureResponseOneOf0Result"},"AgentEnsureSkillBindingChangeAction":{"type":"string","enum":["bind","update","unbind","unchanged"],"description":"What this converge did (on a dry run, would do) to the binding.","title":"AgentEnsureSkillBindingChangeAction"},"AgentEnsureSkillBindingChange":{"type":"object","properties":{"action":{"$ref":"#/components/schemas/AgentEnsureSkillBindingChangeAction","description":"What this converge did (on a dry run, would do) to the binding."},"enabled":{"type":"boolean"},"name":{"type":"string","description":"The skill slug."},"skillId":{"type":"string"},"version":{"type":["number","null"],"format":"double","description":"The pinned versionNumber; null follows the published version."}},"required":["action","enabled","name","skillId","version"],"title":"AgentEnsureSkillBindingChange"},"AgentEnsureResponse0":{"type":"object","properties":{"_warnings":{"type":"array","items":{"type":"string"},"description":"Non-blocking advisories, e.g. SCHEDULE_AGENT_CONFIG_UNSUPPORTED when this converge (or, on a dry run, the planned one) changes what active schedules run into a version they cannot run."},"agentId":{"type":"string"},"capabilityChanges":{"type":"array","items":{"$ref":"#/components/schemas/AgentEnsureCapabilityChange"},"description":"Present when the request carried capabilities: one row per declared capability, then removals."},"contentHash":{"type":"string","description":"Server-computed canonical content hash. Clients should echo this hash in probes."},"deployment":{"$ref":"#/components/schemas/AgentEnsureDeployment"},"remoteHash":{"type":"string","description":"For a non-live deploy: the content hash the alias carried before this converge (absent when the alias is new)."},"result":{"$ref":"#/components/schemas/AgentEnsureResponseOneOf0Result"},"skillBindings":{"type":"array","items":{"$ref":"#/components/schemas/AgentEnsureSkillBindingChange"},"description":"Present when the request carried skills: one row per declared binding, then unbinds."},"versionId":{"type":["string","null"],"description":"The version snapshot backing this state (null if snapshotting failed)."}},"required":["agentId","contentHash","result","versionId"],"title":"AgentEnsureResponse0"},"AgentEnsureResponseOneOf1Result":{"type":"string","enum":["definitionRequired"],"title":"AgentEnsureResponseOneOf1Result"},"AgentEnsureResponse1":{"type":"object","properties":{"result":{"$ref":"#/components/schemas/AgentEnsureResponseOneOf1Result"}},"required":["result"],"title":"AgentEnsureResponse1"},"AgentEnsureResponseOneOf2Changes":{"type":"string","enum":["none","create","update"],"title":"AgentEnsureResponseOneOf2Changes"},"AgentEnsureResponseOneOf2Deployment":{"type":"object","properties":{"alias":{"type":"string","description":"The release alias this converge aimed."},"bindingNames":{"type":"array","items":{"type":"string"},"description":"Per-alias secret binding names in force after this converge (on a dry run carrying deploy.bindings, the names it would leave in force). Never values."},"bindingsChanged":{"type":"boolean","description":"Present on a dry run carrying deploy.bindings: whether the binding names differ from the ones the alias carries now."},"changed":{"type":"boolean","description":"Whether this converge moved the pointer (on a dry run, whether it would move it)."},"receiptId":{"type":"string","description":"The deployment receipt this converge appended. Absent when the pointer did not move."},"revision":{"type":["number","null"],"format":"double","description":"Compare-and-swap revision of the alias, null when the alias does not exist yet."},"versionId":{"type":["string","null"],"description":"The version the alias selects as of this response (null on a dry run against an alias that does not exist yet)."},"versionNumber":{"type":["number","null"],"format":"double","description":"Version number of that version, when known."}},"required":["alias","changed","revision","versionId","versionNumber"],"description":"Present when the dry run carried release or deploy: the pointer it would aim, and whether it would move.","title":"AgentEnsureResponseOneOf2Deployment"},"AgentEnsureResponseOneOf2Result":{"type":"string","enum":["plan"],"title":"AgentEnsureResponseOneOf2Result"},"AgentEnsureResponse2":{"type":"object","properties":{"_warnings":{"type":"array","items":{"type":"string"},"description":"Non-blocking advisories, e.g. SCHEDULE_AGENT_CONFIG_UNSUPPORTED when this converge (or, on a dry run, the planned one) changes what active schedules run into a version they cannot run."},"agentId":{"type":"string"},"capabilityChanges":{"type":"array","items":{"$ref":"#/components/schemas/AgentEnsureCapabilityChange"},"description":"Present when the request carried capabilities: one row per declared capability, then removals."},"changedKeys":{"type":"array","items":{"type":"string"}},"changes":{"$ref":"#/components/schemas/AgentEnsureResponseOneOf2Changes"},"contentHash":{"type":"string"},"deployment":{"$ref":"#/components/schemas/AgentEnsureResponseOneOf2Deployment","description":"Present when the dry run carried release or deploy: the pointer it would aim, and whether it would move."},"remoteHash":{"type":"string"},"result":{"$ref":"#/components/schemas/AgentEnsureResponseOneOf2Result"},"skillBindings":{"type":"array","items":{"$ref":"#/components/schemas/AgentEnsureSkillBindingChange"},"description":"Present when the request carried skills: one row per declared binding, then unbinds."}},"required":["changedKeys","changes","contentHash","result"],"title":"AgentEnsureResponse2"},"AgentEnsureResponse":{"oneOf":[{"$ref":"#/components/schemas/AgentEnsureResponse0"},{"$ref":"#/components/schemas/AgentEnsureResponse1"},{"$ref":"#/components/schemas/AgentEnsureResponse2"}],"title":"AgentEnsureResponse"},"AgentEnsureBadRequestCode":{"type":"string","enum":["alias_requires_organization"],"description":"A release alias is organization-owned, so a personal-scope agent cannot carry one.","title":"AgentEnsureBadRequestCode"},"AgentEnsureBadRequest":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/AgentEnsureBadRequestCode","description":"A release alias is organization-owned, so a personal-scope agent cannot carry one."},"error":{"type":"string"}},"required":["error"],"title":"AgentEnsureBadRequest"},"AgentEnsureConflictCode":{"type":"string","enum":["external_modification","remote_changed"],"title":"AgentEnsureConflictCode"},"AgentEnsureConflict":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/AgentEnsureConflictCode"},"currentHash":{"type":["string","null"]},"error":{"type":"string"},"lastModifiedSource":{"type":"string"},"modifiedAt":{"type":["string","null"]}},"required":["code","error"],"title":"AgentEnsureConflict"},"AgentEnsureHashMismatchCode":{"type":"string","enum":["content_hash_mismatch"],"title":"AgentEnsureHashMismatchCode"},"AgentEnsureHashMismatch":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/AgentEnsureHashMismatchCode"},"contentHash":{"type":"string","description":"The server-computed canonical hash of the submitted definition."},"error":{"type":"string"}},"required":["code","contentHash","error"],"title":"AgentEnsureHashMismatch"},"AgentEnsureServerErrorCode":{"type":"string","enum":["alias_activation_failed"],"title":"AgentEnsureServerErrorCode"},"AgentEnsureServerError":{"type":"object","properties":{"alias":{"type":"string","description":"The release alias whose activation failed. No pointer was moved."},"code":{"$ref":"#/components/schemas/AgentEnsureServerErrorCode"},"error":{"type":"string"}},"required":["error"],"title":"AgentEnsureServerError"},"V1AgentsFetchAgentCardPostRequestBodyContentApplicationJsonSchemaTransport":{"type":"string","enum":["http","device"],"description":"How to reach the card: directly (default) or through a paired local listener","title":"V1AgentsFetchAgentCardPostRequestBodyContentApplicationJsonSchemaTransport"},"V1AgentsFetchAgentCardPostResponsesContentApplicationJsonSchemaAuthenticationApiKeyAuth":{"type":"object","properties":{"headerName":{"type":"string"}},"title":"V1AgentsFetchAgentCardPostResponsesContentApplicationJsonSchemaAuthenticationApiKeyAuth"},"V1AgentsFetchAgentCardPostResponsesContentApplicationJsonSchemaAuthenticationBearerAuth":{"type":"object","properties":{"scopes":{"type":"array","items":{"type":"string"}}},"title":"V1AgentsFetchAgentCardPostResponsesContentApplicationJsonSchemaAuthenticationBearerAuth"},"V1AgentsFetchAgentCardPostResponsesContentApplicationJsonSchemaAuthenticationType":{"type":"string","enum":["bearer","api_key","none"],"title":"V1AgentsFetchAgentCardPostResponsesContentApplicationJsonSchemaAuthenticationType"},"V1AgentsFetchAgentCardPostResponsesContentApplicationJsonSchemaAuthentication":{"type":"object","properties":{"apiKeyAuth":{"$ref":"#/components/schemas/V1AgentsFetchAgentCardPostResponsesContentApplicationJsonSchemaAuthenticationApiKeyAuth"},"bearerAuth":{"$ref":"#/components/schemas/V1AgentsFetchAgentCardPostResponsesContentApplicationJsonSchemaAuthenticationBearerAuth"},"type":{"$ref":"#/components/schemas/V1AgentsFetchAgentCardPostResponsesContentApplicationJsonSchemaAuthenticationType"}},"title":"V1AgentsFetchAgentCardPostResponsesContentApplicationJsonSchemaAuthentication"},"V1AgentsFetchAgentCardPostResponsesContentApplicationJsonSchemaCapabilitiesStatefulness":{"type":"string","enum":["none","task","session"],"title":"V1AgentsFetchAgentCardPostResponsesContentApplicationJsonSchemaCapabilitiesStatefulness"},"V1AgentsFetchAgentCardPostResponsesContentApplicationJsonSchemaCapabilities":{"type":"object","properties":{"pushNotifications":{"type":"boolean"},"statefulness":{"$ref":"#/components/schemas/V1AgentsFetchAgentCardPostResponsesContentApplicationJsonSchemaCapabilitiesStatefulness"},"streaming":{"type":"boolean"}},"title":"V1AgentsFetchAgentCardPostResponsesContentApplicationJsonSchemaCapabilities"},"V1AgentsFetchAgentCardPostResponsesContentApplicationJsonSchemaProvider":{"type":"object","properties":{"organization":{"type":"string"},"url":{"type":"string"}},"title":"V1AgentsFetchAgentCardPostResponsesContentApplicationJsonSchemaProvider"},"V1AgentsFetchAgentCardPostResponsesContentApplicationJsonSchemaSkillsItems":{"type":"object","properties":{"description":{"type":"string"},"id":{"type":"string"},"inputModes":{"type":"array","items":{"type":"string"}},"inputSchema":{"type":"object","additionalProperties":{"description":"Any type"}},"name":{"type":"string"},"outputModes":{"type":"array","items":{"type":"string"}}},"title":"V1AgentsFetchAgentCardPostResponsesContentApplicationJsonSchemaSkillsItems"},"Agents_fetchExternalAgentCard_Response_200":{"type":"object","properties":{"authentication":{"$ref":"#/components/schemas/V1AgentsFetchAgentCardPostResponsesContentApplicationJsonSchemaAuthentication"},"capabilities":{"$ref":"#/components/schemas/V1AgentsFetchAgentCardPostResponsesContentApplicationJsonSchemaCapabilities"},"description":{"type":"string"},"iconUrl":{"type":"string"},"name":{"type":"string"},"protocolVersion":{"type":"string"},"provider":{"$ref":"#/components/schemas/V1AgentsFetchAgentCardPostResponsesContentApplicationJsonSchemaProvider"},"skills":{"type":"array","items":{"$ref":"#/components/schemas/V1AgentsFetchAgentCardPostResponsesContentApplicationJsonSchemaSkillsItems"}},"url":{"type":"string"},"version":{"type":"string"}},"title":"Agents_fetchExternalAgentCard_Response_200"},"AgentPullResponseDefinitionConfigAdvisor":{"type":"object","properties":{"model":{"type":"string"},"systemPrompt":{"type":"string"}},"required":["model"],"title":"AgentPullResponseDefinitionConfigAdvisor"},"AgentPullResponseDefinitionConfigArtifactsTypesItems":{"type":"string","enum":["markdown","component"],"title":"AgentPullResponseDefinitionConfigArtifactsTypesItems"},"AgentPullResponseDefinitionConfigArtifacts":{"type":"object","properties":{"enabled":{"type":"boolean"},"types":{"type":"array","items":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigArtifactsTypesItems"}}},"required":["enabled","types"],"title":"AgentPullResponseDefinitionConfigArtifacts"},"AgentPullResponseDefinitionConfigBusyMessageRoutingMode":{"type":"string","enum":["enforced","off"],"title":"AgentPullResponseDefinitionConfigBusyMessageRoutingMode"},"AgentPullResponseDefinitionConfigBusyMessageRouting":{"type":"object","properties":{"classifierModel":{"type":"string","minLength":1,"maxLength":200},"mode":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigBusyMessageRoutingMode"}},"title":"AgentPullResponseDefinitionConfigBusyMessageRouting"},"AgentPullResponseDefinitionConfigContextManagementCompactionStrategy":{"type":"string","enum":["auto","provider_native","summary"],"title":"AgentPullResponseDefinitionConfigContextManagementCompactionStrategy"},"AgentPullResponseDefinitionConfigContextManagementCompaction":{"type":"object","properties":{"enabled":{"type":"boolean"},"instructions":{"type":"string","maxLength":4000},"model":{"type":"string"},"retainRecentTokens":{"type":"integer","minimum":0},"strategy":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigContextManagementCompactionStrategy"},"thresholdRatio":{"type":"number","format":"double","minimum":0.3,"maximum":0.98},"thresholdTokens":{"type":"integer","minimum":50000}},"title":"AgentPullResponseDefinitionConfigContextManagementCompaction"},"AgentPullResponseDefinitionConfigContextManagementToolResultsPruneMode":{"type":"string","enum":["mask","off"],"title":"AgentPullResponseDefinitionConfigContextManagementToolResultsPruneMode"},"AgentPullResponseDefinitionConfigContextManagementToolResults":{"type":"object","properties":{"inlineThresholdChars":{"type":"integer","minimum":1024,"description":"Deprecated and ignored. Tool results are never spilled.","deprecated":true},"pruneHotWindowTokens":{"type":"integer","minimum":4000},"pruneMode":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigContextManagementToolResultsPruneMode"}},"title":"AgentPullResponseDefinitionConfigContextManagementToolResults"},"AgentPullResponseDefinitionConfigContextManagement":{"type":"object","properties":{"compaction":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigContextManagementCompaction"},"toolResults":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigContextManagementToolResults"}},"title":"AgentPullResponseDefinitionConfigContextManagement"},"AgentPullResponseDefinitionConfigDurabilityForced":{"type":"string","enum":["durable","in_process"],"title":"AgentPullResponseDefinitionConfigDurabilityForced"},"AgentPullResponseDefinitionConfigDurability":{"type":"object","properties":{"forced":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigDurabilityForced"},"maxBudgetMs":{"type":["integer","null"],"minimum":1000,"maximum":86400000},"watchLeaseMs":{"type":["integer","null"],"minimum":10000,"maximum":1800000}},"title":"AgentPullResponseDefinitionConfigDurability"},"AgentPullResponseDefinitionConfigErrorHandlingFallbacksItemsOneOf0Type":{"type":"string","enum":["retry"],"title":"AgentPullResponseDefinitionConfigErrorHandlingFallbacksItemsOneOf0Type"},"AgentPullResponseDefinitionConfigErrorHandlingFallbacksItems0":{"type":"object","properties":{"delay":{"type":"integer","minimum":0,"maximum":60000},"type":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigErrorHandlingFallbacksItemsOneOf0Type"}},"required":["type"],"title":"AgentPullResponseDefinitionConfigErrorHandlingFallbacksItems0"},"AgentPullResponseDefinitionConfigErrorHandlingFallbacksItemsOneOf1Type":{"type":"string","enum":["model"],"title":"AgentPullResponseDefinitionConfigErrorHandlingFallbacksItemsOneOf1Type"},"AgentPullResponseDefinitionConfigErrorHandlingFallbacksItems1":{"type":"object","properties":{"delay":{"type":"integer","minimum":0,"maximum":60000},"maxTokens":{"type":"integer","minimum":1},"model":{"type":"string"},"temperature":{"type":"number","format":"double","minimum":0,"maximum":2},"type":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigErrorHandlingFallbacksItemsOneOf1Type"}},"required":["model","type"],"title":"AgentPullResponseDefinitionConfigErrorHandlingFallbacksItems1"},"AgentPullResponseDefinitionConfigErrorHandlingFallbacksItemsOneOf2Type":{"type":"string","enum":["message"],"title":"AgentPullResponseDefinitionConfigErrorHandlingFallbacksItemsOneOf2Type"},"AgentPullResponseDefinitionConfigErrorHandlingFallbacksItems2":{"type":"object","properties":{"delay":{"type":"integer","minimum":0,"maximum":60000},"message":{"type":"string"},"type":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigErrorHandlingFallbacksItemsOneOf2Type"}},"required":["message","type"],"title":"AgentPullResponseDefinitionConfigErrorHandlingFallbacksItems2"},"AgentPullResponseDefinitionConfigErrorHandlingFallbacksItems":{"oneOf":[{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigErrorHandlingFallbacksItems0"},{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigErrorHandlingFallbacksItems1"},{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigErrorHandlingFallbacksItems2"}],"title":"AgentPullResponseDefinitionConfigErrorHandlingFallbacksItems"},"AgentPullResponseDefinitionConfigErrorHandlingOnError":{"type":"string","enum":["fail","continue","fallback"],"title":"AgentPullResponseDefinitionConfigErrorHandlingOnError"},"AgentPullResponseDefinitionConfigErrorHandlingTriggersItemsType":{"type":"string","enum":["error","empty-output"],"title":"AgentPullResponseDefinitionConfigErrorHandlingTriggersItemsType"},"AgentPullResponseDefinitionConfigErrorHandlingTriggersItems":{"type":"object","properties":{"type":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigErrorHandlingTriggersItemsType"}},"required":["type"],"title":"AgentPullResponseDefinitionConfigErrorHandlingTriggersItems"},"AgentPullResponseDefinitionConfigErrorHandling":{"type":"object","properties":{"fallbacks":{"type":"array","items":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigErrorHandlingFallbacksItems"}},"onError":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigErrorHandlingOnError"},"triggers":{"type":"array","items":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigErrorHandlingTriggersItems"}}},"required":["onError"],"title":"AgentPullResponseDefinitionConfigErrorHandling"},"AgentPullResponseDefinitionConfigLoggingPolicy":{"type":"string","enum":["default","on","off"],"title":"AgentPullResponseDefinitionConfigLoggingPolicy"},"AgentPullResponseDefinitionConfigLoopConfig":{"type":"object","properties":{"enableReflection":{"type":"boolean"},"maxCost":{"type":"number","format":"double","minimum":0},"maxTurns":{"type":"integer","minimum":1,"maximum":100},"reflectionInterval":{"type":"integer","minimum":1,"maximum":50},"treatLengthCutoffAsFailure":{"type":"boolean"}},"title":"AgentPullResponseDefinitionConfigLoopConfig"},"AgentPullResponseDefinitionConfigMemoryPointerScope":{"type":"string","enum":["shared","alias","version"],"title":"AgentPullResponseDefinitionConfigMemoryPointerScope"},"AgentPullResponseDefinitionConfigMemory":{"type":"object","properties":{"enabled":{"type":"boolean"},"injectSummary":{"type":"boolean"},"pointerScope":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigMemoryPointerScope"},"profileTemplate":{"type":"string"}},"required":["enabled"],"title":"AgentPullResponseDefinitionConfigMemory"},"AgentPullResponseDefinitionConfigOutputValidatorsItemsOneOf0Type":{"type":"string","enum":["candidate-question","requested-json","no-action","json-schema"],"title":"AgentPullResponseDefinitionConfigOutputValidatorsItemsOneOf0Type"},"AgentPullResponseDefinitionConfigOutputValidatorsItems0":{"type":"object","properties":{"maxBounces":{"type":"integer","minimum":0,"maximum":10},"schema":{"type":"object","additionalProperties":{"description":"Any type"}},"type":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigOutputValidatorsItemsOneOf0Type"}},"required":["type"],"title":"AgentPullResponseDefinitionConfigOutputValidatorsItems0"},"AgentPullResponseDefinitionConfigOutputValidatorsItemsOneOf1Type":{"type":"string","enum":["custom"],"title":"AgentPullResponseDefinitionConfigOutputValidatorsItemsOneOf1Type"},"AgentPullResponseDefinitionConfigOutputValidatorsItems1":{"type":"object","properties":{"maxBounces":{"type":"integer","minimum":0,"maximum":10},"name":{"type":"string","minLength":1,"maxLength":128},"timeoutMs":{"type":"integer","minimum":1,"maximum":300000},"type":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigOutputValidatorsItemsOneOf1Type"}},"required":["name","type"],"title":"AgentPullResponseDefinitionConfigOutputValidatorsItems1"},"AgentPullResponseDefinitionConfigOutputValidatorsItemsOneOf2Type":{"type":"string","enum":["flow"],"title":"AgentPullResponseDefinitionConfigOutputValidatorsItemsOneOf2Type"},"AgentPullResponseDefinitionConfigOutputValidatorsItems2":{"type":"object","properties":{"flowId":{"type":"string","minLength":1},"maxBounces":{"type":"integer","minimum":0,"maximum":10},"outputVariable":{"type":"string","minLength":1,"maxLength":128},"timeoutMs":{"type":"integer","minimum":1,"maximum":300000},"type":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigOutputValidatorsItemsOneOf2Type"}},"required":["flowId","type"],"title":"AgentPullResponseDefinitionConfigOutputValidatorsItems2"},"AgentPullResponseDefinitionConfigOutputValidatorsItemsOneOf3Type":{"type":"string","enum":["tool"],"title":"AgentPullResponseDefinitionConfigOutputValidatorsItemsOneOf3Type"},"AgentPullResponseDefinitionConfigOutputValidatorsItems3":{"type":"object","properties":{"maxBounces":{"type":"integer","minimum":0,"maximum":10},"timeoutMs":{"type":"integer","minimum":1,"maximum":300000},"toolId":{"type":"string","minLength":1},"type":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigOutputValidatorsItemsOneOf3Type"}},"required":["toolId","type"],"title":"AgentPullResponseDefinitionConfigOutputValidatorsItems3"},"AgentPullResponseDefinitionConfigOutputValidatorsItems":{"oneOf":[{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigOutputValidatorsItems0"},{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigOutputValidatorsItems1"},{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigOutputValidatorsItems2"},{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigOutputValidatorsItems3"}],"title":"AgentPullResponseDefinitionConfigOutputValidatorsItems"},"AgentPullResponseDefinitionConfigOutput":{"type":"object","properties":{"validators":{"type":"array","items":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigOutputValidatorsItems"}}},"title":"AgentPullResponseDefinitionConfigOutput"},"AgentPullResponseDefinitionConfigPiiRedaction":{"type":"string","enum":["default","off","redact"],"title":"AgentPullResponseDefinitionConfigPiiRedaction"},"AgentPullResponseDefinitionConfigReasoningOneOf1ReasoningEffort":{"type":"string","enum":["minimal","low","medium","high","xhigh","max"],"title":"AgentPullResponseDefinitionConfigReasoningOneOf1ReasoningEffort"},"AgentPullResponseDefinitionConfigReasoningOneOf1ReasoningSummary":{"type":"string","enum":["auto","detailed"],"title":"AgentPullResponseDefinitionConfigReasoningOneOf1ReasoningSummary"},"AgentPullResponseDefinitionConfigReasoning1":{"type":"object","properties":{"budgetTokens":{"type":"integer","minimum":1000,"maximum":100000},"effort":{"type":"string","minLength":1,"maxLength":32},"enabled":{"type":"boolean"},"includeThoughts":{"type":"boolean"},"reasoningEffort":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigReasoningOneOf1ReasoningEffort"},"reasoningSummary":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigReasoningOneOf1ReasoningSummary"},"thinkingBudget":{"type":"integer","minimum":1024,"maximum":65536},"thinkingLevel":{"type":"string","minLength":1,"maxLength":32}},"required":["enabled"],"title":"AgentPullResponseDefinitionConfigReasoning1"},"AgentPullResponseDefinitionConfigReasoning":{"oneOf":[{"type":"boolean"},{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigReasoning1"}],"title":"AgentPullResponseDefinitionConfigReasoning"},"AgentPullResponseDefinitionConfigSandboxCodingAgentsItems":{"type":"string","enum":["opencode"],"title":"AgentPullResponseDefinitionConfigSandboxCodingAgentsItems"},"AgentPullResponseDefinitionConfigSandboxInstanceType":{"type":"string","enum":["standard-1","standard-2","standard-3","standard-4"],"description":"Only standard-4 is supported on the hosted Agent Sandbox path; other sizes cannot be enabled.","title":"AgentPullResponseDefinitionConfigSandboxInstanceType"},"AgentPullResponseDefinitionConfigSandboxNetworkAccess0":{"type":"string","enum":["none","essentials","open"],"title":"AgentPullResponseDefinitionConfigSandboxNetworkAccess0"},"AgentPullResponseDefinitionConfigSandboxNetworkAccessOneOf1Profile":{"type":"string","enum":["none","essentials","open"],"title":"AgentPullResponseDefinitionConfigSandboxNetworkAccessOneOf1Profile"},"AgentPullResponseDefinitionConfigSandboxNetworkAccess1":{"type":"object","properties":{"allow":{"type":"array","items":{"type":"string"}},"profile":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigSandboxNetworkAccessOneOf1Profile"}},"title":"AgentPullResponseDefinitionConfigSandboxNetworkAccess1"},"AgentPullResponseDefinitionConfigSandboxNetworkAccess":{"oneOf":[{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigSandboxNetworkAccess0"},{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigSandboxNetworkAccess1"}],"title":"AgentPullResponseDefinitionConfigSandboxNetworkAccess"},"AgentPullResponseDefinitionConfigSandboxPersistence":{"type":"string","enum":["ephemeral","conversation","named"],"description":"Supported: ephemeral or conversation. Named remains parseable for stored configs but cannot be enabled.","title":"AgentPullResponseDefinitionConfigSandboxPersistence"},"AgentPullResponseDefinitionConfigSandboxProvider":{"type":"string","enum":["runtype-sandbox","daytona"],"description":"Only runtype-sandbox is currently supported. Daytona is retained for stored-config parsing but rejected at authoring/execution.","title":"AgentPullResponseDefinitionConfigSandboxProvider"},"AgentPullResponseDefinitionConfigSandboxSleepAfter":{"type":"string","enum":["5m","15m","30m","1h"],"title":"AgentPullResponseDefinitionConfigSandboxSleepAfter"},"AgentPullResponseDefinitionConfigSandboxTtl":{"type":"string","enum":["5m","1h","24h","unlimited"],"title":"AgentPullResponseDefinitionConfigSandboxTtl"},"AgentPullResponseDefinitionConfigSandbox":{"type":"object","properties":{"codingAgents":{"type":"array","items":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigSandboxCodingAgentsItems"},"description":"Coding agents the Sandbox can run as typed sessions. Non-empty adds the agent_session_* tools; empty or absent adds none."},"enabled":{"type":"boolean"},"instanceType":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigSandboxInstanceType","description":"Only standard-4 is supported on the hosted Agent Sandbox path; other sizes cannot be enabled."},"networkAccess":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigSandboxNetworkAccess"},"persistence":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigSandboxPersistence","description":"Supported: ephemeral or conversation. Named remains parseable for stored configs but cannot be enabled."},"provider":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigSandboxProvider","description":"Only runtype-sandbox is currently supported. Daytona is retained for stored-config parsing but rejected at authoring/execution."},"secretEnv":{"type":"object","additionalProperties":{"type":"string","minLength":1}},"setupCommands":{"type":"array","items":{"type":"string","minLength":1}},"sleepAfter":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigSandboxSleepAfter"},"ttl":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigSandboxTtl"}},"required":["enabled"],"title":"AgentPullResponseDefinitionConfigSandbox"},"AgentPullResponseDefinitionConfigStateMergeStrategy":{"type":"string","enum":["replace","merge"],"default":"merge","title":"AgentPullResponseDefinitionConfigStateMergeStrategy"},"AgentPullResponseDefinitionConfigStatePredictStateItems":{"type":"object","properties":{"stateKey":{"type":"string","minLength":1},"tool":{"type":"string","minLength":1},"toolArgument":{"type":"string","minLength":1}},"required":["stateKey","tool","toolArgument"],"title":"AgentPullResponseDefinitionConfigStatePredictStateItems"},"AgentPullResponseDefinitionConfigState":{"type":"object","properties":{"initial":{"type":"object","additionalProperties":{"description":"Any type"}},"mergeStrategy":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigStateMergeStrategy","default":"merge"},"predictState":{"type":"array","items":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigStatePredictStateItems"}},"schema":{"type":"object","additionalProperties":{"description":"Any type"}}},"title":"AgentPullResponseDefinitionConfigState"},"AgentPullResponseDefinitionConfigTemporal":{"type":"object","properties":{"elapsedThresholdSeconds":{"type":"integer","minimum":0},"groundNow":{"type":"boolean"},"injectElapsed":{"type":"boolean"},"timezone":{"type":"string"}},"title":"AgentPullResponseDefinitionConfigTemporal"},"AgentPullResponseDefinitionConfigTenancyStrategyAssuranceFloorEndUser":{"type":"string","enum":["asserted","verified"],"title":"AgentPullResponseDefinitionConfigTenancyStrategyAssuranceFloorEndUser"},"AgentPullResponseDefinitionConfigTenancyStrategyAssuranceFloorTenant":{"type":"string","enum":["asserted","verified"],"title":"AgentPullResponseDefinitionConfigTenancyStrategyAssuranceFloorTenant"},"AgentPullResponseDefinitionConfigTenancyStrategyAssuranceFloor":{"type":"object","properties":{"endUser":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigTenancyStrategyAssuranceFloorEndUser"},"tenant":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigTenancyStrategyAssuranceFloorTenant"}},"title":"AgentPullResponseDefinitionConfigTenancyStrategyAssuranceFloor"},"AgentPullResponseDefinitionConfigTenancyStrategyPreset":{"type":"string","enum":["internal","tenant-isolated","end-user-isolated"],"title":"AgentPullResponseDefinitionConfigTenancyStrategyPreset"},"AgentPullResponseDefinitionConfigTenancyStrategy":{"type":"object","properties":{"assuranceFloor":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigTenancyStrategyAssuranceFloor"},"preset":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigTenancyStrategyPreset"}},"required":["preset"],"title":"AgentPullResponseDefinitionConfigTenancyStrategy"},"AgentPullResponseDefinitionConfigToolsApprovalApprover":{"type":"string","enum":["owner","end-user"],"title":"AgentPullResponseDefinitionConfigToolsApprovalApprover"},"AgentPullResponseDefinitionConfigToolsApprovalChoices":{"type":"object","properties":{"alwaysAllow":{"type":"boolean"},"alwaysDeny":{"type":"boolean"}},"title":"AgentPullResponseDefinitionConfigToolsApprovalChoices"},"AgentPullResponseDefinitionConfigToolsApprovalRequire":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"boolean"}],"title":"AgentPullResponseDefinitionConfigToolsApprovalRequire"},"AgentPullResponseDefinitionConfigToolsApproval":{"type":"object","properties":{"approver":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigToolsApprovalApprover"},"choices":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigToolsApprovalChoices"},"notifyUser":{"type":"boolean"},"requestReason":{"type":"boolean"},"require":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigToolsApprovalRequire"},"timeout":{"type":"number","format":"double"}},"required":["require"],"title":"AgentPullResponseDefinitionConfigToolsApproval"},"AgentPullResponseDefinitionConfigToolsCodeModeConfig":{"type":"object","properties":{"description":{"type":"string"},"timeoutMs":{"type":"integer","minimum":1000,"maximum":600000},"toolPool":{"type":"array","items":{"type":"string"}}},"required":["toolPool"],"title":"AgentPullResponseDefinitionConfigToolsCodeModeConfig"},"AgentPullResponseDefinitionConfigToolsIntent":{"type":"string","enum":["mandatory","best-effort"],"title":"AgentPullResponseDefinitionConfigToolsIntent"},"AgentPullResponseDefinitionConfigToolsMcpServersItemsAuthType":{"type":"string","enum":["api_key","bearer","basic","custom_header","headers","none"],"title":"AgentPullResponseDefinitionConfigToolsMcpServersItemsAuthType"},"AgentPullResponseDefinitionConfigToolsMcpServersItemsAuth":{"type":"object","properties":{"headerName":{"type":"string"},"headers":{"type":"object","additionalProperties":{"type":"string"}},"password":{"type":"string"},"token":{"type":"string"},"type":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigToolsMcpServersItemsAuthType"},"username":{"type":"string"}},"required":["type"],"title":"AgentPullResponseDefinitionConfigToolsMcpServersItemsAuth"},"AgentPullResponseDefinitionConfigToolsMcpServersItemsTargetKind":{"type":"string","enum":["sandbox-deployment"],"title":"AgentPullResponseDefinitionConfigToolsMcpServersItemsTargetKind"},"AgentPullResponseDefinitionConfigToolsMcpServersItemsTarget":{"type":"object","properties":{"bearerSecretName":{"type":"string"},"deploymentId":{"type":"string","pattern":"^sbd_[0-9abcdefghjkmnpqrstvwxyz]{20,32}$"},"kind":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigToolsMcpServersItemsTargetKind"},"path":{"type":"string"}},"required":["deploymentId","kind"],"title":"AgentPullResponseDefinitionConfigToolsMcpServersItemsTarget"},"AgentPullResponseDefinitionConfigToolsMcpServersItemsTransport":{"type":"string","enum":["streamable_http","rest"],"title":"AgentPullResponseDefinitionConfigToolsMcpServersItemsTransport"},"AgentPullResponseDefinitionConfigToolsMcpServersItems":{"type":"object","properties":{"allowedTools":{"type":"array","items":{"type":"string"}},"auth":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigToolsMcpServersItemsAuth"},"enabled":{"type":"boolean"},"id":{"type":"string"},"identityAudiences":{"type":"array","items":{"type":"string"}},"name":{"type":"string"},"target":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigToolsMcpServersItemsTarget"},"timeout":{"type":"number","format":"double"},"transport":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigToolsMcpServersItemsTransport"},"url":{"type":"string"}},"required":["id"],"title":"AgentPullResponseDefinitionConfigToolsMcpServersItems"},"AgentPullResponseDefinitionConfigToolsPerToolLimits":{"type":"object","properties":{"maxCalls":{"type":"number","format":"double"},"required":{"type":"boolean"}},"title":"AgentPullResponseDefinitionConfigToolsPerToolLimits"},"AgentPullResponseDefinitionConfigToolsRuntimeToolsItemsToolType":{"type":"string","enum":["flow","custom","external","local","advisor","subagent","search"],"title":"AgentPullResponseDefinitionConfigToolsRuntimeToolsItemsToolType"},"AgentPullResponseDefinitionConfigToolsRuntimeToolsItems":{"type":"object","properties":{"config":{"type":"object","additionalProperties":{"description":"Any type"}},"description":{"type":"string"},"hiddenParameterNames":{"type":"array","items":{"type":"string","minLength":1}},"idempotent":{"type":"boolean"},"name":{"type":"string"},"parametersSchema":{"type":"object","additionalProperties":{"description":"Any type"}},"toolType":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigToolsRuntimeToolsItemsToolType"}},"required":["config","description","name","parametersSchema","toolType"],"title":"AgentPullResponseDefinitionConfigToolsRuntimeToolsItems"},"AgentPullResponseDefinitionConfigToolsSubagentConfigDefaultExecutionMode":{"type":"string","enum":["attached","detached"],"title":"AgentPullResponseDefinitionConfigToolsSubagentConfigDefaultExecutionMode"},"AgentPullResponseDefinitionConfigToolsSubagentConfigDefaultNotify":{"type":"string","enum":["none","narrate","react"],"title":"AgentPullResponseDefinitionConfigToolsSubagentConfigDefaultNotify"},"AgentPullResponseDefinitionConfigToolsSubagentConfigExecutionModesItems":{"type":"string","enum":["attached","detached"],"title":"AgentPullResponseDefinitionConfigToolsSubagentConfigExecutionModesItems"},"AgentPullResponseDefinitionConfigToolsSubagentConfig":{"type":"object","properties":{"allowNesting":{"type":"boolean"},"defaultExecutionMode":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigToolsSubagentConfigDefaultExecutionMode"},"defaultMaxTurns":{"type":"integer","minimum":1,"maximum":100},"defaultModel":{"type":"string"},"defaultNotify":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigToolsSubagentConfigDefaultNotify"},"defaultTimeoutMs":{"type":"integer","minimum":1000,"maximum":600000},"detachedMaxBudgetMs":{"type":"integer","minimum":1000,"maximum":86400000},"detachedNoProgressBudgetMs":{"type":"integer","minimum":1000,"maximum":86400000},"executionModes":{"type":"array","items":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigToolsSubagentConfigExecutionModesItems"}},"maxSpawnsPerRun":{"type":"integer","minimum":1,"maximum":50},"maxTurnsLimit":{"type":"integer","minimum":1,"maximum":100},"toolPool":{"type":"array","items":{"type":"string"}}},"required":["toolPool"],"title":"AgentPullResponseDefinitionConfigToolsSubagentConfig"},"AgentPullResponseDefinitionConfigToolsToolCallStrategy":{"type":"string","enum":["auto","required","none"],"title":"AgentPullResponseDefinitionConfigToolsToolCallStrategy"},"AgentPullResponseDefinitionConfigToolsToolSearch":{"type":"object","properties":{"alwaysLoaded":{"type":"array","items":{"type":"string"}},"enabled":{"type":"boolean"},"threshold":{"type":"number","format":"double"}},"title":"AgentPullResponseDefinitionConfigToolsToolSearch"},"AgentPullResponseDefinitionConfigTools":{"type":"object","properties":{"approval":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigToolsApproval"},"codeModeConfig":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigToolsCodeModeConfig"},"intent":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigToolsIntent"},"maxToolCalls":{"type":"integer","minimum":1,"maximum":100},"mcpServers":{"type":"array","items":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigToolsMcpServersItems"}},"perToolLimits":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigToolsPerToolLimits"}},"runtimeTools":{"type":"array","items":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigToolsRuntimeToolsItems"}},"subagentConfig":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigToolsSubagentConfig"},"toolCallStrategy":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigToolsToolCallStrategy"},"toolConfigs":{"type":"object","additionalProperties":{"type":"object","additionalProperties":{"description":"Any type"}}},"toolIds":{"type":"array","items":{"type":"string"}},"toolSearch":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigToolsToolSearch"}},"title":"AgentPullResponseDefinitionConfigTools"},"AgentPullResponseDefinitionConfigVoiceDirectTools":{"type":"object","properties":{"enabled":{"type":"boolean"},"model":{"type":"string","minLength":1}},"title":"AgentPullResponseDefinitionConfigVoiceDirectTools"},"AgentPullResponseDefinitionConfigVoiceElevenLabs":{"type":"object","properties":{"modelId":{"type":"string","minLength":1},"similarity":{"type":"number","format":"double","minimum":0,"maximum":1},"stability":{"type":"number","format":"double","minimum":0,"maximum":1},"voiceId":{"type":"string","minLength":1}},"title":"AgentPullResponseDefinitionConfigVoiceElevenLabs"},"AgentPullResponseDefinitionConfigVoiceEndpointingStrategy":{"type":"string","enum":["provider_vad","server_vad","client_commit","manual"],"title":"AgentPullResponseDefinitionConfigVoiceEndpointingStrategy"},"AgentPullResponseDefinitionConfigVoiceEndpointing":{"type":"object","properties":{"silenceMs":{"type":"integer","minimum":0,"maximum":30000},"strategy":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigVoiceEndpointingStrategy"}},"required":["strategy"],"title":"AgentPullResponseDefinitionConfigVoiceEndpointing"},"AgentPullResponseDefinitionConfigVoiceInterruptionMode":{"type":"string","enum":["none","cancel","barge-in"],"title":"AgentPullResponseDefinitionConfigVoiceInterruptionMode"},"AgentPullResponseDefinitionConfigVoiceSpeechMode":{"type":"string","enum":["pipeline","speech_to_speech","provider_managed"],"title":"AgentPullResponseDefinitionConfigVoiceSpeechMode"},"AgentPullResponseDefinitionConfigVoiceSpeechSynthesizerSettings":{"type":"object","properties":{"similarity":{"type":"number","format":"double","minimum":0,"maximum":1},"stability":{"type":"number","format":"double","minimum":0,"maximum":1}},"title":"AgentPullResponseDefinitionConfigVoiceSpeechSynthesizerSettings"},"AgentPullResponseDefinitionConfigVoiceSpeechSynthesizer":{"type":"object","properties":{"model":{"type":"string","minLength":1},"provider":{"type":"string","minLength":1},"settings":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigVoiceSpeechSynthesizerSettings"},"voiceId":{"type":"string","minLength":1}},"required":["provider"],"title":"AgentPullResponseDefinitionConfigVoiceSpeechSynthesizer"},"AgentPullResponseDefinitionConfigVoiceSpeechTranscriber":{"type":"object","properties":{"model":{"type":"string","minLength":1},"provider":{"type":"string","minLength":1}},"required":["provider"],"title":"AgentPullResponseDefinitionConfigVoiceSpeechTranscriber"},"AgentPullResponseDefinitionConfigVoiceSpeech":{"type":"object","properties":{"mode":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigVoiceSpeechMode"},"synthesizer":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigVoiceSpeechSynthesizer"},"transcriber":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigVoiceSpeechTranscriber"}},"required":["mode","synthesizer","transcriber"],"title":"AgentPullResponseDefinitionConfigVoiceSpeech"},"AgentPullResponseDefinitionConfigVoice":{"type":"object","properties":{"directTools":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigVoiceDirectTools"},"disclosure":{"type":"boolean"},"elevenLabs":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigVoiceElevenLabs"},"enabled":{"type":"boolean"},"endpointing":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigVoiceEndpointing"},"greeting":{"type":"string","maxLength":2000},"interruptionMode":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigVoiceInterruptionMode"},"language":{"type":"string","minLength":1,"maxLength":64},"provider":{"type":"string","minLength":1},"speech":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigVoiceSpeech"}},"title":"AgentPullResponseDefinitionConfigVoice"},"AgentPullResponseDefinitionConfig":{"type":"object","properties":{"advisor":{"oneOf":[{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigAdvisor"},{"type":"null"}]},"artifacts":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigArtifacts"},"busyMessageRouting":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigBusyMessageRouting"},"contextManagement":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigContextManagement"},"durability":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigDurability"},"errorHandling":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigErrorHandling"},"frequencyPenalty":{"type":"number","format":"double","minimum":-2,"maximum":2},"loggingPolicy":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigLoggingPolicy"},"loopConfig":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigLoopConfig"},"maxTokens":{"type":"integer","minimum":1},"memory":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigMemory"},"model":{"type":"string"},"output":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigOutput"},"piiRedaction":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigPiiRedaction"},"presencePenalty":{"type":"number","format":"double","minimum":-2,"maximum":2},"reasoning":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigReasoning"},"sandbox":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigSandbox"},"seed":{"type":"integer"},"state":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigState"},"systemPrompt":{"type":"string"},"temperature":{"type":"number","format":"double","minimum":0,"maximum":2},"temporal":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigTemporal"},"tenancyStrategy":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigTenancyStrategy"},"tools":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigTools"},"topK":{"type":"integer","minimum":1,"maximum":500},"topP":{"type":"number","format":"double","minimum":0,"maximum":1},"voice":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfigVoice"}},"title":"AgentPullResponseDefinitionConfig"},"AgentPullResponseDefinition":{"type":"object","properties":{"config":{"$ref":"#/components/schemas/AgentPullResponseDefinitionConfig"},"description":{"type":"string"},"icon":{"type":"string","maxLength":50},"name":{"type":"string","minLength":1}},"required":["name"],"title":"AgentPullResponseDefinition"},"AgentPullResponse":{"type":"object","properties":{"agentId":{"type":"string"},"capabilities":{"type":"array","items":{"$ref":"#/components/schemas/AgentEnsureCapability"},"description":"The agent's capabilities in display order, in the shape ensure's capabilities accepts. parametersSchema appears only when it differs from the one ensure would derive."},"contentHash":{"type":"string"},"definition":{"$ref":"#/components/schemas/AgentPullResponseDefinition"},"lastModifiedSource":{"type":["string","null"]},"skills":{"type":"array","items":{"$ref":"#/components/schemas/AgentEnsureSkillBinding"},"description":"The agent's skill bindings in load order, in the shape ensure's skills accepts."},"updatedAt":{"type":["string","null"]},"versionId":{"type":["string","null"]},"warnings":{"type":"array","items":{"type":"string"},"description":"Present only when a raw tool_… reference could not be emitted as a portable tool:<name> (the tool was deleted, or its name is shadowed by an older same-named tool). Those references are left as raw ids, which the ensure surface rejects; each warning explains how to fix it."}},"required":["agentId","capabilities","contentHash","definition","lastModifiedSource","skills","updatedAt","versionId"],"title":"AgentPullResponse"},"V1AgentsIdGetResponsesContentApplicationJsonSchemaCapabilitiesItems":{"type":"object","properties":{"agentId":{"type":"string"},"createdAt":{"type":"string"},"displayOrder":{"type":["integer","null"]},"enabled":{"type":"boolean"},"flowId":{"type":["string","null"]},"id":{"type":"string"},"parametersSchema":{"description":"Any type"},"subAgentId":{"type":["string","null"]},"toolDescription":{"type":["string","null"]},"toolId":{"type":["string","null"]},"toolName":{"type":"string"}},"required":["displayOrder","enabled","flowId","id","subAgentId","toolDescription","toolId","toolName"],"title":"V1AgentsIdGetResponsesContentApplicationJsonSchemaCapabilitiesItems"},"V1AgentsIdGetResponsesContentApplicationJsonSchemaSandboxCapabilityIssuesItemsCode":{"type":"string","enum":["unsupported_sandbox_capability"],"title":"V1AgentsIdGetResponsesContentApplicationJsonSchemaSandboxCapabilityIssuesItemsCode"},"V1AgentsIdGetResponsesContentApplicationJsonSchemaSandboxCapabilityIssuesItems":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/V1AgentsIdGetResponsesContentApplicationJsonSchemaSandboxCapabilityIssuesItemsCode"},"message":{"type":"string"},"path":{"type":"string"},"requested":{"type":"string"},"supported":{"type":"array","items":{"type":"string"}}},"required":["code","message","path","requested","supported"],"title":"V1AgentsIdGetResponsesContentApplicationJsonSchemaSandboxCapabilityIssuesItems"},"Agents_getAgentDetails_Response_200":{"type":"object","properties":{"agentType":{"type":"string"},"capabilities":{"type":"array","items":{"$ref":"#/components/schemas/V1AgentsIdGetResponsesContentApplicationJsonSchemaCapabilitiesItems"}},"claudeManagedConfig":{"type":["object","null"],"additionalProperties":{"description":"Any type"}},"config":{"type":["object","null"],"additionalProperties":{"description":"Any type"}},"configHash":{"type":["string","null"]},"createdAt":{"type":"string"},"dashboardUrl":{"type":"string"},"description":{"type":["string","null"]},"externalConfig":{"type":["object","null"],"additionalProperties":{"description":"Any type"},"description":"External-agent configuration. Configured auth.credentials values are write-only and returned as <redacted>, never plaintext."},"healthStatus":{"type":["string","null"]},"icon":{"type":["string","null"]},"id":{"type":"string"},"lastHealthCheckAt":{"type":["string","null"]},"lastModifiedSource":{"type":["string","null"]},"name":{"type":"string"},"organizationId":{"type":["string","null"]},"publishedVersionId":{"type":["string","null"]},"sandboxCapabilityIssues":{"type":"array","items":{"$ref":"#/components/schemas/V1AgentsIdGetResponsesContentApplicationJsonSchemaSandboxCapabilityIssuesItems"}},"status":{"type":"string"},"updatedAt":{"type":"string"},"userId":{"type":"string"}},"required":["agentType","capabilities","claudeManagedConfig","config","configHash","createdAt","description","externalConfig","healthStatus","icon","id","lastHealthCheckAt","lastModifiedSource","name","organizationId","publishedVersionId","status","updatedAt","userId"],"title":"Agents_getAgentDetails_Response_200"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaAgentType":{"type":"string","enum":["runtype","external","claude_managed"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaAgentType"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaCapabilityChangesAddItems":{"type":"object","properties":{"enabled":{"type":"boolean"},"flowId":{"type":"string"},"parametersSchema":{"description":"Any type"},"subAgentId":{"type":"string"},"toolDescription":{"type":"string"},"toolId":{"type":"string"},"toolName":{"type":"string","minLength":1,"maxLength":100}},"required":["toolName"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaCapabilityChangesAddItems"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaCapabilityChanges":{"type":"object","properties":{"add":{"type":"array","items":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaCapabilityChangesAddItems"},"default":[]},"remove":{"type":"array","items":{"type":"string"},"default":[]}},"description":"Capability additions and removals committed with the definition and its draft snapshot. If-Match guards the entire save.","title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaCapabilityChanges"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaClaudeManagedConfigCachedAgentInfoToolsItems":{"type":"object","properties":{"name":{"type":"string"},"type":{"type":"string"}},"required":["type"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaClaudeManagedConfigCachedAgentInfoToolsItems"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaClaudeManagedConfigCachedAgentInfo":{"type":"object","properties":{"description":{"type":"string"},"fetchedAt":{"type":"string"},"model":{"type":"string"},"name":{"type":"string"},"tools":{"type":"array","items":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaClaudeManagedConfigCachedAgentInfoToolsItems"}},"version":{"type":"number","format":"double"}},"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaClaudeManagedConfigCachedAgentInfo"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaClaudeManagedConfigCustomToolsItems":{"type":"object","properties":{"capabilityId":{"type":"string"},"parametersSchema":{"type":"object","additionalProperties":{"description":"Any type"}},"toolDescription":{"type":"string"},"toolName":{"type":"string"}},"required":["capabilityId","toolDescription","toolName"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaClaudeManagedConfigCustomToolsItems"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaClaudeManagedConfigMcpServersItems":{"type":"object","properties":{"name":{"type":"string"},"target":{"description":"Any type"},"url":{"type":"string","format":"uri"}},"required":["url"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaClaudeManagedConfigMcpServersItems"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaClaudeManagedConfigSetupMode":{"type":"string","enum":["create","connect"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaClaudeManagedConfigSetupMode"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaClaudeManagedConfigToolPermissions":{"type":"object","properties":{"bash":{"type":"boolean"},"edit":{"type":"boolean"},"glob":{"type":"boolean"},"grep":{"type":"boolean"},"read":{"type":"boolean"},"webFetch":{"type":"boolean"},"webSearch":{"type":"boolean"},"write":{"type":"boolean"}},"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaClaudeManagedConfigToolPermissions"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaClaudeManagedConfig":{"type":"object","properties":{"anthropicAgentId":{"type":"string","minLength":1},"anthropicAgentVersion":{"type":"integer"},"anthropicEnvironmentId":{"type":"string"},"cachedAgentInfo":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaClaudeManagedConfigCachedAgentInfo"},"customTools":{"type":"array","items":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaClaudeManagedConfigCustomToolsItems"}},"mcpServers":{"type":"array","items":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaClaudeManagedConfigMcpServersItems"}},"model":{"type":"string"},"outputHandoff":{"type":"boolean","description":"Scheduled and batch runs only. When true, files the agent writes to /mnt/session/outputs/ are stored as runtype-asset:// handles and the session is resumed for one delivery turn that lists them (for example, to attach them with send_email)."},"setupMode":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaClaudeManagedConfigSetupMode"},"systemPrompt":{"type":"string"},"timeoutMs":{"type":["integer","null"],"minimum":10000,"maximum":1800000},"toolPermissions":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaClaudeManagedConfigToolPermissions"}},"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaClaudeManagedConfig"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigAdvisor":{"type":"object","properties":{"model":{"type":"string"},"systemPrompt":{"type":"string"}},"required":["model"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigAdvisor"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigArtifactsTypesItems":{"type":"string","enum":["markdown","component"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigArtifactsTypesItems"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigArtifacts":{"type":"object","properties":{"enabled":{"type":"boolean"},"types":{"type":"array","items":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigArtifactsTypesItems"}}},"required":["enabled","types"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigArtifacts"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigBusyMessageRoutingMode":{"type":"string","enum":["enforced","off"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigBusyMessageRoutingMode"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigBusyMessageRouting":{"type":"object","properties":{"classifierModel":{"type":"string","minLength":1,"maxLength":200},"mode":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigBusyMessageRoutingMode"}},"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigBusyMessageRouting"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigContextManagementCompactionStrategy":{"type":"string","enum":["auto","provider_native","summary"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigContextManagementCompactionStrategy"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigContextManagementCompaction":{"type":"object","properties":{"enabled":{"type":"boolean"},"instructions":{"type":"string","maxLength":4000},"model":{"type":"string"},"retainRecentTokens":{"type":"integer","minimum":0},"strategy":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigContextManagementCompactionStrategy"},"thresholdRatio":{"type":"number","format":"double","minimum":0.3,"maximum":0.98},"thresholdTokens":{"type":"integer","minimum":50000}},"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigContextManagementCompaction"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigContextManagementToolResultsPruneMode":{"type":"string","enum":["mask","off"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigContextManagementToolResultsPruneMode"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigContextManagementToolResults":{"type":"object","properties":{"inlineThresholdChars":{"type":"integer","minimum":1024,"description":"Deprecated and ignored. Tool results are never spilled.","deprecated":true},"pruneHotWindowTokens":{"type":"integer","minimum":4000},"pruneMode":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigContextManagementToolResultsPruneMode"}},"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigContextManagementToolResults"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigContextManagement":{"type":"object","properties":{"compaction":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigContextManagementCompaction"},"toolResults":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigContextManagementToolResults"}},"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigContextManagement"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigDurabilityForced":{"type":"string","enum":["durable","in_process"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigDurabilityForced"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigDurability":{"type":"object","properties":{"forced":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigDurabilityForced"},"maxBudgetMs":{"type":["integer","null"],"minimum":1000,"maximum":86400000},"watchLeaseMs":{"type":["integer","null"],"minimum":10000,"maximum":1800000}},"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigDurability"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigErrorHandlingFallbacksItemsOneOf0Type":{"type":"string","enum":["retry"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigErrorHandlingFallbacksItemsOneOf0Type"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigErrorHandlingFallbacksItems0":{"type":"object","properties":{"delay":{"type":"integer","minimum":0,"maximum":60000},"type":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigErrorHandlingFallbacksItemsOneOf0Type"}},"required":["type"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigErrorHandlingFallbacksItems0"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigErrorHandlingFallbacksItemsOneOf1Type":{"type":"string","enum":["model"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigErrorHandlingFallbacksItemsOneOf1Type"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigErrorHandlingFallbacksItems1":{"type":"object","properties":{"delay":{"type":"integer","minimum":0,"maximum":60000},"maxTokens":{"type":"integer","minimum":1},"model":{"type":"string"},"temperature":{"type":"number","format":"double","minimum":0,"maximum":2},"type":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigErrorHandlingFallbacksItemsOneOf1Type"}},"required":["model","type"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigErrorHandlingFallbacksItems1"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigErrorHandlingFallbacksItemsOneOf2Type":{"type":"string","enum":["message"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigErrorHandlingFallbacksItemsOneOf2Type"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigErrorHandlingFallbacksItems2":{"type":"object","properties":{"delay":{"type":"integer","minimum":0,"maximum":60000},"message":{"type":"string"},"type":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigErrorHandlingFallbacksItemsOneOf2Type"}},"required":["message","type"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigErrorHandlingFallbacksItems2"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigErrorHandlingFallbacksItems":{"oneOf":[{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigErrorHandlingFallbacksItems0"},{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigErrorHandlingFallbacksItems1"},{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigErrorHandlingFallbacksItems2"}],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigErrorHandlingFallbacksItems"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigErrorHandlingOnError":{"type":"string","enum":["fail","continue","fallback"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigErrorHandlingOnError"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigErrorHandlingTriggersItemsType":{"type":"string","enum":["error","empty-output"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigErrorHandlingTriggersItemsType"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigErrorHandlingTriggersItems":{"type":"object","properties":{"type":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigErrorHandlingTriggersItemsType"}},"required":["type"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigErrorHandlingTriggersItems"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigErrorHandling":{"type":"object","properties":{"fallbacks":{"type":"array","items":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigErrorHandlingFallbacksItems"}},"onError":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigErrorHandlingOnError"},"triggers":{"type":"array","items":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigErrorHandlingTriggersItems"}}},"required":["onError"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigErrorHandling"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigLoggingPolicy":{"type":"string","enum":["default","on","off"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigLoggingPolicy"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigLoopConfig":{"type":"object","properties":{"enableReflection":{"type":"boolean"},"maxCost":{"type":"number","format":"double","minimum":0},"maxTurns":{"type":"integer","minimum":1,"maximum":100},"reflectionInterval":{"type":"integer","minimum":1,"maximum":50},"treatLengthCutoffAsFailure":{"type":"boolean"}},"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigLoopConfig"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigMemoryPointerScope":{"type":"string","enum":["shared","alias","version"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigMemoryPointerScope"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigMemory":{"type":"object","properties":{"enabled":{"type":"boolean"},"injectSummary":{"type":"boolean"},"pointerScope":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigMemoryPointerScope"},"profileTemplate":{"type":"string"}},"required":["enabled"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigMemory"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigOutputValidatorsItemsOneOf0Type":{"type":"string","enum":["candidate-question","requested-json","no-action","json-schema"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigOutputValidatorsItemsOneOf0Type"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigOutputValidatorsItems0":{"type":"object","properties":{"maxBounces":{"type":"integer","minimum":0,"maximum":10},"schema":{"type":"object","additionalProperties":{"description":"Any type"}},"type":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigOutputValidatorsItemsOneOf0Type"}},"required":["type"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigOutputValidatorsItems0"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigOutputValidatorsItemsOneOf1Type":{"type":"string","enum":["custom"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigOutputValidatorsItemsOneOf1Type"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigOutputValidatorsItems1":{"type":"object","properties":{"maxBounces":{"type":"integer","minimum":0,"maximum":10},"name":{"type":"string","minLength":1,"maxLength":128},"timeoutMs":{"type":"integer","minimum":1,"maximum":300000},"type":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigOutputValidatorsItemsOneOf1Type"}},"required":["name","type"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigOutputValidatorsItems1"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigOutputValidatorsItemsOneOf2Type":{"type":"string","enum":["flow"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigOutputValidatorsItemsOneOf2Type"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigOutputValidatorsItems2":{"type":"object","properties":{"flowId":{"type":"string","minLength":1},"maxBounces":{"type":"integer","minimum":0,"maximum":10},"outputVariable":{"type":"string","minLength":1,"maxLength":128},"timeoutMs":{"type":"integer","minimum":1,"maximum":300000},"type":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigOutputValidatorsItemsOneOf2Type"}},"required":["flowId","type"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigOutputValidatorsItems2"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigOutputValidatorsItemsOneOf3Type":{"type":"string","enum":["tool"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigOutputValidatorsItemsOneOf3Type"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigOutputValidatorsItems3":{"type":"object","properties":{"maxBounces":{"type":"integer","minimum":0,"maximum":10},"timeoutMs":{"type":"integer","minimum":1,"maximum":300000},"toolId":{"type":"string","minLength":1},"type":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigOutputValidatorsItemsOneOf3Type"}},"required":["toolId","type"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigOutputValidatorsItems3"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigOutputValidatorsItems":{"oneOf":[{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigOutputValidatorsItems0"},{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigOutputValidatorsItems1"},{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigOutputValidatorsItems2"},{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigOutputValidatorsItems3"}],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigOutputValidatorsItems"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigOutput":{"type":"object","properties":{"validators":{"type":"array","items":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigOutputValidatorsItems"}}},"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigOutput"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigPiiRedaction":{"type":"string","enum":["default","off","redact"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigPiiRedaction"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigReasoningOneOf1ReasoningEffort":{"type":"string","enum":["minimal","low","medium","high","xhigh","max"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigReasoningOneOf1ReasoningEffort"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigReasoningOneOf1ReasoningSummary":{"type":"string","enum":["auto","detailed"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigReasoningOneOf1ReasoningSummary"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigReasoning1":{"type":"object","properties":{"budgetTokens":{"type":"integer","minimum":1000,"maximum":100000},"effort":{"type":"string","minLength":1,"maxLength":32},"enabled":{"type":"boolean"},"includeThoughts":{"type":"boolean"},"reasoningEffort":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigReasoningOneOf1ReasoningEffort"},"reasoningSummary":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigReasoningOneOf1ReasoningSummary"},"thinkingBudget":{"type":"integer","minimum":1024,"maximum":65536},"thinkingLevel":{"type":"string","minLength":1,"maxLength":32}},"required":["enabled"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigReasoning1"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigReasoning":{"oneOf":[{"type":"boolean"},{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigReasoning1"}],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigReasoning"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigSandboxCodingAgentsItems":{"type":"string","enum":["opencode"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigSandboxCodingAgentsItems"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigSandboxInstanceType":{"type":"string","enum":["standard-1","standard-2","standard-3","standard-4"],"description":"Only standard-4 is supported on the hosted Agent Sandbox path; other sizes cannot be enabled.","title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigSandboxInstanceType"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigSandboxNetworkAccess0":{"type":"string","enum":["none","essentials","open"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigSandboxNetworkAccess0"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigSandboxNetworkAccessOneOf1Profile":{"type":"string","enum":["none","essentials","open"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigSandboxNetworkAccessOneOf1Profile"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigSandboxNetworkAccess1":{"type":"object","properties":{"allow":{"type":"array","items":{"type":"string"}},"profile":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigSandboxNetworkAccessOneOf1Profile"}},"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigSandboxNetworkAccess1"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigSandboxNetworkAccess":{"oneOf":[{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigSandboxNetworkAccess0"},{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigSandboxNetworkAccess1"}],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigSandboxNetworkAccess"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigSandboxPersistence":{"type":"string","enum":["ephemeral","conversation","named"],"description":"Supported: ephemeral or conversation. Named remains parseable for stored configs but cannot be enabled.","title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigSandboxPersistence"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigSandboxProvider":{"type":"string","enum":["runtype-sandbox","daytona"],"description":"Only runtype-sandbox is currently supported. Daytona is retained for stored-config parsing but rejected at authoring/execution.","title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigSandboxProvider"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigSandboxSleepAfter":{"type":"string","enum":["5m","15m","30m","1h"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigSandboxSleepAfter"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigSandboxTtl":{"type":"string","enum":["5m","1h","24h","unlimited"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigSandboxTtl"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigSandbox":{"type":"object","properties":{"codingAgents":{"type":"array","items":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigSandboxCodingAgentsItems"},"description":"Coding agents the Sandbox can run as typed sessions. Non-empty adds the agent_session_* tools; empty or absent adds none."},"enabled":{"type":"boolean"},"instanceType":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigSandboxInstanceType","description":"Only standard-4 is supported on the hosted Agent Sandbox path; other sizes cannot be enabled."},"networkAccess":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigSandboxNetworkAccess"},"persistence":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigSandboxPersistence","description":"Supported: ephemeral or conversation. Named remains parseable for stored configs but cannot be enabled."},"provider":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigSandboxProvider","description":"Only runtype-sandbox is currently supported. Daytona is retained for stored-config parsing but rejected at authoring/execution."},"secretEnv":{"type":"object","additionalProperties":{"type":"string","minLength":1}},"setupCommands":{"type":"array","items":{"type":"string","minLength":1}},"sleepAfter":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigSandboxSleepAfter"},"ttl":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigSandboxTtl"}},"required":["enabled"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigSandbox"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigStateMergeStrategy":{"type":"string","enum":["replace","merge"],"default":"merge","title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigStateMergeStrategy"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigStatePredictStateItems":{"type":"object","properties":{"stateKey":{"type":"string","minLength":1},"tool":{"type":"string","minLength":1},"toolArgument":{"type":"string","minLength":1}},"required":["stateKey","tool","toolArgument"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigStatePredictStateItems"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigState":{"type":"object","properties":{"initial":{"type":"object","additionalProperties":{"description":"Any type"}},"mergeStrategy":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigStateMergeStrategy","default":"merge"},"predictState":{"type":"array","items":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigStatePredictStateItems"}},"schema":{"type":"object","additionalProperties":{"description":"Any type"}}},"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigState"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigTemporal":{"type":"object","properties":{"elapsedThresholdSeconds":{"type":"integer","minimum":0},"groundNow":{"type":"boolean"},"injectElapsed":{"type":"boolean"},"timezone":{"type":"string"}},"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigTemporal"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigTenancyStrategyAssuranceFloorEndUser":{"type":"string","enum":["asserted","verified"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigTenancyStrategyAssuranceFloorEndUser"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigTenancyStrategyAssuranceFloorTenant":{"type":"string","enum":["asserted","verified"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigTenancyStrategyAssuranceFloorTenant"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigTenancyStrategyAssuranceFloor":{"type":"object","properties":{"endUser":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigTenancyStrategyAssuranceFloorEndUser"},"tenant":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigTenancyStrategyAssuranceFloorTenant"}},"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigTenancyStrategyAssuranceFloor"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigTenancyStrategyPreset":{"type":"string","enum":["internal","tenant-isolated","end-user-isolated"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigTenancyStrategyPreset"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigTenancyStrategy":{"type":"object","properties":{"assuranceFloor":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigTenancyStrategyAssuranceFloor"},"preset":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigTenancyStrategyPreset"}},"required":["preset"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigTenancyStrategy"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigToolsApprovalApprover":{"type":"string","enum":["owner","end-user"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigToolsApprovalApprover"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigToolsApprovalChoices":{"type":"object","properties":{"alwaysAllow":{"type":"boolean"},"alwaysDeny":{"type":"boolean"}},"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigToolsApprovalChoices"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigToolsApprovalRequire":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"boolean"}],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigToolsApprovalRequire"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigToolsApproval":{"type":"object","properties":{"approver":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigToolsApprovalApprover"},"choices":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigToolsApprovalChoices"},"notifyUser":{"type":"boolean"},"requestReason":{"type":"boolean"},"require":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigToolsApprovalRequire"},"timeout":{"type":"number","format":"double"}},"required":["require"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigToolsApproval"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigToolsCodeModeConfig":{"type":"object","properties":{"description":{"type":"string"},"timeoutMs":{"type":"integer","minimum":1000,"maximum":600000},"toolPool":{"type":"array","items":{"type":"string"}}},"required":["toolPool"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigToolsCodeModeConfig"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigToolsIntent":{"type":"string","enum":["mandatory","best-effort"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigToolsIntent"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigToolsMcpServersItemsAuthType":{"type":"string","enum":["api_key","bearer","basic","custom_header","headers","none"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigToolsMcpServersItemsAuthType"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigToolsMcpServersItemsAuth":{"type":"object","properties":{"headerName":{"type":"string"},"headers":{"type":"object","additionalProperties":{"type":"string"}},"password":{"type":"string"},"token":{"type":"string"},"type":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigToolsMcpServersItemsAuthType"},"username":{"type":"string"}},"required":["type"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigToolsMcpServersItemsAuth"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigToolsMcpServersItemsTargetKind":{"type":"string","enum":["sandbox-deployment"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigToolsMcpServersItemsTargetKind"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigToolsMcpServersItemsTarget":{"type":"object","properties":{"bearerSecretName":{"type":"string"},"deploymentId":{"type":"string","pattern":"^sbd_[0-9abcdefghjkmnpqrstvwxyz]{20,32}$"},"kind":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigToolsMcpServersItemsTargetKind"},"path":{"type":"string"}},"required":["deploymentId","kind"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigToolsMcpServersItemsTarget"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigToolsMcpServersItemsTransport":{"type":"string","enum":["streamable_http","rest"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigToolsMcpServersItemsTransport"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigToolsMcpServersItems":{"type":"object","properties":{"allowedTools":{"type":"array","items":{"type":"string"}},"auth":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigToolsMcpServersItemsAuth"},"enabled":{"type":"boolean"},"id":{"type":"string"},"identityAudiences":{"type":"array","items":{"type":"string"}},"name":{"type":"string"},"target":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigToolsMcpServersItemsTarget"},"timeout":{"type":"number","format":"double"},"transport":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigToolsMcpServersItemsTransport"},"url":{"type":"string"}},"required":["id"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigToolsMcpServersItems"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigToolsPerToolLimits":{"type":"object","properties":{"maxCalls":{"type":"number","format":"double"},"required":{"type":"boolean"}},"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigToolsPerToolLimits"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigToolsRuntimeToolsItemsToolType":{"type":"string","enum":["flow","custom","external","local","advisor","subagent","search"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigToolsRuntimeToolsItemsToolType"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigToolsRuntimeToolsItems":{"type":"object","properties":{"config":{"type":"object","additionalProperties":{"description":"Any type"}},"description":{"type":"string"},"hiddenParameterNames":{"type":"array","items":{"type":"string","minLength":1}},"idempotent":{"type":"boolean"},"name":{"type":"string"},"parametersSchema":{"type":"object","additionalProperties":{"description":"Any type"}},"toolType":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigToolsRuntimeToolsItemsToolType"}},"required":["config","description","name","parametersSchema","toolType"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigToolsRuntimeToolsItems"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigToolsSubagentConfigDefaultExecutionMode":{"type":"string","enum":["attached","detached"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigToolsSubagentConfigDefaultExecutionMode"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigToolsSubagentConfigDefaultNotify":{"type":"string","enum":["none","narrate","react"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigToolsSubagentConfigDefaultNotify"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigToolsSubagentConfigExecutionModesItems":{"type":"string","enum":["attached","detached"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigToolsSubagentConfigExecutionModesItems"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigToolsSubagentConfig":{"type":"object","properties":{"allowNesting":{"type":"boolean"},"defaultExecutionMode":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigToolsSubagentConfigDefaultExecutionMode"},"defaultMaxTurns":{"type":"integer","minimum":1,"maximum":100},"defaultModel":{"type":"string"},"defaultNotify":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigToolsSubagentConfigDefaultNotify"},"defaultTimeoutMs":{"type":"integer","minimum":1000,"maximum":600000},"detachedMaxBudgetMs":{"type":"integer","minimum":1000,"maximum":86400000},"detachedNoProgressBudgetMs":{"type":"integer","minimum":1000,"maximum":86400000},"executionModes":{"type":"array","items":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigToolsSubagentConfigExecutionModesItems"}},"maxSpawnsPerRun":{"type":"integer","minimum":1,"maximum":50},"maxTurnsLimit":{"type":"integer","minimum":1,"maximum":100},"toolPool":{"type":"array","items":{"type":"string"}}},"required":["toolPool"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigToolsSubagentConfig"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigToolsToolCallStrategy":{"type":"string","enum":["auto","required","none"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigToolsToolCallStrategy"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigToolsToolSearch":{"type":"object","properties":{"alwaysLoaded":{"type":"array","items":{"type":"string"}},"enabled":{"type":"boolean"},"threshold":{"type":"number","format":"double"}},"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigToolsToolSearch"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigTools":{"type":"object","properties":{"approval":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigToolsApproval"},"codeModeConfig":{"oneOf":[{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigToolsCodeModeConfig"},{"type":"null"}]},"intent":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigToolsIntent"},"maxToolCalls":{"type":"integer","minimum":1,"maximum":100},"mcpServers":{"type":"array","items":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigToolsMcpServersItems"}},"perToolLimits":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigToolsPerToolLimits"}},"runtimeTools":{"type":"array","items":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigToolsRuntimeToolsItems"}},"subagentConfig":{"oneOf":[{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigToolsSubagentConfig"},{"type":"null"}]},"toolCallStrategy":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigToolsToolCallStrategy"},"toolConfigs":{"type":"object","additionalProperties":{"type":"object","additionalProperties":{"description":"Any type"}}},"toolIds":{"type":"array","items":{"type":"string"}},"toolSearch":{"oneOf":[{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigToolsToolSearch"},{"type":"null"}]}},"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigTools"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigVoiceDirectTools":{"type":"object","properties":{"enabled":{"type":"boolean"},"model":{"type":"string","minLength":1}},"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigVoiceDirectTools"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigVoiceElevenLabs":{"type":"object","properties":{"modelId":{"type":"string","minLength":1},"similarity":{"type":"number","format":"double","minimum":0,"maximum":1},"stability":{"type":"number","format":"double","minimum":0,"maximum":1},"voiceId":{"type":"string","minLength":1}},"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigVoiceElevenLabs"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigVoiceEndpointingStrategy":{"type":"string","enum":["provider_vad","server_vad","client_commit","manual"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigVoiceEndpointingStrategy"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigVoiceEndpointing":{"type":"object","properties":{"silenceMs":{"type":"integer","minimum":0,"maximum":30000},"strategy":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigVoiceEndpointingStrategy"}},"required":["strategy"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigVoiceEndpointing"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigVoiceInterruptionMode":{"type":"string","enum":["none","cancel","barge-in"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigVoiceInterruptionMode"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigVoiceSpeechMode":{"type":"string","enum":["pipeline","speech_to_speech","provider_managed"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigVoiceSpeechMode"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigVoiceSpeechSynthesizerSettings":{"type":"object","properties":{"similarity":{"type":"number","format":"double","minimum":0,"maximum":1},"stability":{"type":"number","format":"double","minimum":0,"maximum":1}},"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigVoiceSpeechSynthesizerSettings"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigVoiceSpeechSynthesizer":{"type":"object","properties":{"model":{"type":"string","minLength":1},"provider":{"type":"string","minLength":1},"settings":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigVoiceSpeechSynthesizerSettings"},"voiceId":{"type":"string","minLength":1}},"required":["provider"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigVoiceSpeechSynthesizer"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigVoiceSpeechTranscriber":{"type":"object","properties":{"model":{"type":"string","minLength":1},"provider":{"type":"string","minLength":1}},"required":["provider"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigVoiceSpeechTranscriber"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigVoiceSpeech":{"type":"object","properties":{"mode":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigVoiceSpeechMode"},"synthesizer":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigVoiceSpeechSynthesizer"},"transcriber":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigVoiceSpeechTranscriber"}},"required":["mode","synthesizer","transcriber"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigVoiceSpeech"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigVoice":{"type":"object","properties":{"directTools":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigVoiceDirectTools"},"disclosure":{"type":"boolean"},"elevenLabs":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigVoiceElevenLabs"},"enabled":{"type":"boolean"},"endpointing":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigVoiceEndpointing"},"greeting":{"type":"string","maxLength":2000},"interruptionMode":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigVoiceInterruptionMode"},"language":{"type":"string","minLength":1,"maxLength":64},"provider":{"type":"string","minLength":1},"speech":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigVoiceSpeech"}},"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigVoice"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfig":{"type":"object","properties":{"advisor":{"oneOf":[{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigAdvisor"},{"type":"null"}]},"artifacts":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigArtifacts"},"busyMessageRouting":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigBusyMessageRouting"},"contextManagement":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigContextManagement"},"durability":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigDurability"},"errorHandling":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigErrorHandling"},"frequencyPenalty":{"type":"number","format":"double","minimum":-2,"maximum":2},"loggingPolicy":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigLoggingPolicy"},"loopConfig":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigLoopConfig"},"maxTokens":{"type":["integer","null"],"minimum":1},"memory":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigMemory"},"model":{"type":"string"},"output":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigOutput"},"piiRedaction":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigPiiRedaction"},"presencePenalty":{"type":"number","format":"double","minimum":-2,"maximum":2},"reasoning":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigReasoning"},"sandbox":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigSandbox"},"seed":{"type":"integer"},"state":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigState"},"systemPrompt":{"type":"string"},"temperature":{"type":"number","format":"double","minimum":0,"maximum":2},"temporal":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigTemporal"},"tenancyStrategy":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigTenancyStrategy"},"tools":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigTools"},"topK":{"type":"integer","minimum":1,"maximum":500},"topP":{"type":"number","format":"double","minimum":0,"maximum":1},"voice":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfigVoice"}},"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaConfig"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaExternalConfigAuthType":{"type":"string","enum":["none","bearer","api_key","basic"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaExternalConfigAuthType"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaExternalConfigAuth":{"type":"object","properties":{"credentials":{"type":"string"},"headerName":{"type":"string"},"type":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaExternalConfigAuthType"}},"required":["type"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaExternalConfigAuth"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaExternalConfigCachedAgentCardCapabilitiesStatefulness":{"type":"string","enum":["none","task","session"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaExternalConfigCachedAgentCardCapabilitiesStatefulness"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaExternalConfigCachedAgentCardCapabilities":{"type":"object","properties":{"pushNotifications":{"type":"boolean"},"statefulness":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaExternalConfigCachedAgentCardCapabilitiesStatefulness"},"streaming":{"type":"boolean"}},"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaExternalConfigCachedAgentCardCapabilities"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaExternalConfigCachedAgentCardSkillsItems":{"type":"object","properties":{"description":{"type":"string"},"id":{"type":"string"},"inputSchema":{"type":"object","additionalProperties":{"description":"Any type"}},"name":{"type":"string"},"outputSchema":{"type":"object","additionalProperties":{"description":"Any type"}}},"required":["id","name"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaExternalConfigCachedAgentCardSkillsItems"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaExternalConfigCachedAgentCard":{"type":"object","properties":{"capabilities":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaExternalConfigCachedAgentCardCapabilities"},"description":{"type":"string"},"fetchedAt":{"type":"string"},"name":{"type":"string"},"protocolVersion":{"type":"string"},"skills":{"type":"array","items":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaExternalConfigCachedAgentCardSkillsItems"}},"version":{"type":"string"}},"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaExternalConfigCachedAgentCard"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaExternalConfigFramework":{"type":"string","enum":["langchain","vercel_ai","crewai","cloudflare","autogen","flue","mastra","custom"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaExternalConfigFramework"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaExternalConfigProtocol":{"type":"string","enum":["a2a","runtype-stream"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaExternalConfigProtocol"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaExternalConfigSkillOrchestration0":{"type":"string","enum":["delegate","managed"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaExternalConfigSkillOrchestration0"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaExternalConfigSkillOrchestration1":{"type":"string","enum":["agent_skill","runtype","none"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaExternalConfigSkillOrchestration1"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaExternalConfigSkillOrchestration":{"oneOf":[{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaExternalConfigSkillOrchestration0"},{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaExternalConfigSkillOrchestration1"}],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaExternalConfigSkillOrchestration"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaExternalConfigSkillOrchestratorReasoningOneOf1ReasoningEffort":{"type":"string","enum":["minimal","low","medium","high","xhigh","max"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaExternalConfigSkillOrchestratorReasoningOneOf1ReasoningEffort"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaExternalConfigSkillOrchestratorReasoningOneOf1ReasoningSummary":{"type":"string","enum":["auto","detailed"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaExternalConfigSkillOrchestratorReasoningOneOf1ReasoningSummary"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaExternalConfigSkillOrchestratorReasoning1":{"type":"object","properties":{"budgetTokens":{"type":"integer","minimum":1000,"maximum":100000},"effort":{"type":"string","minLength":1,"maxLength":32},"enabled":{"type":"boolean"},"includeThoughts":{"type":"boolean"},"reasoningEffort":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaExternalConfigSkillOrchestratorReasoningOneOf1ReasoningEffort"},"reasoningSummary":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaExternalConfigSkillOrchestratorReasoningOneOf1ReasoningSummary"},"thinkingBudget":{"type":"integer","minimum":1024,"maximum":65536},"thinkingLevel":{"type":"string","minLength":1,"maxLength":32}},"required":["enabled"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaExternalConfigSkillOrchestratorReasoning1"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaExternalConfigSkillOrchestratorReasoning":{"oneOf":[{"type":"boolean"},{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaExternalConfigSkillOrchestratorReasoning1"}],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaExternalConfigSkillOrchestratorReasoning"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaExternalConfigSkillOrchestrator":{"type":"object","properties":{"frequencyPenalty":{"type":"number","format":"double","minimum":-2,"maximum":2},"model":{"type":"string"},"presencePenalty":{"type":"number","format":"double","minimum":-2,"maximum":2},"reasoning":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaExternalConfigSkillOrchestratorReasoning"},"seed":{"type":"integer"},"systemPrompt":{"type":"string"},"temperature":{"type":"number","format":"double","minimum":0,"maximum":1},"topK":{"type":"integer","minimum":1,"maximum":500},"topP":{"type":"number","format":"double","minimum":0,"maximum":1}},"required":["model"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaExternalConfigSkillOrchestrator"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaExternalConfigSkillsOverrideItemsRole":{"type":"string","enum":["orchestrator","tool","standalone","hidden"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaExternalConfigSkillsOverrideItemsRole"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaExternalConfigSkillsOverrideItems":{"type":"object","properties":{"enabled":{"type":"boolean"},"exposedDescription":{"type":"string"},"exposedName":{"type":"string"},"id":{"type":"string"},"isNew":{"type":"boolean"},"role":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaExternalConfigSkillsOverrideItemsRole"}},"required":["enabled","id"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaExternalConfigSkillsOverrideItems"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaExternalConfigTransport":{"type":"string","enum":["http","device"],"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaExternalConfigTransport"},"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaExternalConfig":{"type":"object","properties":{"agentCardUrl":{"type":["string","null"],"format":"uri"},"auth":{"oneOf":[{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaExternalConfigAuth"},{"type":"null"}]},"cachedAgentCard":{"oneOf":[{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaExternalConfigCachedAgentCard"},{"type":"null"}]},"deviceId":{"type":["string","null"],"minLength":1,"maxLength":128},"endpoint":{"type":"string","format":"uri"},"framework":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaExternalConfigFramework"},"identityAssertion":{"type":["boolean","null"],"description":"Send a short-lived, Runtype-signed identity assertion (ES256 JWT, `aud` = endpoint host) in the `X-Runtype-Identity` header. Requires a tenancy strategy and a resolved tenant or end user; a call without one is refused before it reaches the agent."},"protocol":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaExternalConfigProtocol"},"retryCount":{"type":["integer","null"],"minimum":0,"maximum":10},"skillOrchestration":{"oneOf":[{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaExternalConfigSkillOrchestration"},{"type":"null"}]},"skillOrchestrator":{"oneOf":[{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaExternalConfigSkillOrchestrator"},{"type":"null"}]},"skillsOverride":{"type":["array","null"],"items":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaExternalConfigSkillsOverrideItems"}},"timeoutMs":{"type":["integer","null"],"minimum":1000,"maximum":300000},"transport":{"$ref":"#/components/schemas/V1AgentsIdPutRequestBodyContentApplicationJsonSchemaExternalConfigTransport"}},"title":"V1AgentsIdPutRequestBodyContentApplicationJsonSchemaExternalConfig"},"V1AgentsIdPutResponsesContentApplicationJsonSchemaSandboxCapabilityIssuesItemsCode":{"type":"string","enum":["unsupported_sandbox_capability"],"title":"V1AgentsIdPutResponsesContentApplicationJsonSchemaSandboxCapabilityIssuesItemsCode"},"V1AgentsIdPutResponsesContentApplicationJsonSchemaSandboxCapabilityIssuesItems":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/V1AgentsIdPutResponsesContentApplicationJsonSchemaSandboxCapabilityIssuesItemsCode"},"message":{"type":"string"},"path":{"type":"string"},"requested":{"type":"string"},"supported":{"type":"array","items":{"type":"string"}}},"required":["code","message","path","requested","supported"],"title":"V1AgentsIdPutResponsesContentApplicationJsonSchemaSandboxCapabilityIssuesItems"},"Agents_updateAgent_Response_200":{"type":"object","properties":{"_warnings":{"type":"array","items":{"type":"string"}},"agentType":{"type":"string"},"claudeManagedConfig":{"type":["object","null"],"additionalProperties":{"description":"Any type"}},"config":{"type":["object","null"],"additionalProperties":{"description":"Any type"}},"configHash":{"type":["string","null"]},"createdAt":{"type":"string"},"dashboardUrl":{"type":"string"},"description":{"type":["string","null"]},"draftVersionId":{"type":["string","null"]},"externalConfig":{"type":["object","null"],"additionalProperties":{"description":"Any type"},"description":"External-agent configuration. Configured auth.credentials values are write-only and returned as <redacted>, never plaintext."},"healthStatus":{"type":["string","null"]},"icon":{"type":["string","null"]},"id":{"type":"string"},"lastHealthCheckAt":{"type":["string","null"]},"lastModifiedSource":{"type":["string","null"]},"name":{"type":"string"},"organizationId":{"type":["string","null"]},"publishedVersionId":{"type":["string","null"]},"sandboxCapabilityIssues":{"type":"array","items":{"$ref":"#/components/schemas/V1AgentsIdPutResponsesContentApplicationJsonSchemaSandboxCapabilityIssuesItems"}},"savedVersionId":{"type":["string","null"],"description":"The snapshot committed with this update, or the current draft snapshot for an unchanged definition. Save repairs a missing snapshot without changing the definition revision. Definition, capability, and snapshot failures roll back together."},"status":{"type":"string"},"updatedAt":{"type":"string"},"userId":{"type":"string"}},"required":["agentType","claudeManagedConfig","config","configHash","createdAt","description","draftVersionId","externalConfig","healthStatus","icon","id","lastHealthCheckAt","lastModifiedSource","name","organizationId","publishedVersionId","savedVersionId","status","updatedAt","userId"],"title":"Agents_updateAgent_Response_200"},"Agents_deleteAgent_Response_200":{"type":"object","properties":{"success":{"type":"boolean"}},"required":["success"],"title":"Agents_deleteAgent_Response_200"},"ExecutionStreamEventOneOf0Kind":{"type":"string","enum":["agent","flow"],"title":"ExecutionStreamEventOneOf0Kind"},"ExecutionStreamEventOneOf0Type":{"type":"string","enum":["execution_start"],"title":"ExecutionStreamEventOneOf0Type"},"ExecutionStreamEvent0":{"type":"object","properties":{"agentId":{"type":"string"},"agentName":{"type":"string"},"config":{"type":"object","additionalProperties":{"description":"Any type"}},"executionId":{"type":"string"},"flowId":{"type":"string"},"flowName":{"type":"string"},"kind":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf0Kind"},"maxTurns":{"type":"number","format":"double"},"resumed":{"type":"boolean"},"seq":{"type":"number","format":"double"},"source":{"type":"string"},"startedAt":{"type":"string"},"totalSteps":{"type":"number","format":"double"},"type":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf0Type"}},"required":["executionId","kind","seq","startedAt","type"],"title":"ExecutionStreamEvent0"},"ExecutionStreamEventOneOf1ExternalAgent":{"type":"object","properties":{"contextId":{"type":"string"},"taskId":{"type":"string"}},"title":"ExecutionStreamEventOneOf1ExternalAgent"},"ExecutionStreamEventOneOf1Kind":{"type":"string","enum":["agent","flow"],"title":"ExecutionStreamEventOneOf1Kind"},"ExecutionStreamEventOneOf1Outcome":{"type":"string","enum":["completed","error","aborted"],"description":"How the execution ended: `completed`, `error`, or `aborted` (cancelled, interrupted, or superseded by the caller or host). Absent on frames from older producers: treat `execution_error` as `error` and `execution_complete` as `completed`, or `error` when `success` is false.","title":"ExecutionStreamEventOneOf1Outcome"},"ExecutionStreamEventOneOf1OutputValidation":{"type":"object","properties":{"errored":{"type":"array","items":{"type":"string"}},"failed":{"type":"array","items":{"type":"string"}}},"title":"ExecutionStreamEventOneOf1OutputValidation"},"ExecutionStreamEventOneOf1Output":{"type":"object","properties":{"validation":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf1OutputValidation"}},"title":"ExecutionStreamEventOneOf1Output"},"ExecutionStreamEventOneOf1TotalTokens":{"type":"object","properties":{"input":{"type":"number","format":"double"},"output":{"type":"number","format":"double"}},"required":["input","output"],"title":"ExecutionStreamEventOneOf1TotalTokens"},"ExecutionStreamEventOneOf1Type":{"type":"string","enum":["execution_complete"],"title":"ExecutionStreamEventOneOf1Type"},"ExecutionStreamEventOneOf1WarningsItems":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"],"title":"ExecutionStreamEventOneOf1WarningsItems"},"ExecutionStreamEvent1":{"type":"object","properties":{"claudeManagedAgentId":{"type":"string"},"completedAt":{"type":"string"},"durationMs":{"type":"number","format":"double"},"executionId":{"type":"string"},"externalAgent":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf1ExternalAgent"},"failedSteps":{"type":"number","format":"double"},"finalOutput":{"type":"string"},"iterations":{"type":"number","format":"double"},"kind":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf1Kind"},"outcome":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf1Outcome","description":"How the execution ended: `completed`, `error`, or `aborted` (cancelled, interrupted, or superseded by the caller or host). Absent on frames from older producers: treat `execution_error` as `error` and `execution_complete` as `completed`, or `error` when `success` is false."},"output":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf1Output"},"seq":{"type":"number","format":"double"},"stepErrorCount":{"type":"number","format":"double"},"stopReason":{"type":"string"},"success":{"type":"boolean"},"successfulSteps":{"type":"number","format":"double"},"totalCost":{"type":"number","format":"double"},"totalSteps":{"type":"number","format":"double"},"totalTokens":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf1TotalTokens"},"totalTokensUsed":{"type":"number","format":"double"},"truncatedStepCount":{"type":"number","format":"double"},"type":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf1Type"},"warnings":{"type":"array","items":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf1WarningsItems"}}},"required":["executionId","kind","seq","success","type"],"title":"ExecutionStreamEvent1"},"ExecutionStreamEventOneOf2Error1":{"type":"object","properties":{"code":{"type":"string"},"details":{"type":"object","additionalProperties":{"description":"Any type"}},"message":{"type":"string"}},"required":["code","message"],"title":"ExecutionStreamEventOneOf2Error1"},"ExecutionStreamEventOneOf2Error":{"oneOf":[{"type":"string"},{"$ref":"#/components/schemas/ExecutionStreamEventOneOf2Error1"}],"title":"ExecutionStreamEventOneOf2Error"},"ExecutionStreamEventOneOf2Kind":{"type":"string","enum":["agent","flow"],"title":"ExecutionStreamEventOneOf2Kind"},"ExecutionStreamEventOneOf2Outcome":{"type":"string","enum":["completed","error","aborted"],"description":"How the execution ended: `completed`, `error`, or `aborted` (cancelled, interrupted, or superseded by the caller or host). Absent on frames from older producers: treat `execution_error` as `error` and `execution_complete` as `completed`, or `error` when `success` is false.","title":"ExecutionStreamEventOneOf2Outcome"},"ExecutionStreamEventOneOf2Type":{"type":"string","enum":["execution_error"],"title":"ExecutionStreamEventOneOf2Type"},"ExecutionStreamEvent2":{"type":"object","properties":{"blockReason":{"type":"string"},"code":{"type":"string"},"completedAt":{"type":"string"},"error":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf2Error"},"executionId":{"type":"string"},"finalOutput":{"type":"string"},"kind":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf2Kind"},"outcome":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf2Outcome","description":"How the execution ended: `completed`, `error`, or `aborted` (cancelled, interrupted, or superseded by the caller or host). Absent on frames from older producers: treat `execution_error` as `error` and `execution_complete` as `completed`, or `error` when `success` is false."},"seq":{"type":"number","format":"double"},"stopReason":{"type":"string"},"type":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf2Type"},"upgradeUrl":{"type":"string"}},"required":["error","executionId","kind","seq","type"],"title":"ExecutionStreamEvent2"},"ExecutionStreamEventOneOf3Role":{"type":"string","enum":["user","assistant","system"],"title":"ExecutionStreamEventOneOf3Role"},"ExecutionStreamEventOneOf3Subagent":{"type":"object","properties":{"agentName":{"type":"string"},"parentToolCallId":{"type":"string"},"toolName":{"type":"string"}},"required":["toolName"],"title":"ExecutionStreamEventOneOf3Subagent"},"ExecutionStreamEventOneOf3Type":{"type":"string","enum":["turn_start"],"title":"ExecutionStreamEventOneOf3Type"},"ExecutionStreamEvent3":{"type":"object","properties":{"executionId":{"type":"string"},"id":{"type":"string"},"iteration":{"type":"number","format":"double"},"role":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf3Role"},"seq":{"type":"number","format":"double"},"subagent":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf3Subagent"},"turnIndex":{"type":"number","format":"double"},"type":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf3Type"}},"required":["executionId","id","role","seq","type"],"title":"ExecutionStreamEvent3"},"ExecutionStreamEventOneOf4Attributes":{"oneOf":[{"type":"string"},{"type":"number","format":"double"},{"type":"boolean"}],"title":"ExecutionStreamEventOneOf4Attributes"},"ExecutionStreamEventOneOf4EstimatedContextBreakdownCategories":{"type":"object","properties":{"chars":{"type":"number","format":"double"},"estimatedTokens":{"type":"number","format":"double"}},"required":["chars","estimatedTokens"],"title":"ExecutionStreamEventOneOf4EstimatedContextBreakdownCategories"},"ExecutionStreamEventOneOf4EstimatedContextBreakdown":{"type":"object","properties":{"categories":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf4EstimatedContextBreakdownCategories"}},"contextWindowSize":{"type":"number","format":"double"},"estimatedTotalTokens":{"type":"number","format":"double"},"estimatedUtilizationPercent":{"type":"number","format":"double"}},"required":["categories","estimatedTotalTokens"],"title":"ExecutionStreamEventOneOf4EstimatedContextBreakdown"},"ExecutionStreamEventOneOf4FallbackAttemptsItemsType":{"type":"string","enum":["retry","model","message","flow"],"title":"ExecutionStreamEventOneOf4FallbackAttemptsItemsType"},"ExecutionStreamEventOneOf4FallbackAttemptsItems":{"type":"object","properties":{"attempt":{"type":"number","format":"double"},"error":{"type":"string"},"model":{"type":"string"},"success":{"type":"boolean"},"type":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf4FallbackAttemptsItemsType"}},"required":["attempt","success","type"],"title":"ExecutionStreamEventOneOf4FallbackAttemptsItems"},"ExecutionStreamEventOneOf4Fallback":{"type":"object","properties":{"attempts":{"type":"array","items":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf4FallbackAttemptsItems"}},"exhausted":{"type":"boolean"},"model":{"type":"string"},"reason":{"type":["string","null"]},"used":{"type":"boolean"}},"required":["attempts","exhausted","used"],"title":"ExecutionStreamEventOneOf4Fallback"},"ExecutionStreamEventOneOf4Role":{"type":"string","enum":["user","assistant","system"],"title":"ExecutionStreamEventOneOf4Role"},"ExecutionStreamEventOneOf4StopReason":{"type":"string","enum":["end_turn","max_tool_calls","length","content_filter","error","unknown"],"title":"ExecutionStreamEventOneOf4StopReason"},"ExecutionStreamEventOneOf4Subagent":{"type":"object","properties":{"agentName":{"type":"string"},"parentToolCallId":{"type":"string"},"toolName":{"type":"string"}},"required":["toolName"],"title":"ExecutionStreamEventOneOf4Subagent"},"ExecutionStreamEventOneOf4Tokens":{"type":"object","properties":{"input":{"type":"number","format":"double"},"output":{"type":"number","format":"double"}},"required":["input","output"],"title":"ExecutionStreamEventOneOf4Tokens"},"ExecutionStreamEventOneOf4Type":{"type":"string","enum":["turn_complete"],"title":"ExecutionStreamEventOneOf4Type"},"ExecutionStreamEvent4":{"type":"object","properties":{"attributes":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf4Attributes"}},"completedAt":{"type":"string"},"content":{"type":"string"},"cost":{"type":"number","format":"double"},"estimatedContextBreakdown":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf4EstimatedContextBreakdown"},"executionId":{"type":"string"},"fallback":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf4Fallback"},"id":{"type":"string"},"iteration":{"type":"number","format":"double"},"role":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf4Role"},"seq":{"type":"number","format":"double"},"stopReason":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf4StopReason"},"subagent":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf4Subagent"},"tokens":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf4Tokens"},"type":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf4Type"}},"required":["executionId","id","role","seq","type"],"title":"ExecutionStreamEvent4"},"ExecutionStreamEventOneOf5Subagent":{"type":"object","properties":{"agentName":{"type":"string"},"parentToolCallId":{"type":"string"},"toolName":{"type":"string"}},"required":["toolName"],"title":"ExecutionStreamEventOneOf5Subagent"},"ExecutionStreamEventOneOf5Type":{"type":"string","enum":["model_call_start"],"title":"ExecutionStreamEventOneOf5Type"},"ExecutionStreamEvent5":{"type":"object","properties":{"executionId":{"type":"string"},"id":{"type":"string"},"iteration":{"type":"number","format":"double"},"model":{"type":"string"},"ordinal":{"type":"integer","minimum":0},"provider":{"type":"string"},"seq":{"type":"number","format":"double"},"startedAt":{"type":"string"},"stepId":{"type":"string"},"subagent":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf5Subagent"},"turnId":{"type":"string"},"type":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf5Type"}},"required":["executionId","id","ordinal","seq","type"],"title":"ExecutionStreamEvent5"},"ExecutionStreamEventOneOf6Attributes":{"oneOf":[{"type":"string"},{"type":"number","format":"double"},{"type":"boolean"}],"title":"ExecutionStreamEventOneOf6Attributes"},"ExecutionStreamEventOneOf6Subagent":{"type":"object","properties":{"agentName":{"type":"string"},"parentToolCallId":{"type":"string"},"toolName":{"type":"string"}},"required":["toolName"],"title":"ExecutionStreamEventOneOf6Subagent"},"ExecutionStreamEventOneOf6Tokens":{"type":"object","properties":{"cacheRead":{"type":"number","format":"double"},"cacheWrite":{"type":"number","format":"double"},"input":{"type":"number","format":"double"},"output":{"type":"number","format":"double"},"reasoning":{"type":"number","format":"double"}},"required":["input","output"],"title":"ExecutionStreamEventOneOf6Tokens"},"ExecutionStreamEventOneOf6Type":{"type":"string","enum":["model_call_complete"],"title":"ExecutionStreamEventOneOf6Type"},"ExecutionStreamEvent6":{"type":"object","properties":{"attributes":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf6Attributes"}},"completedAt":{"type":"string"},"cost":{"type":"number","format":"double"},"durationMs":{"type":"number","format":"double"},"executionId":{"type":"string"},"finishReason":{"type":"string"},"id":{"type":"string"},"iteration":{"type":"number","format":"double"},"model":{"type":"string"},"ordinal":{"type":"integer","minimum":0},"provider":{"type":"string"},"responseModel":{"type":"string"},"seq":{"type":"number","format":"double"},"subagent":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf6Subagent"},"success":{"type":"boolean"},"tokens":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf6Tokens"},"turnId":{"type":"string"},"type":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf6Type"}},"required":["executionId","id","ordinal","seq","type"],"title":"ExecutionStreamEvent6"},"ExecutionStreamEventOneOf7Subagent":{"type":"object","properties":{"agentName":{"type":"string"},"parentToolCallId":{"type":"string"},"toolName":{"type":"string"}},"required":["toolName"],"title":"ExecutionStreamEventOneOf7Subagent"},"ExecutionStreamEventOneOf7Type":{"type":"string","enum":["step_start"],"title":"ExecutionStreamEventOneOf7Type"},"ExecutionStreamEvent7":{"type":"object","properties":{"executionId":{"type":"string"},"id":{"type":"string"},"index":{"type":"number","format":"double"},"name":{"type":"string"},"outputVariable":{"type":"string"},"seq":{"type":"number","format":"double"},"startedAt":{"type":"string"},"stepType":{"type":"string"},"subagent":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf7Subagent"},"totalSteps":{"type":"number","format":"double"},"type":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf7Type"}},"required":["executionId","id","seq","type"],"title":"ExecutionStreamEvent7"},"ExecutionStreamEventOneOf8FallbackAttemptsItemsType":{"type":"string","enum":["retry","model","message","flow"],"title":"ExecutionStreamEventOneOf8FallbackAttemptsItemsType"},"ExecutionStreamEventOneOf8FallbackAttemptsItems":{"type":"object","properties":{"attempt":{"type":"number","format":"double"},"error":{"type":"string"},"model":{"type":"string"},"success":{"type":"boolean"},"type":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf8FallbackAttemptsItemsType"}},"required":["attempt","success","type"],"title":"ExecutionStreamEventOneOf8FallbackAttemptsItems"},"ExecutionStreamEventOneOf8Fallback":{"type":"object","properties":{"attempts":{"type":"array","items":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf8FallbackAttemptsItems"}},"exhausted":{"type":"boolean"},"model":{"type":"string"},"reason":{"type":["string","null"]},"used":{"type":"boolean"}},"required":["attempts","exhausted","used"],"title":"ExecutionStreamEventOneOf8Fallback"},"ExecutionStreamEventOneOf8StopReason":{"type":"string","enum":["end_turn","max_tool_calls","length","content_filter","error","unknown"],"title":"ExecutionStreamEventOneOf8StopReason"},"ExecutionStreamEventOneOf8Subagent":{"type":"object","properties":{"agentName":{"type":"string"},"parentToolCallId":{"type":"string"},"toolName":{"type":"string"}},"required":["toolName"],"title":"ExecutionStreamEventOneOf8Subagent"},"ExecutionStreamEventOneOf8Type":{"type":"string","enum":["step_complete"],"title":"ExecutionStreamEventOneOf8Type"},"ExecutionStreamEvent8":{"type":"object","properties":{"completedAt":{"type":"string"},"cost":{"type":"number","format":"double"},"durationMs":{"type":"number","format":"double"},"error":{"type":"string"},"executionId":{"type":"string"},"fallback":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf8Fallback"},"id":{"type":"string"},"name":{"type":"string"},"result":{"description":"Any type"},"seq":{"type":"number","format":"double"},"stepType":{"type":"string"},"stopReason":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf8StopReason"},"subagent":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf8Subagent"},"success":{"type":"boolean"},"tokensUsed":{"type":"number","format":"double"},"truncated":{"type":"boolean"},"type":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf8Type"},"unresolvedVariables":{"type":"array","items":{"type":"string"}}},"required":["executionId","id","seq","type"],"title":"ExecutionStreamEvent8"},"ExecutionStreamEventOneOf9Type":{"type":"string","enum":["step_skip"],"title":"ExecutionStreamEventOneOf9Type"},"ExecutionStreamEvent9":{"type":"object","properties":{"executionId":{"type":"string"},"id":{"type":"string"},"index":{"type":"number","format":"double"},"name":{"type":"string"},"seq":{"type":"number","format":"double"},"skippedAt":{"type":"string"},"stepType":{"type":"string"},"totalSteps":{"type":"number","format":"double"},"type":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf9Type"},"when":{"type":"string"}},"required":["executionId","id","seq","type"],"title":"ExecutionStreamEvent9"},"ExecutionStreamEventOneOf10Role":{"type":"string","enum":["user","assistant","system"],"title":"ExecutionStreamEventOneOf10Role"},"ExecutionStreamEventOneOf10Subagent":{"type":"object","properties":{"agentName":{"type":"string"},"parentToolCallId":{"type":"string"},"toolName":{"type":"string"}},"required":["toolName"],"title":"ExecutionStreamEventOneOf10Subagent"},"ExecutionStreamEventOneOf10Type":{"type":"string","enum":["text_start"],"title":"ExecutionStreamEventOneOf10Type"},"ExecutionStreamEvent10":{"type":"object","properties":{"executionId":{"type":"string"},"id":{"type":"string"},"parentToolCallId":{"type":"string"},"role":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf10Role"},"seq":{"type":"number","format":"double"},"stepId":{"type":"string"},"subagent":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf10Subagent"},"turnId":{"type":"string"},"type":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf10Type"}},"required":["executionId","id","seq","type"],"title":"ExecutionStreamEvent10"},"ExecutionStreamEventOneOf11Subagent":{"type":"object","properties":{"agentName":{"type":"string"},"parentToolCallId":{"type":"string"},"toolName":{"type":"string"}},"required":["toolName"],"title":"ExecutionStreamEventOneOf11Subagent"},"ExecutionStreamEventOneOf11Type":{"type":"string","enum":["text_delta"],"title":"ExecutionStreamEventOneOf11Type"},"ExecutionStreamEvent11":{"type":"object","properties":{"delta":{"type":"string"},"executionId":{"type":"string"},"id":{"type":"string"},"seq":{"type":"number","format":"double"},"subagent":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf11Subagent"},"type":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf11Type"}},"required":["delta","executionId","id","seq","type"],"title":"ExecutionStreamEvent11"},"ExecutionStreamEventOneOf12Subagent":{"type":"object","properties":{"agentName":{"type":"string"},"parentToolCallId":{"type":"string"},"toolName":{"type":"string"}},"required":["toolName"],"title":"ExecutionStreamEventOneOf12Subagent"},"ExecutionStreamEventOneOf12Type":{"type":"string","enum":["text_complete"],"title":"ExecutionStreamEventOneOf12Type"},"ExecutionStreamEvent12":{"type":"object","properties":{"executionId":{"type":"string"},"id":{"type":"string"},"seq":{"type":"number","format":"double"},"subagent":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf12Subagent"},"text":{"type":"string"},"type":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf12Type"}},"required":["executionId","id","seq","type"],"title":"ExecutionStreamEvent12"},"ExecutionStreamEventOneOf13Scope":{"type":"string","enum":["turn","loop"],"title":"ExecutionStreamEventOneOf13Scope"},"ExecutionStreamEventOneOf13Subagent":{"type":"object","properties":{"agentName":{"type":"string"},"parentToolCallId":{"type":"string"},"toolName":{"type":"string"}},"required":["toolName"],"title":"ExecutionStreamEventOneOf13Subagent"},"ExecutionStreamEventOneOf13Type":{"type":"string","enum":["reasoning_start"],"title":"ExecutionStreamEventOneOf13Type"},"ExecutionStreamEvent13":{"type":"object","properties":{"executionId":{"type":"string"},"id":{"type":"string"},"parentToolCallId":{"type":"string"},"scope":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf13Scope"},"seq":{"type":"number","format":"double"},"subagent":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf13Subagent"},"type":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf13Type"}},"required":["executionId","id","seq","type"],"title":"ExecutionStreamEvent13"},"ExecutionStreamEventOneOf14Subagent":{"type":"object","properties":{"agentName":{"type":"string"},"parentToolCallId":{"type":"string"},"toolName":{"type":"string"}},"required":["toolName"],"title":"ExecutionStreamEventOneOf14Subagent"},"ExecutionStreamEventOneOf14Type":{"type":"string","enum":["reasoning_delta"],"title":"ExecutionStreamEventOneOf14Type"},"ExecutionStreamEvent14":{"type":"object","properties":{"delta":{"type":"string"},"executionId":{"type":"string"},"id":{"type":"string"},"seq":{"type":"number","format":"double"},"subagent":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf14Subagent"},"type":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf14Type"}},"required":["delta","executionId","id","seq","type"],"title":"ExecutionStreamEvent14"},"ExecutionStreamEventOneOf15Scope":{"type":"string","enum":["turn","loop"],"title":"ExecutionStreamEventOneOf15Scope"},"ExecutionStreamEventOneOf15Subagent":{"type":"object","properties":{"agentName":{"type":"string"},"parentToolCallId":{"type":"string"},"toolName":{"type":"string"}},"required":["toolName"],"title":"ExecutionStreamEventOneOf15Subagent"},"ExecutionStreamEventOneOf15Type":{"type":"string","enum":["reasoning_complete"],"title":"ExecutionStreamEventOneOf15Type"},"ExecutionStreamEvent15":{"type":"object","properties":{"executionId":{"type":"string"},"id":{"type":"string"},"scope":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf15Scope"},"seq":{"type":"number","format":"double"},"subagent":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf15Subagent"},"text":{"type":"string"},"type":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf15Type"}},"required":["executionId","id","seq","type"],"title":"ExecutionStreamEvent15"},"ExecutionStreamEventOneOf16Role":{"type":"string","enum":["user","assistant","system"],"title":"ExecutionStreamEventOneOf16Role"},"ExecutionStreamEventOneOf16Type":{"type":"string","enum":["media_start"],"title":"ExecutionStreamEventOneOf16Type"},"ExecutionStreamEvent16":{"type":"object","properties":{"executionId":{"type":"string"},"id":{"type":"string"},"mediaType":{"type":"string"},"role":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf16Role"},"seq":{"type":"number","format":"double"},"toolCallId":{"type":"string"},"type":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf16Type"}},"required":["executionId","id","mediaType","seq","type"],"title":"ExecutionStreamEvent16"},"ExecutionStreamEventOneOf17Type":{"type":"string","enum":["media_delta"],"title":"ExecutionStreamEventOneOf17Type"},"ExecutionStreamEvent17":{"type":"object","properties":{"delta":{"type":"string"},"executionId":{"type":"string"},"id":{"type":"string"},"seq":{"type":"number","format":"double"},"type":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf17Type"}},"required":["delta","executionId","id","seq","type"],"title":"ExecutionStreamEvent17"},"ExecutionStreamEventOneOf18Type":{"type":"string","enum":["media_complete"],"title":"ExecutionStreamEventOneOf18Type"},"ExecutionStreamEvent18":{"type":"object","properties":{"data":{"type":"string"},"executionId":{"type":"string"},"id":{"type":"string"},"mediaType":{"type":"string"},"seq":{"type":"number","format":"double"},"toolCallId":{"type":"string"},"type":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf18Type"},"url":{"type":"string"}},"required":["executionId","id","seq","type"],"title":"ExecutionStreamEvent18"},"ExecutionStreamEventOneOf19ArtifactType":{"type":"string","enum":["markdown","component"],"title":"ExecutionStreamEventOneOf19ArtifactType"},"ExecutionStreamEventOneOf19File":{"type":"object","properties":{"language":{"type":"string"},"mimeType":{"type":"string"},"path":{"type":"string"}},"required":["mimeType","path"],"title":"ExecutionStreamEventOneOf19File"},"ExecutionStreamEventOneOf19Type":{"type":"string","enum":["artifact_start"],"title":"ExecutionStreamEventOneOf19Type"},"ExecutionStreamEvent19":{"type":"object","properties":{"artifactType":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf19ArtifactType"},"component":{"type":"string"},"executionId":{"type":"string"},"file":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf19File"},"id":{"type":"string","minLength":1},"seq":{"type":"number","format":"double"},"title":{"type":"string"},"type":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf19Type"}},"required":["artifactType","id","type"],"title":"ExecutionStreamEvent19"},"ExecutionStreamEventOneOf20Type":{"type":"string","enum":["artifact_delta"],"title":"ExecutionStreamEventOneOf20Type"},"ExecutionStreamEvent20":{"type":"object","properties":{"delta":{"type":"string"},"executionId":{"type":"string"},"id":{"type":"string","minLength":1},"seq":{"type":"number","format":"double"},"type":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf20Type"}},"required":["delta","id","type"],"title":"ExecutionStreamEvent20"},"ExecutionStreamEventOneOf21Type":{"type":"string","enum":["artifact_update"],"title":"ExecutionStreamEventOneOf21Type"},"ExecutionStreamEvent21":{"type":"object","properties":{"component":{"type":"string"},"executionId":{"type":"string"},"id":{"type":"string","minLength":1},"props":{"type":"object","additionalProperties":{"description":"Any type"}},"seq":{"type":"number","format":"double"},"type":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf21Type"}},"required":["component","id","props","type"],"title":"ExecutionStreamEvent21"},"ExecutionStreamEventOneOf22Type":{"type":"string","enum":["artifact_complete"],"title":"ExecutionStreamEventOneOf22Type"},"ExecutionStreamEvent22":{"type":"object","properties":{"executionId":{"type":"string"},"id":{"type":"string","minLength":1},"seq":{"type":"number","format":"double"},"type":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf22Type"}},"required":["id","type"],"title":"ExecutionStreamEvent22"},"ExecutionStreamEventOneOf23Type":{"type":"string","enum":["source"],"title":"ExecutionStreamEventOneOf23Type"},"ExecutionStreamEvent23":{"type":"object","properties":{"executionId":{"type":"string"},"id":{"type":"string"},"seq":{"type":"number","format":"double"},"sourceType":{"type":"string"},"title":{"type":"string"},"type":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf23Type"},"url":{"type":"string"}},"required":["executionId","seq","type"],"title":"ExecutionStreamEvent23"},"ExecutionStreamEventOneOf24Type":{"type":"string","enum":["state_snapshot"],"title":"ExecutionStreamEventOneOf24Type"},"ExecutionStreamEvent24":{"type":"object","properties":{"executionId":{"type":"string"},"iteration":{"type":"number","format":"double"},"seq":{"type":"number","format":"double"},"state":{"type":"object","additionalProperties":{"description":"Any type"}},"type":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf24Type"}},"required":["executionId","seq","state","type"],"title":"ExecutionStreamEvent24"},"ExecutionStreamEventOneOf25PatchItemsOp":{"type":"string","enum":["add","remove","replace","move","copy","test"],"title":"ExecutionStreamEventOneOf25PatchItemsOp"},"ExecutionStreamEventOneOf25PatchItems":{"type":"object","properties":{"from":{"type":"string"},"op":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf25PatchItemsOp"},"path":{"type":"string"},"value":{"description":"Any type"}},"required":["op","path"],"title":"ExecutionStreamEventOneOf25PatchItems"},"ExecutionStreamEventOneOf25Type":{"type":"string","enum":["state_delta"],"title":"ExecutionStreamEventOneOf25Type"},"ExecutionStreamEvent25":{"type":"object","properties":{"executionId":{"type":"string"},"iteration":{"type":"number","format":"double"},"patch":{"type":"array","items":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf25PatchItems"}},"seq":{"type":"number","format":"double"},"type":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf25Type"}},"required":["executionId","patch","seq","type"],"title":"ExecutionStreamEvent25"},"ExecutionStreamEventOneOf26Annotations":{"type":"object","properties":{"consequentialHint":{"type":"boolean"},"debugging":{"type":"boolean"},"destructiveHint":{"type":"boolean"},"idempotentHint":{"type":"boolean"},"openWorldHint":{"type":"boolean"},"readOnlyHint":{"type":"boolean"},"untrustedContentHint":{"type":"boolean"}},"title":"ExecutionStreamEventOneOf26Annotations"},"ExecutionStreamEventOneOf26Origin":{"type":"string","enum":["webmcp","sdk"],"title":"ExecutionStreamEventOneOf26Origin"},"ExecutionStreamEventOneOf26Subagent":{"type":"object","properties":{"agentName":{"type":"string"},"parentToolCallId":{"type":"string"},"toolName":{"type":"string"}},"required":["toolName"],"title":"ExecutionStreamEventOneOf26Subagent"},"ExecutionStreamEventOneOf26Type":{"type":"string","enum":["tool_start"],"title":"ExecutionStreamEventOneOf26Type"},"ExecutionStreamEvent26":{"type":"object","properties":{"annotations":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf26Annotations"},"executionId":{"type":"string"},"hiddenParameterNames":{"type":"array","items":{"type":"string"}},"iteration":{"type":"number","format":"double"},"origin":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf26Origin"},"pageOrigin":{"type":"string"},"parameters":{"type":"object","additionalProperties":{"description":"Any type"}},"seq":{"type":"number","format":"double"},"startedAt":{"type":"string"},"stepId":{"type":"string"},"subagent":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf26Subagent"},"toolCallId":{"type":"string"},"toolName":{"type":"string"},"toolType":{"type":"string"},"type":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf26Type"}},"required":["executionId","seq","toolCallId","toolName","toolType","type"],"title":"ExecutionStreamEvent26"},"ExecutionStreamEventOneOf27Subagent":{"type":"object","properties":{"agentName":{"type":"string"},"parentToolCallId":{"type":"string"},"toolName":{"type":"string"}},"required":["toolName"],"title":"ExecutionStreamEventOneOf27Subagent"},"ExecutionStreamEventOneOf27Type":{"type":"string","enum":["tool_input_delta"],"title":"ExecutionStreamEventOneOf27Type"},"ExecutionStreamEvent27":{"type":"object","properties":{"delta":{"type":"string"},"executionId":{"type":"string"},"seq":{"type":"number","format":"double"},"subagent":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf27Subagent"},"toolCallId":{"type":"string"},"type":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf27Type"}},"required":["delta","executionId","seq","toolCallId","type"],"title":"ExecutionStreamEvent27"},"ExecutionStreamEventOneOf28Subagent":{"type":"object","properties":{"agentName":{"type":"string"},"parentToolCallId":{"type":"string"},"toolName":{"type":"string"}},"required":["toolName"],"title":"ExecutionStreamEventOneOf28Subagent"},"ExecutionStreamEventOneOf28Type":{"type":"string","enum":["tool_input_complete"],"title":"ExecutionStreamEventOneOf28Type"},"ExecutionStreamEvent28":{"type":"object","properties":{"executionId":{"type":"string"},"hiddenParameterNames":{"type":"array","items":{"type":"string"}},"parameters":{"type":"object","additionalProperties":{"description":"Any type"}},"seq":{"type":"number","format":"double"},"subagent":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf28Subagent"},"toolCallId":{"type":"string"},"toolName":{"type":"string"},"type":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf28Type"}},"required":["executionId","parameters","seq","toolCallId","type"],"title":"ExecutionStreamEvent28"},"ExecutionStreamEventOneOf29Type":{"type":"string","enum":["tool_output_delta"],"title":"ExecutionStreamEventOneOf29Type"},"ExecutionStreamEvent29":{"type":"object","properties":{"delta":{"type":"string"},"executionId":{"type":"string"},"seq":{"type":"number","format":"double"},"toolCallId":{"type":"string"},"type":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf29Type"}},"required":["delta","executionId","seq","toolCallId","type"],"title":"ExecutionStreamEvent29"},"ExecutionStreamEventOneOf30Subagent":{"type":"object","properties":{"agentName":{"type":"string"},"parentToolCallId":{"type":"string"},"toolName":{"type":"string"}},"required":["toolName"],"title":"ExecutionStreamEventOneOf30Subagent"},"ExecutionStreamEventOneOf30Type":{"type":"string","enum":["tool_complete"],"title":"ExecutionStreamEventOneOf30Type"},"ExecutionStreamEvent30":{"type":"object","properties":{"completedAt":{"type":"string"},"error":{"type":"string"},"executionId":{"type":"string"},"executionTime":{"type":"number","format":"double"},"iteration":{"type":"number","format":"double"},"result":{"description":"Any type"},"seq":{"type":"number","format":"double"},"stepId":{"type":"string"},"subagent":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf30Subagent"},"success":{"type":"boolean"},"toolCallId":{"type":"string"},"toolCost":{"type":"number","format":"double"},"toolName":{"type":"string"},"type":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf30Type"}},"required":["executionId","seq","success","toolCallId","type"],"title":"ExecutionStreamEvent30"},"ExecutionStreamEventOneOf31ExternalAgent":{"type":"object","properties":{"contextId":{"type":"string"},"taskId":{"type":"string"}},"title":"ExecutionStreamEventOneOf31ExternalAgent"},"ExecutionStreamEventOneOf31Subagent":{"type":"object","properties":{"agentName":{"type":"string"},"parentToolCallId":{"type":"string"},"toolName":{"type":"string"}},"required":["toolName"],"title":"ExecutionStreamEventOneOf31Subagent"},"ExecutionStreamEventOneOf31Type":{"type":"string","enum":["approval_start"],"title":"ExecutionStreamEventOneOf31Type"},"ExecutionStreamEvent31":{"type":"object","properties":{"approvalId":{"type":"string"},"description":{"type":"string"},"executionId":{"type":"string"},"externalAgent":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf31ExternalAgent"},"iteration":{"type":"number","format":"double"},"parameters":{"type":"object","additionalProperties":{"description":"Any type"}},"reason":{"type":"string"},"seq":{"type":"number","format":"double"},"startedAt":{"type":"string"},"subagent":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf31Subagent"},"timeout":{"type":"number","format":"double"},"toolCallId":{"type":"string"},"toolName":{"type":"string"},"toolType":{"type":"string"},"type":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf31Type"}},"required":["approvalId","executionId","seq","toolName","type"],"title":"ExecutionStreamEvent31"},"ExecutionStreamEventOneOf32Decision":{"type":"string","enum":["approved","denied","timeout"],"title":"ExecutionStreamEventOneOf32Decision"},"ExecutionStreamEventOneOf32ResolvedBy":{"type":"string","enum":["user","system"],"title":"ExecutionStreamEventOneOf32ResolvedBy"},"ExecutionStreamEventOneOf32Type":{"type":"string","enum":["approval_complete"],"title":"ExecutionStreamEventOneOf32Type"},"ExecutionStreamEvent32":{"type":"object","properties":{"approvalId":{"type":"string"},"completedAt":{"type":"string"},"decision":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf32Decision"},"executionId":{"type":"string"},"resolvedBy":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf32ResolvedBy"},"seq":{"type":"number","format":"double"},"type":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf32Type"}},"required":["approvalId","decision","executionId","seq","type"],"title":"ExecutionStreamEvent32"},"ExecutionStreamEventOneOf33Annotations":{"type":"object","properties":{"consequentialHint":{"type":"boolean"},"debugging":{"type":"boolean"},"destructiveHint":{"type":"boolean"},"idempotentHint":{"type":"boolean"},"openWorldHint":{"type":"boolean"},"readOnlyHint":{"type":"boolean"},"untrustedContentHint":{"type":"boolean"}},"title":"ExecutionStreamEventOneOf33Annotations"},"ExecutionStreamEventOneOf33ElicitationMode":{"type":"string","enum":["form","url"],"title":"ExecutionStreamEventOneOf33ElicitationMode"},"ExecutionStreamEventOneOf33ElicitationRequestsItemsMode":{"type":"string","enum":["form","url"],"title":"ExecutionStreamEventOneOf33ElicitationRequestsItemsMode"},"ExecutionStreamEventOneOf33ElicitationRequestsItems":{"type":"object","properties":{"message":{"type":"string"},"mode":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf33ElicitationRequestsItemsMode"},"name":{"type":"string"},"requestedSchema":{"type":"object","additionalProperties":{"description":"Any type"}},"url":{"type":"string"}},"required":["message","mode","name"],"title":"ExecutionStreamEventOneOf33ElicitationRequestsItems"},"ExecutionStreamEventOneOf33Elicitation":{"type":"object","properties":{"message":{"type":"string"},"mode":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf33ElicitationMode"},"pauseCount":{"type":"number","format":"double"},"requestedSchema":{"type":"object","additionalProperties":{"description":"Any type"}},"requests":{"type":"array","items":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf33ElicitationRequestsItems"}},"serverName":{"type":"string"},"url":{"type":"string"}},"required":["message","mode"],"title":"ExecutionStreamEventOneOf33Elicitation"},"ExecutionStreamEventOneOf33ExternalAgent":{"type":"object","properties":{"contextId":{"type":"string"},"taskId":{"type":"string"}},"title":"ExecutionStreamEventOneOf33ExternalAgent"},"ExecutionStreamEventOneOf33Origin":{"type":"string","enum":["webmcp","sdk"],"title":"ExecutionStreamEventOneOf33Origin"},"ExecutionStreamEventOneOf33Subagent":{"type":"object","properties":{"agentName":{"type":"string"},"parentToolCallId":{"type":"string"},"toolName":{"type":"string"}},"required":["toolName"],"title":"ExecutionStreamEventOneOf33Subagent"},"ExecutionStreamEventOneOf33Type":{"type":"string","enum":["await"],"title":"ExecutionStreamEventOneOf33Type"},"ExecutionStreamEvent33":{"type":"object","properties":{"annotations":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf33Annotations"},"awaitReason":{"type":"string"},"awaitedAt":{"type":"string"},"crawlId":{"type":"string"},"elicitation":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf33Elicitation"},"executionId":{"type":"string"},"externalAgent":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf33ExternalAgent"},"origin":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf33Origin"},"pageOrigin":{"type":"string"},"parameters":{"type":"object","additionalProperties":{"description":"Any type"}},"seq":{"type":"number","format":"double"},"stepId":{"type":"string"},"subagent":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf33Subagent"},"toolCallId":{"type":"string"},"toolId":{"type":"string"},"toolName":{"type":"string"},"type":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf33Type"}},"required":["executionId","seq","type"],"title":"ExecutionStreamEvent33"},"ExecutionStreamEventOneOf34Error1":{"type":"object","properties":{"code":{"type":"string"},"details":{"type":"object","additionalProperties":{"description":"Any type"}},"message":{"type":"string"}},"required":["code","message"],"title":"ExecutionStreamEventOneOf34Error1"},"ExecutionStreamEventOneOf34Error":{"oneOf":[{"type":"string"},{"$ref":"#/components/schemas/ExecutionStreamEventOneOf34Error1"}],"title":"ExecutionStreamEventOneOf34Error"},"ExecutionStreamEventOneOf34Type":{"type":"string","enum":["error"],"title":"ExecutionStreamEventOneOf34Type"},"ExecutionStreamEvent34":{"type":"object","properties":{"error":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf34Error"},"executionId":{"type":"string"},"recoverable":{"type":"boolean"},"seq":{"type":"number","format":"double"},"type":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf34Type"}},"required":["error","executionId","seq","type"],"title":"ExecutionStreamEvent34"},"ExecutionStreamEventOneOf35Kind":{"type":"string","enum":["compaction"],"title":"ExecutionStreamEventOneOf35Kind"},"ExecutionStreamEventOneOf35Outcome":{"type":"string","enum":["ok","failed","gap","skipped"],"title":"ExecutionStreamEventOneOf35Outcome"},"ExecutionStreamEventOneOf35Phase":{"type":"string","enum":["start","complete"],"title":"ExecutionStreamEventOneOf35Phase"},"ExecutionStreamEventOneOf35Reason":{"type":"string","enum":["threshold","overflow","manual","surface_policy","provider_mismatch"],"title":"ExecutionStreamEventOneOf35Reason"},"ExecutionStreamEventOneOf35Strategy":{"type":"string","enum":["provider_native","summary"],"title":"ExecutionStreamEventOneOf35Strategy"},"ExecutionStreamEventOneOf35Type":{"type":"string","enum":["context_notice"],"title":"ExecutionStreamEventOneOf35Type"},"ExecutionStreamEvent35":{"type":"object","properties":{"epoch":{"type":"integer","minimum":0},"executionId":{"type":"string"},"kind":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf35Kind"},"outcome":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf35Outcome"},"phase":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf35Phase"},"reason":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf35Reason"},"seq":{"type":"number","format":"double"},"strategy":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf35Strategy"},"tier":{"type":"integer","minimum":0},"tokensAfter":{"type":"number","format":"double"},"tokensBefore":{"type":"number","format":"double"},"type":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf35Type"}},"required":["epoch","executionId","kind","phase","reason","seq","strategy","tier","type"],"title":"ExecutionStreamEvent35"},"ExecutionStreamEventOneOf36Type":{"type":"string","enum":["ping"],"title":"ExecutionStreamEventOneOf36Type"},"ExecutionStreamEvent36":{"type":"object","properties":{"executionId":{"type":"string"},"seq":{"type":"number","format":"double"},"timestamp":{"type":"string"},"type":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf36Type"}},"required":["executionId","seq","timestamp","type"],"title":"ExecutionStreamEvent36"},"ExecutionStreamEventOneOf37Type":{"type":"string","enum":["custom"],"title":"ExecutionStreamEventOneOf37Type"},"ExecutionStreamEvent37":{"type":"object","properties":{"executionId":{"type":"string"},"name":{"type":"string"},"seq":{"type":"number","format":"double"},"type":{"$ref":"#/components/schemas/ExecutionStreamEventOneOf37Type"},"value":{"description":"Any type"}},"required":["name","type"],"title":"ExecutionStreamEvent37"},"ExecutionStreamEvent":{"oneOf":[{"$ref":"#/components/schemas/ExecutionStreamEvent0"},{"$ref":"#/components/schemas/ExecutionStreamEvent1"},{"$ref":"#/components/schemas/ExecutionStreamEvent2"},{"$ref":"#/components/schemas/ExecutionStreamEvent3"},{"$ref":"#/components/schemas/ExecutionStreamEvent4"},{"$ref":"#/components/schemas/ExecutionStreamEvent5"},{"$ref":"#/components/schemas/ExecutionStreamEvent6"},{"$ref":"#/components/schemas/ExecutionStreamEvent7"},{"$ref":"#/components/schemas/ExecutionStreamEvent8"},{"$ref":"#/components/schemas/ExecutionStreamEvent9"},{"$ref":"#/components/schemas/ExecutionStreamEvent10"},{"$ref":"#/components/schemas/ExecutionStreamEvent11"},{"$ref":"#/components/schemas/ExecutionStreamEvent12"},{"$ref":"#/components/schemas/ExecutionStreamEvent13"},{"$ref":"#/components/schemas/ExecutionStreamEvent14"},{"$ref":"#/components/schemas/ExecutionStreamEvent15"},{"$ref":"#/components/schemas/ExecutionStreamEvent16"},{"$ref":"#/components/schemas/ExecutionStreamEvent17"},{"$ref":"#/components/schemas/ExecutionStreamEvent18"},{"$ref":"#/components/schemas/ExecutionStreamEvent19"},{"$ref":"#/components/schemas/ExecutionStreamEvent20"},{"$ref":"#/components/schemas/ExecutionStreamEvent21"},{"$ref":"#/components/schemas/ExecutionStreamEvent22"},{"$ref":"#/components/schemas/ExecutionStreamEvent23"},{"$ref":"#/components/schemas/ExecutionStreamEvent24"},{"$ref":"#/components/schemas/ExecutionStreamEvent25"},{"$ref":"#/components/schemas/ExecutionStreamEvent26"},{"$ref":"#/components/schemas/ExecutionStreamEvent27"},{"$ref":"#/components/schemas/ExecutionStreamEvent28"},{"$ref":"#/components/schemas/ExecutionStreamEvent29"},{"$ref":"#/components/schemas/ExecutionStreamEvent30"},{"$ref":"#/components/schemas/ExecutionStreamEvent31"},{"$ref":"#/components/schemas/ExecutionStreamEvent32"},{"$ref":"#/components/schemas/ExecutionStreamEvent33"},{"$ref":"#/components/schemas/ExecutionStreamEvent34"},{"$ref":"#/components/schemas/ExecutionStreamEvent35"},{"$ref":"#/components/schemas/ExecutionStreamEvent36"},{"$ref":"#/components/schemas/ExecutionStreamEvent37"}],"title":"ExecutionStreamEvent"},"AgentApprovalContinuationJsonResponseDecision":{"type":"string","enum":["approved","denied"],"title":"AgentApprovalContinuationJsonResponseDecision"},"DispatchPausedReasonOneOf0Type":{"type":"string","enum":["local_action"],"title":"DispatchPausedReasonOneOf0Type"},"DispatchPausedReason0":{"type":"object","properties":{"approvalId":{"type":"string"},"awaitReason":{"type":"string"},"elicitation":{"type":"object","additionalProperties":{"description":"Any type"}},"executionId":{"type":"string"},"parameters":{"type":"object","additionalProperties":{"description":"Any type"}},"toolId":{"type":"string"},"toolName":{"type":"string"},"type":{"$ref":"#/components/schemas/DispatchPausedReasonOneOf0Type"}},"required":["executionId","parameters","toolId","toolName","type"],"title":"DispatchPausedReason0"},"DispatchPausedReasonOneOf1Type":{"type":"string","enum":["crawl_pending"],"title":"DispatchPausedReasonOneOf1Type"},"DispatchPausedReason1":{"type":"object","properties":{"crawlId":{"type":"string"},"stepId":{"type":"string"},"type":{"$ref":"#/components/schemas/DispatchPausedReasonOneOf1Type"}},"required":["type"],"title":"DispatchPausedReason1"},"DispatchPausedReasonOneOf2Type":{"type":"string","enum":["durable_poll"],"title":"DispatchPausedReasonOneOf2Type"},"DispatchPausedReason2":{"type":"object","properties":{"stepId":{"type":"string"},"type":{"$ref":"#/components/schemas/DispatchPausedReasonOneOf2Type"}},"required":["type"],"title":"DispatchPausedReason2"},"DispatchPausedReason":{"oneOf":[{"$ref":"#/components/schemas/DispatchPausedReason0"},{"$ref":"#/components/schemas/DispatchPausedReason1"},{"$ref":"#/components/schemas/DispatchPausedReason2"}],"title":"DispatchPausedReason"},"AgentApprovalContinuationJsonResponseStatus":{"type":"string","enum":["completed","paused","failed"],"title":"AgentApprovalContinuationJsonResponseStatus"},"AgentApprovalContinuationJsonResponseStopReason":{"type":"string","enum":["end_turn","paused","error"],"title":"AgentApprovalContinuationJsonResponseStopReason"},"AgentApprovalContinuationJsonResponse":{"type":"object","properties":{"blockReason":{"type":"string"},"code":{"type":"string"},"decision":{"$ref":"#/components/schemas/AgentApprovalContinuationJsonResponseDecision"},"error":{"type":"string"},"executionId":{"type":"string"},"iterations":{"type":"integer","minimum":0},"pausedReason":{"$ref":"#/components/schemas/DispatchPausedReason"},"result":{"type":"string"},"status":{"$ref":"#/components/schemas/AgentApprovalContinuationJsonResponseStatus"},"stopReason":{"$ref":"#/components/schemas/AgentApprovalContinuationJsonResponseStopReason"},"success":{"type":"boolean"},"totalCost":{"type":"number","format":"double"},"upgradeUrl":{"type":"string"}},"required":["decision","executionId","iterations","result","status","stopReason","success","totalCost"],"title":"AgentApprovalContinuationJsonResponse"},"Agents_addCapabilityToAgent_Response_201":{"type":"object","properties":{"agentId":{"type":"string"},"createdAt":{"type":"string"},"displayOrder":{"type":["integer","null"]},"enabled":{"type":"boolean"},"flowId":{"type":["string","null"]},"id":{"type":"string"},"parametersSchema":{"description":"Any type"},"subAgentId":{"type":["string","null"]},"toolDescription":{"type":["string","null"]},"toolId":{"type":["string","null"]},"toolName":{"type":"string"}},"required":["displayOrder","enabled","flowId","id","subAgentId","toolDescription","toolId","toolName"],"title":"Agents_addCapabilityToAgent_Response_201"},"Agents_removeCapabilityFromAgent_Response_200":{"type":"object","properties":{"success":{"type":"boolean"}},"required":["success"],"title":"Agents_removeCapabilityFromAgent_Response_200"},"V1AgentsIdConversationsConversationIdEventsGetResponsesContentApplicationJsonSchemaDataItemsNotificationMode":{"type":"string","enum":["narrate","react"],"title":"V1AgentsIdConversationsConversationIdEventsGetResponsesContentApplicationJsonSchemaDataItemsNotificationMode"},"V1AgentsIdConversationsConversationIdEventsGetResponsesContentApplicationJsonSchemaDataItems":{"type":"object","properties":{"consumedAt":{"type":["string","null"]},"createdAt":{"type":"string"},"eventKind":{"type":"string"},"eventRevision":{"type":"integer"},"id":{"type":"string"},"notificationMode":{"$ref":"#/components/schemas/V1AgentsIdConversationsConversationIdEventsGetResponsesContentApplicationJsonSchemaDataItemsNotificationMode"},"payload":{"type":"object","additionalProperties":{"description":"Any type"}},"runId":{"type":"string"}},"required":["consumedAt","createdAt","eventKind","eventRevision","id","notificationMode","payload","runId"],"title":"V1AgentsIdConversationsConversationIdEventsGetResponsesContentApplicationJsonSchemaDataItems"},"Agents_listInternalAgentConversationEvents_Response_200":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1AgentsIdConversationsConversationIdEventsGetResponsesContentApplicationJsonSchemaDataItems"}}},"required":["data"],"title":"Agents_listInternalAgentConversationEvents_Response_200"},"AgentCredentialKind":{"type":"string","enum":["public_key","client_secret"],"title":"AgentCredentialKind"},"AgentCredentialStatus":{"type":"string","enum":["active","expired","revoked"],"title":"AgentCredentialStatus"},"AgentCredential":{"type":"object","properties":{"agentId":{"type":"string"},"algorithm":{"type":["string","null"],"description":"The pinned signing algorithm of a public key."},"createdAt":{"type":"string"},"createdByUserId":{"type":["string","null"],"description":"Who registered it; provenance only."},"expiresAt":{"type":["string","null"]},"id":{"type":"string"},"kid":{"type":"string","description":"Key ID; for a client secret, a generated identifier."},"kind":{"$ref":"#/components/schemas/AgentCredentialKind"},"publicJwk":{"type":["object","null"],"additionalProperties":{"description":"Any type"},"description":"The registered public JWK."},"revokedAt":{"type":["string","null"]},"secretHint":{"type":["string","null"],"description":"The last four characters of a client secret."},"status":{"$ref":"#/components/schemas/AgentCredentialStatus"}},"required":["agentId","algorithm","createdAt","createdByUserId","expiresAt","id","kid","kind","publicJwk","revokedAt","secretHint","status"],"title":"AgentCredential"},"AgentCredentialList":{"type":"object","properties":{"clientId":{"type":"string","description":"The OAuth client ID of the agent: its agent ID."},"credentials":{"type":"array","items":{"$ref":"#/components/schemas/AgentCredential"}}},"required":["clientId","credentials"],"title":"AgentCredentialList"},"RegisterAgentPublicKeyRequestAlgorithm":{"type":"string","enum":["ES256","ES384","PS256","PS384","PS512","RS256","RS384","RS512","EdDSA"],"description":"The algorithm client assertions are signed with; defaults to the JWK `alg`.","title":"RegisterAgentPublicKeyRequestAlgorithm"},"RegisterAgentPublicKeyRequest":{"type":"object","properties":{"algorithm":{"$ref":"#/components/schemas/RegisterAgentPublicKeyRequestAlgorithm","description":"The algorithm client assertions are signed with; defaults to the JWK `alg`."},"expiresAt":{"type":"string","format":"date-time","description":"When the key stops being accepted."},"jwk":{"type":"object","additionalProperties":{"description":"Any type"},"description":"A public JWK (EC P-256/P-384, RSA of at least 2048 bits, or OKP Ed25519) with no private members."}},"required":["jwk"],"title":"RegisterAgentPublicKeyRequest"},"CreateAgentClientSecretRequest":{"type":"object","properties":{"lifetimeDays":{"type":"integer","minimum":1,"maximum":365,"description":"Days until the secret expires; defaults to 90, at most 365."}},"title":"CreateAgentClientSecretRequest"},"AgentClientSecretCreated":{"type":"object","properties":{"clientId":{"type":"string"},"clientSecret":{"type":"string","description":"The `rt_agent_sk_` secret. Shown only in this response; Runtype stores only its hash."},"credential":{"$ref":"#/components/schemas/AgentCredential"}},"required":["clientId","clientSecret","credential"],"title":"AgentClientSecretCreated"},"V1AgentsIdExecutePostParametersXRuntypeConcurrency":{"type":"string","enum":["reject","supersede","queue","steer","auto"],"description":"How a durable turn handles overlap. `reject` (default) answers CONVERSATION_BUSY naming the occupant execution, its phase, and a Retry-After; `supersede` cancels and replaces; `queue` runs afterward; `steer` durably appends new user-message deltas to the same execution at a safe boundary, attaches through the host's slot claim when the host has not started yet, or starts the next execution if completion wins. Steer requires a conversationId, preserves configuration and authority, cannot combine with coalesce, and rejects unsupported lanes. `auto` sends the same user-message deltas as steer and lets a classifier choose: while a turn runs, a message that belongs to it steers and an independent one queues as the next turn; with nothing running it is an ordinary turn with no route report. A routed or downgraded answer reports the route in `X-Runtype-Busy-Message-Route` / `-Source` (plus `-Probability` and `-Model` when the classifier answered) and, on JSON bodies, `busyMessageRoute`. Where auto cannot route (in-process execution, stored history, no conversationId, coalesce, Prefer: respond-async) it keeps the default admission and reports source `disabled`. Other policies remain ignored on in-process execution.","title":"V1AgentsIdExecutePostParametersXRuntypeConcurrency"},"V1AgentsIdExecutePostParametersXRuntypeCoalesce":{"type":"string","enum":["true"],"description":"Send `true` to fold this request into an already-pending turn for the same conversation instead of starting a second one. The response is the pending execution. Any other value (or omitting the header) starts a new turn.","title":"V1AgentsIdExecutePostParametersXRuntypeCoalesce"},"IdentityAssertionUnavailableErrorCode":{"type":"string","enum":["IDENTITY_ASSERTION_UNAVAILABLE"],"description":"Stable error code. `insufficient_scope` marks an API key that lacks a scope this request needs.","title":"IdentityAssertionUnavailableErrorCode"},"IdentityAssertionUnavailableErrorDetailsItems":{"type":"object","properties":{"code":{"type":"string","description":"Stable Runtype validation code (e.g. MISSING_REQUIRED_FIELD, INVALID_ENUM)."},"message":{"type":"string"},"path":{"type":"string","description":"Dotted JSON path to the offending field."},"suggestion":{"type":"string","description":"Actionable hint (allowed values, accepted range, …)."}},"required":["message"],"title":"IdentityAssertionUnavailableErrorDetailsItems"},"IdentityAssertionUnavailableError":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/IdentityAssertionUnavailableErrorCode","description":"Stable error code. `insufficient_scope` marks an API key that lacks a scope this request needs."},"details":{"type":"array","items":{"$ref":"#/components/schemas/IdentityAssertionUnavailableErrorDetailsItems"}},"error":{"type":"string"},"requiredScopes":{"type":"array","items":{"type":"string"},"description":"On `insufficient_scope`: every API key scope this request needs."},"message":{"type":"string","description":"What to change: pass endUser or tenant, set a tenancyStrategy, or use an org."}},"required":["code","error","message"],"title":"IdentityAssertionUnavailableError"},"ExecuteAgentRequestBadRequestError":{"oneOf":[{"$ref":"#/components/schemas/Error"},{"$ref":"#/components/schemas/IdentityAssertionUnavailableError"}],"title":"ExecuteAgentRequestBadRequestError"},"V1AgentsIdExecutePostResponsesContentApplicationJsonSchemaOneOf0Code":{"type":"string","enum":["ORGANIZATION_MODEL_CONFIG_NEEDS_CONFIGURATION"],"title":"V1AgentsIdExecutePostResponsesContentApplicationJsonSchemaOneOf0Code"},"ExecuteAgentRequestConflictError0":{"type":"object","properties":{"candidateCount":{"type":"integer","exclusiveMinimum":0},"code":{"$ref":"#/components/schemas/V1AgentsIdExecutePostResponsesContentApplicationJsonSchemaOneOf0Code"},"configId":{"type":"string"},"details":{"type":"string"},"error":{"type":"string"},"modelId":{"type":"string"},"provider":{"type":"string"}},"required":["candidateCount","code","configId","details","error","modelId","provider"],"title":"ExecuteAgentRequestConflictError0"},"ConversationBusyErrorCode":{"type":"string","enum":["CONVERSATION_BUSY"],"title":"ConversationBusyErrorCode"},"ConversationBusyErrorPhase":{"type":"string","enum":["claiming","running","paused","queued"],"description":"Where the occupant is: `claiming` (admitted, not yet started; a steer attaches through the claim), `running`, `paused` (a steer stays pending until an authorized resume), or `queued` (an earlier queue-only turn is waiting).","title":"ConversationBusyErrorPhase"},"ConversationBusyError":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/ConversationBusyErrorCode"},"error":{"type":"string"},"executionId":{"type":"string","description":"The execution holding the conversation slot. Poll /v1/executions/{executionId}/status, or send x-runtype-concurrency: steer to attach to it."},"phase":{"$ref":"#/components/schemas/ConversationBusyErrorPhase","description":"Where the occupant is: `claiming` (admitted, not yet started; a steer attaches through the claim), `running`, `paused` (a steer stays pending until an authorized resume), or `queued` (an earlier queue-only turn is waiting)."}},"required":["code","error"],"title":"ConversationBusyError"},"ConversationModifiedErrorCode":{"type":"string","enum":["CONVERSATION_MODIFIED"],"description":"The stored transcript changed between the read and the write; re-read and retry.","title":"ConversationModifiedErrorCode"},"ConversationModifiedErrorDetailsItems":{"type":"object","properties":{"code":{"type":"string","description":"Stable Runtype validation code (e.g. MISSING_REQUIRED_FIELD, INVALID_ENUM)."},"message":{"type":"string"},"path":{"type":"string","description":"Dotted JSON path to the offending field."},"suggestion":{"type":"string","description":"Actionable hint (allowed values, accepted range, …)."}},"required":["message"],"title":"ConversationModifiedErrorDetailsItems"},"ConversationModifiedError":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/ConversationModifiedErrorCode","description":"The stored transcript changed between the read and the write; re-read and retry."},"details":{"type":"array","items":{"$ref":"#/components/schemas/ConversationModifiedErrorDetailsItems"}},"error":{"type":"string"},"requiredScopes":{"type":"array","items":{"type":"string"},"description":"On `insufficient_scope`: every API key scope this request needs."}},"required":["code","error"],"title":"ConversationModifiedError"},"ExecuteAgentRequestConflictError":{"oneOf":[{"$ref":"#/components/schemas/ExecuteAgentRequestConflictError0"},{"$ref":"#/components/schemas/ConversationBusyError"},{"$ref":"#/components/schemas/ConversationModifiedError"}],"title":"ExecuteAgentRequestConflictError"},"ExecutionFailedErrorDetailsItems":{"type":"object","properties":{"code":{"type":"string","description":"Stable Runtype validation code (e.g. MISSING_REQUIRED_FIELD, INVALID_ENUM)."},"message":{"type":"string"},"path":{"type":"string","description":"Dotted JSON path to the offending field."},"suggestion":{"type":"string","description":"Actionable hint (allowed values, accepted range, …)."}},"required":["message"],"title":"ExecutionFailedErrorDetailsItems"},"ExecutionFailedError":{"type":"object","properties":{"code":{"type":"string","description":"Stable error code. `insufficient_scope` marks an API key that lacks a scope this request needs."},"details":{"type":"array","items":{"$ref":"#/components/schemas/ExecutionFailedErrorDetailsItems"}},"error":{"type":"string"},"requiredScopes":{"type":"array","items":{"type":"string"},"description":"On `insufficient_scope`: every API key scope this request needs."},"claudeManagedAgentId":{"type":"string","description":"Present only for ephemeral inline-create dispatch."},"partialText":{"type":"string","description":"Text the agent produced before its stream was interrupted and could not be restored."}},"required":["error"],"title":"ExecutionFailedError"},"V1AgentsIdExecutionsGetParametersStatus":{"type":"string","enum":["queued","running","paused","completed","failed","cancelled","interrupted"],"title":"V1AgentsIdExecutionsGetParametersStatus"},"V1AgentsIdExecutionsGetParametersAgentSource":{"type":"string","enum":["saved","inline","dynamic","external"],"description":"Only runs recorded with this agent source; `external` selects runs ingested from outside Runtype (OTLP / compatibility ingest).","title":"V1AgentsIdExecutionsGetParametersAgentSource"},"V1AgentsIdExecutionsGetParametersView":{"type":"string","enum":["full","compact"],"description":"Response representation. `full` (default) preserves complete values and includes each row's `finalOutput`; `compact` omits `finalOutput` and shortens every remaining string value longer than 100 characters to a 100-character preview followed by `…`.","title":"V1AgentsIdExecutionsGetParametersView"},"V1AgentsIdExecutionsGetResponsesContentApplicationJsonSchemaDataItemsAgentTargetResolution":{"type":"string","enum":["alias","version","legacy-live-row"],"description":"How the run selected its definition: `alias` or `version` for a request that named a selector, `legacy-live-row` for a run that read the mutable agent row.","title":"V1AgentsIdExecutionsGetResponsesContentApplicationJsonSchemaDataItemsAgentTargetResolution"},"V1AgentsIdExecutionsGetResponsesContentApplicationJsonSchemaDataItemsAgentVersion":{"type":"object","properties":{"id":{"type":"string"},"label":{"type":["string","null"]},"versionNumber":{"type":"integer"}},"required":["id","label","versionNumber"],"description":"Version number and label for `agentVersionId`, joined from `agent_versions`. `null` exactly when `agentVersionId` is `null`.","title":"V1AgentsIdExecutionsGetResponsesContentApplicationJsonSchemaDataItemsAgentVersion"},"V1AgentsIdExecutionsGetResponsesContentApplicationJsonSchemaDataItemsExecutionMode":{"type":"string","enum":["attached","detached"],"title":"V1AgentsIdExecutionsGetResponsesContentApplicationJsonSchemaDataItemsExecutionMode"},"V1AgentsIdExecutionsGetResponsesContentApplicationJsonSchemaDataItemsNotificationMode":{"type":"string","enum":["none","narrate","react"],"title":"V1AgentsIdExecutionsGetResponsesContentApplicationJsonSchemaDataItemsNotificationMode"},"V1AgentsIdExecutionsGetResponsesContentApplicationJsonSchemaDataItemsOtelProducer":{"type":"object","properties":{"adapterName":{"type":"string"},"adapterVersion":{"type":"string"},"normalizers":{"type":"array","items":{"type":"string"}}},"description":"What instrumentation produced an ingested run, as the OTLP ingest resolved it: the adapter a producer named itself as (`runtype.adapter.name`) and every normalizer that claimed the trace. An empty `normalizers` array states that nothing claimed it, which is what a producer already speaking canonical GenAI semantic conventions looks like. `null` means the producer was never recorded (a hosted run, or a run ingested before this was persisted) and must not be read as \"identified as nothing\".","title":"V1AgentsIdExecutionsGetResponsesContentApplicationJsonSchemaDataItemsOtelProducer"},"V1AgentsIdExecutionsGetResponsesContentApplicationJsonSchemaDataItemsPendingApproval":{"type":"object","properties":{"approvalId":{"type":"string"},"description":{"type":"string"},"parameters":{"description":"Any type"},"reason":{"type":"string"},"requestedAt":{"type":"string"},"timeout":{"type":"number","format":"double"},"toolCallId":{"type":"string"},"toolName":{"type":"string"},"toolType":{"type":"string"}},"required":["approvalId","requestedAt","toolCallId","toolName","toolType"],"title":"V1AgentsIdExecutionsGetResponsesContentApplicationJsonSchemaDataItemsPendingApproval"},"V1AgentsIdExecutionsGetResponsesContentApplicationJsonSchemaDataItemsSignalsStatus":{"type":"string","enum":["complete","pending","partial","none","unavailable"],"title":"V1AgentsIdExecutionsGetResponsesContentApplicationJsonSchemaDataItemsSignalsStatus"},"V1AgentsIdExecutionsGetResponsesContentApplicationJsonSchemaDataItemsSignals":{"type":"object","properties":{"fired":{"type":"array","items":{"type":"string"}},"status":{"$ref":"#/components/schemas/V1AgentsIdExecutionsGetResponsesContentApplicationJsonSchemaDataItemsSignalsStatus"}},"required":["fired","status"],"description":"Trace signal status and fired keys. Omitted until the organization binds a signal set.","title":"V1AgentsIdExecutionsGetResponsesContentApplicationJsonSchemaDataItemsSignals"},"V1AgentsIdExecutionsGetResponsesContentApplicationJsonSchemaDataItemsStatus":{"type":"string","enum":["queued","running","paused","completed","failed","cancelled","interrupted"],"title":"V1AgentsIdExecutionsGetResponsesContentApplicationJsonSchemaDataItemsStatus"},"V1AgentsIdExecutionsGetResponsesContentApplicationJsonSchemaDataItems":{"type":"object","properties":{"agentId":{"type":["string","null"]},"agentSource":{"type":["string","null"]},"agentSpec":{"description":"Any type"},"agentTargetResolution":{"$ref":"#/components/schemas/V1AgentsIdExecutionsGetResponsesContentApplicationJsonSchemaDataItemsAgentTargetResolution","description":"How the run selected its definition: `alias` or `version` for a request that named a selector, `legacy-live-row` for a run that read the mutable agent row."},"agentVersion":{"oneOf":[{"$ref":"#/components/schemas/V1AgentsIdExecutionsGetResponsesContentApplicationJsonSchemaDataItemsAgentVersion"},{"type":"null"}],"description":"Version number and label for `agentVersionId`, joined from `agent_versions`. `null` exactly when `agentVersionId` is `null`."},"agentVersionId":{"type":["string","null"],"description":"The `agent_versions` row this run was recorded against, or `null`. `null` means the surface that admitted the run stamps no version (A2A, Product API, A2A pause admission and the Product MCP capability path record none today) or the run predates version stamping. It is never a claim that the run executed an unversioned configuration."},"budgetExhausted":{"type":["boolean","null"],"description":"Whether the agent loop ended by exhausting its `maxTurns` budget. Read this rather than inferring truncation from `stopReason`: a single-turn loop publishes `end_turn` on a budget end to preserve its original payload shape, and several clean success paths publish that same value. `null` means UNKNOWN — a run recorded before this field existed, or one executed by a lane that reports no per-iteration breakdown (external agents, Claude Managed) — and must not be read as `false`."},"cancelRequestedAt":{"type":["string","null"]},"completedAt":{"type":["string","null"]},"conversationId":{"type":["string","null"],"description":"The conversation thread this run belongs to, so consumers can group a multi-turn conversation's runs without a per-run log query. This is the run's OWN thread, distinct from `parentConversationId` (subagent lineage, the conversation of the run that spawned it). `null` on stateless surfaces (webhook, schedule, eval, one-shot API) and on runs persisted before the column existed."},"createdAt":{"type":"string"},"executionId":{"type":"string"},"executionMode":{"$ref":"#/components/schemas/V1AgentsIdExecutionsGetResponsesContentApplicationJsonSchemaDataItemsExecutionMode"},"expiresAt":{"type":["string","null"]},"finalOutput":{"description":"The run's final output. Present by default; omitted when `view=compact`."},"id":{"type":"string"},"inputMessages":{"description":"Any type"},"iterations":{"type":["integer","null"]},"lastHeartbeatAt":{"type":["string","null"]},"notificationMode":{"$ref":"#/components/schemas/V1AgentsIdExecutionsGetResponsesContentApplicationJsonSchemaDataItemsNotificationMode"},"otelProducer":{"oneOf":[{"$ref":"#/components/schemas/V1AgentsIdExecutionsGetResponsesContentApplicationJsonSchemaDataItemsOtelProducer"},{"type":"null"}],"description":"What instrumentation produced an ingested run, as the OTLP ingest resolved it: the adapter a producer named itself as (`runtype.adapter.name`) and every normalizer that claimed the trace. An empty `normalizers` array states that nothing claimed it, which is what a producer already speaking canonical GenAI semantic conventions looks like. `null` means the producer was never recorded (a hosted run, or a run ingested before this was persisted) and must not be read as \"identified as nothing\"."},"parentAgentId":{"type":["string","null"]},"parentConversationId":{"type":["string","null"]},"parentExecutionId":{"type":["string","null"]},"parentToolCallId":{"type":["string","null"]},"pendingApproval":{"oneOf":[{"$ref":"#/components/schemas/V1AgentsIdExecutionsGetResponsesContentApplicationJsonSchemaDataItemsPendingApproval"},{"type":"null"}]},"progress":{"description":"Any type"},"retryOfExecutionId":{"type":["string","null"]},"rootExecutionId":{"type":["string","null"]},"signals":{"$ref":"#/components/schemas/V1AgentsIdExecutionsGetResponsesContentApplicationJsonSchemaDataItemsSignals","description":"Trace signal status and fired keys. Omitted until the organization binds a signal set."},"startedAt":{"type":["string","null"]},"status":{"$ref":"#/components/schemas/V1AgentsIdExecutionsGetResponsesContentApplicationJsonSchemaDataItemsStatus"},"stopReason":{"type":["string","null"]},"surfaceType":{"type":["string","null"]},"totalCost":{"type":["string","null"]},"totalTokens":{"description":"Any type"}},"required":["agentId","agentSource","agentTargetResolution","agentVersion","agentVersionId","budgetExhausted","cancelRequestedAt","completedAt","conversationId","createdAt","executionId","executionMode","expiresAt","id","iterations","lastHeartbeatAt","notificationMode","otelProducer","parentAgentId","parentConversationId","parentExecutionId","parentToolCallId","pendingApproval","retryOfExecutionId","rootExecutionId","startedAt","status","stopReason","surfaceType","totalCost"],"title":"V1AgentsIdExecutionsGetResponsesContentApplicationJsonSchemaDataItems"},"Agents_listAgentExecutions_Response_200":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1AgentsIdExecutionsGetResponsesContentApplicationJsonSchemaDataItems"}},"pagination":{"$ref":"#/components/schemas/Pagination"}},"required":["data","pagination"],"title":"Agents_listAgentExecutions_Response_200"},"V1AgentsIdExecutionsExecutionIdGetResponsesContentApplicationJsonSchemaAgentTargetResolution":{"type":"string","enum":["alias","version","legacy-live-row"],"description":"How the run selected its definition: `alias` or `version` for a request that named a selector, `legacy-live-row` for a run that read the mutable agent row.","title":"V1AgentsIdExecutionsExecutionIdGetResponsesContentApplicationJsonSchemaAgentTargetResolution"},"V1AgentsIdExecutionsExecutionIdGetResponsesContentApplicationJsonSchemaAgentVersion":{"type":"object","properties":{"id":{"type":"string"},"label":{"type":["string","null"]},"versionNumber":{"type":"integer"}},"required":["id","label","versionNumber"],"description":"Version number and label for `agentVersionId`, joined from `agent_versions`. `null` exactly when `agentVersionId` is `null`.","title":"V1AgentsIdExecutionsExecutionIdGetResponsesContentApplicationJsonSchemaAgentVersion"},"V1AgentsIdExecutionsExecutionIdGetResponsesContentApplicationJsonSchemaExecutionLane":{"type":"string","enum":["durable","in_process"],"description":"Which substrate actually ran this turn. `durable` means a Durable Object owned it: a Runtype session for an attached turn (the only lane that sets the `X-Runtype-Execution-Driver` response header), or the run owner a detached run is handed to. `in_process` means the request worker ran it to completion. Read back from the run's own admission-time record, so it reports what happened rather than what the current routing policy would choose now. `executionMode` cannot answer this on its own: both lanes record `attached` for an attached turn. One routing rule is worth knowing when comparing runs: `POST /v1/dispatch` keeps a request that sets `options.debugMode: true` on `in_process`.","title":"V1AgentsIdExecutionsExecutionIdGetResponsesContentApplicationJsonSchemaExecutionLane"},"V1AgentsIdExecutionsExecutionIdGetResponsesContentApplicationJsonSchemaExecutionMode":{"type":"string","enum":["attached","detached"],"title":"V1AgentsIdExecutionsExecutionIdGetResponsesContentApplicationJsonSchemaExecutionMode"},"ExternalObservedApprovalsAvailability":{"type":"string","enum":["observed"],"title":"ExternalObservedApprovalsAvailability"},"ExternalObservedApprovalsLifecyclesItemsDecision":{"type":"string","enum":["requested","approved","denied","conflicted"],"title":"ExternalObservedApprovalsLifecyclesItemsDecision"},"ExternalObservedApprovalsLifecyclesItemsObservationsItemsSourceAttribute":{"type":"string","enum":["cloudflare.agents.tool.approval.state"],"title":"ExternalObservedApprovalsLifecyclesItemsObservationsItemsSourceAttribute"},"ExternalObservedApprovalsLifecyclesItemsObservationsItemsSourceKind":{"type":"string","enum":["cloudflare-agents"],"title":"ExternalObservedApprovalsLifecyclesItemsObservationsItemsSourceKind"},"ExternalObservedApprovalsLifecyclesItemsObservationsItemsSource":{"type":"object","properties":{"attribute":{"$ref":"#/components/schemas/ExternalObservedApprovalsLifecyclesItemsObservationsItemsSourceAttribute"},"kind":{"$ref":"#/components/schemas/ExternalObservedApprovalsLifecyclesItemsObservationsItemsSourceKind"},"spanId":{"type":"string"},"traceId":{"type":"string"}},"required":["attribute","kind","spanId","traceId"],"title":"ExternalObservedApprovalsLifecyclesItemsObservationsItemsSource"},"ExternalObservedApprovalsLifecyclesItemsObservationsItemsState":{"type":"string","enum":["requested","approved","denied"],"title":"ExternalObservedApprovalsLifecyclesItemsObservationsItemsState"},"ExternalObservedApprovalsLifecyclesItemsObservationsItems":{"type":"object","properties":{"key":{"type":"string"},"observedAt":{"type":"string","format":"date-time"},"source":{"$ref":"#/components/schemas/ExternalObservedApprovalsLifecyclesItemsObservationsItemsSource"},"state":{"$ref":"#/components/schemas/ExternalObservedApprovalsLifecyclesItemsObservationsItemsState"}},"required":["key","source","state"],"title":"ExternalObservedApprovalsLifecyclesItemsObservationsItems"},"ExternalObservedApprovalsLifecyclesItemsRawStatesItems":{"type":"string","enum":["requested","approved","denied"],"title":"ExternalObservedApprovalsLifecyclesItemsRawStatesItems"},"ExternalObservedApprovalsLifecyclesItems":{"type":"object","properties":{"decision":{"$ref":"#/components/schemas/ExternalObservedApprovalsLifecyclesItemsDecision"},"key":{"type":"string"},"observations":{"type":"array","items":{"$ref":"#/components/schemas/ExternalObservedApprovalsLifecyclesItemsObservationsItems"}},"rawStates":{"type":"array","items":{"$ref":"#/components/schemas/ExternalObservedApprovalsLifecyclesItemsRawStatesItems"}},"sourceConflict":{"type":"boolean"},"toolCallId":{"type":"string"},"toolName":{"type":"string"},"toolType":{"type":"string"}},"required":["decision","key","observations","rawStates","toolCallId"],"title":"ExternalObservedApprovalsLifecyclesItems"},"ExternalObservedApprovalsVersion":{"type":"string","enum":["1"],"title":"ExternalObservedApprovalsVersion"},"ExternalObservedApprovals":{"type":"object","properties":{"availability":{"$ref":"#/components/schemas/ExternalObservedApprovalsAvailability"},"lifecycles":{"type":"array","items":{"$ref":"#/components/schemas/ExternalObservedApprovalsLifecyclesItems"}},"truncated":{"type":"boolean"},"version":{"$ref":"#/components/schemas/ExternalObservedApprovalsVersion"}},"required":["availability","lifecycles","version"],"description":"Read-only approval observations within producer traces. Null means history unavailable; an empty lifecycle list means none observed. Structural history survives ingest-fact expiry and is retained when verbose logging is off.","title":"ExternalObservedApprovals"},"V1AgentsIdExecutionsExecutionIdGetResponsesContentApplicationJsonSchemaExternalTelemetryCompleteness":{"type":"string","enum":["partial","complete","conflicted","expired"],"title":"V1AgentsIdExecutionsExecutionIdGetResponsesContentApplicationJsonSchemaExternalTelemetryCompleteness"},"V1AgentsIdExecutionsExecutionIdGetResponsesContentApplicationJsonSchemaExternalTelemetrySource":{"type":"string","enum":["otlp"],"title":"V1AgentsIdExecutionsExecutionIdGetResponsesContentApplicationJsonSchemaExternalTelemetrySource"},"V1AgentsIdExecutionsExecutionIdGetResponsesContentApplicationJsonSchemaExternalTelemetry":{"type":"object","properties":{"completeness":{"$ref":"#/components/schemas/V1AgentsIdExecutionsExecutionIdGetResponsesContentApplicationJsonSchemaExternalTelemetryCompleteness"},"source":{"$ref":"#/components/schemas/V1AgentsIdExecutionsExecutionIdGetResponsesContentApplicationJsonSchemaExternalTelemetrySource"},"terminalRecorded":{"type":"boolean"}},"required":["completeness","source","terminalRecorded"],"description":"Bounded state of the authorized external OTLP trace. Null means no matching trace state is available; it never means complete. This contains no trace facts or captured content.","title":"V1AgentsIdExecutionsExecutionIdGetResponsesContentApplicationJsonSchemaExternalTelemetry"},"V1AgentsIdExecutionsExecutionIdGetResponsesContentApplicationJsonSchemaNotificationMode":{"type":"string","enum":["none","narrate","react"],"title":"V1AgentsIdExecutionsExecutionIdGetResponsesContentApplicationJsonSchemaNotificationMode"},"V1AgentsIdExecutionsExecutionIdGetResponsesContentApplicationJsonSchemaPendingApproval":{"type":"object","properties":{"approvalId":{"type":"string"},"description":{"type":"string"},"parameters":{"description":"Any type"},"reason":{"type":"string"},"requestedAt":{"type":"string"},"timeout":{"type":"number","format":"double"},"toolCallId":{"type":"string"},"toolName":{"type":"string"},"toolType":{"type":"string"}},"required":["approvalId","requestedAt","toolCallId","toolName","toolType"],"title":"V1AgentsIdExecutionsExecutionIdGetResponsesContentApplicationJsonSchemaPendingApproval"},"V1AgentsIdExecutionsExecutionIdGetResponsesContentApplicationJsonSchemaStatus":{"type":"string","enum":["queued","running","paused","completed","failed","cancelled","interrupted"],"title":"V1AgentsIdExecutionsExecutionIdGetResponsesContentApplicationJsonSchemaStatus"},"Agents_getExecutionDetail_Response_200":{"type":"object","properties":{"agentId":{"type":["string","null"]},"agentSource":{"type":["string","null"]},"agentSpec":{"description":"Any type"},"agentTargetResolution":{"$ref":"#/components/schemas/V1AgentsIdExecutionsExecutionIdGetResponsesContentApplicationJsonSchemaAgentTargetResolution","description":"How the run selected its definition: `alias` or `version` for a request that named a selector, `legacy-live-row` for a run that read the mutable agent row."},"agentVersion":{"oneOf":[{"$ref":"#/components/schemas/V1AgentsIdExecutionsExecutionIdGetResponsesContentApplicationJsonSchemaAgentVersion"},{"type":"null"}],"description":"Version number and label for `agentVersionId`, joined from `agent_versions`. `null` exactly when `agentVersionId` is `null`."},"agentVersionId":{"type":["string","null"],"description":"The `agent_versions` row this run was recorded against, or `null`. `null` means the surface that admitted the run stamps no version (A2A, Product API, A2A pause admission and the Product MCP capability path record none today) or the run predates version stamping. It is never a claim that the run executed an unversioned configuration."},"budgetExhausted":{"type":["boolean","null"],"description":"Whether the agent loop ended by exhausting its `maxTurns` budget. Read this rather than inferring truncation from `stopReason`: a single-turn loop publishes `end_turn` on a budget end to preserve its original payload shape, and several clean success paths publish that same value. `null` means UNKNOWN — a run recorded before this field existed, or one executed by a lane that reports no per-iteration breakdown (external agents, Claude Managed) — and must not be read as `false`."},"cancelRequestedAt":{"type":["string","null"]},"completedAt":{"type":["string","null"]},"conversationId":{"type":["string","null"],"description":"The conversation thread this run belongs to, so consumers can group a multi-turn conversation's runs without a per-run log query. This is the run's OWN thread, distinct from `parentConversationId` (subagent lineage, the conversation of the run that spawned it). `null` on stateless surfaces (webhook, schedule, eval, one-shot API) and on runs persisted before the column existed."},"createdAt":{"type":"string"},"executionId":{"type":"string"},"executionLane":{"$ref":"#/components/schemas/V1AgentsIdExecutionsExecutionIdGetResponsesContentApplicationJsonSchemaExecutionLane","description":"Which substrate actually ran this turn. `durable` means a Durable Object owned it: a Runtype session for an attached turn (the only lane that sets the `X-Runtype-Execution-Driver` response header), or the run owner a detached run is handed to. `in_process` means the request worker ran it to completion. Read back from the run's own admission-time record, so it reports what happened rather than what the current routing policy would choose now. `executionMode` cannot answer this on its own: both lanes record `attached` for an attached turn. One routing rule is worth knowing when comparing runs: `POST /v1/dispatch` keeps a request that sets `options.debugMode: true` on `in_process`."},"executionMode":{"$ref":"#/components/schemas/V1AgentsIdExecutionsExecutionIdGetResponsesContentApplicationJsonSchemaExecutionMode"},"expiresAt":{"type":["string","null"]},"externalObservedApprovals":{"$ref":"#/components/schemas/ExternalObservedApprovals"},"externalTelemetry":{"oneOf":[{"$ref":"#/components/schemas/V1AgentsIdExecutionsExecutionIdGetResponsesContentApplicationJsonSchemaExternalTelemetry"},{"type":"null"}],"description":"Bounded state of the authorized external OTLP trace. Null means no matching trace state is available; it never means complete. This contains no trace facts or captured content."},"finalOutput":{"description":"Any type"},"id":{"type":"string"},"inputMessages":{"description":"Any type"},"iterationDetails":{"description":"Any type"},"iterations":{"type":["integer","null"]},"lastHeartbeatAt":{"type":["string","null"]},"loopConfig":{"description":"Any type"},"notificationMode":{"$ref":"#/components/schemas/V1AgentsIdExecutionsExecutionIdGetResponsesContentApplicationJsonSchemaNotificationMode"},"parentAgentId":{"type":["string","null"]},"parentConversationId":{"type":["string","null"]},"parentExecutionId":{"type":["string","null"]},"parentToolCallId":{"type":["string","null"]},"pendingApproval":{"oneOf":[{"$ref":"#/components/schemas/V1AgentsIdExecutionsExecutionIdGetResponsesContentApplicationJsonSchemaPendingApproval"},{"type":"null"}]},"progress":{"description":"Any type"},"retryOfExecutionId":{"type":["string","null"]},"rootExecutionId":{"type":["string","null"]},"startedAt":{"type":["string","null"]},"status":{"$ref":"#/components/schemas/V1AgentsIdExecutionsExecutionIdGetResponsesContentApplicationJsonSchemaStatus"},"stopReason":{"type":["string","null"]},"surfaceType":{"type":["string","null"]},"totalCost":{"type":["string","null"]},"totalTokens":{"description":"Any type"}},"required":["agentId","agentSource","agentTargetResolution","agentVersion","agentVersionId","budgetExhausted","cancelRequestedAt","completedAt","conversationId","createdAt","executionId","executionLane","executionMode","expiresAt","externalObservedApprovals","externalTelemetry","id","iterations","lastHeartbeatAt","notificationMode","parentAgentId","parentConversationId","parentExecutionId","parentToolCallId","pendingApproval","retryOfExecutionId","rootExecutionId","startedAt","status","stopReason","surfaceType","totalCost"],"title":"Agents_getExecutionDetail_Response_200"},"V1AgentsIdExecutionsExecutionIdCancelPostResponsesContentApplicationJsonSchemaStatus":{"type":"string","enum":["cancelled"],"title":"V1AgentsIdExecutionsExecutionIdCancelPostResponsesContentApplicationJsonSchemaStatus"},"Agents_cancelADetachedAgentExecution_Response_202":{"type":"object","properties":{"executionId":{"type":"string"},"status":{"$ref":"#/components/schemas/V1AgentsIdExecutionsExecutionIdCancelPostResponsesContentApplicationJsonSchemaStatus"}},"required":["executionId","status"],"title":"Agents_cancelADetachedAgentExecution_Response_202"},"V1AgentsIdExecutionsExecutionIdToolCallsGetResponsesContentApplicationJsonSchemaToolCallsItems":{"type":"object","properties":{"completedAt":{"type":["string","null"],"description":"ISO timestamp derived as startedAt plus executionTimeMs. Null while the call has no recorded duration."},"createdAt":{"type":"string"},"errorMessage":{"type":["string","null"]},"executionTimeMs":{"type":["integer","null"]},"id":{"type":"string"},"inputParameters":{"description":"Recorded tool input. Replaced by { truncated: true, preview } when its JSON text exceeds 16 KiB; the per-call detail endpoint always returns the full value."},"inputTruncated":{"type":"boolean"},"iteration":{"type":["integer","null"]},"model":{"type":["string","null"]},"outputResult":{"description":"Recorded tool output. Replaced by { truncated: true, preview } when its JSON text exceeds 16 KiB; the per-call detail endpoint always returns the full value."},"outputTruncated":{"type":"boolean"},"startedAt":{"type":"string","description":"ISO timestamp the tool call started. Same instant as createdAt: the row is inserted when the tool starts, then updated in place with its result."},"status":{"type":"string","description":"'pending' | 'success' | 'failed' | 'waiting_for_local' | 'awaiting_approval' (paused at an approval gate, undecided) | 'denied' (the approver declined; the tool never ran)."},"toolCallId":{"type":["string","null"],"description":"The model's own tool-call id (tool_executions.external_tool_call_id), matching the toolCallId a log row carries. Null for a run whose tool rows were written by this API rather than ingested from an external trace."},"toolDescription":{"type":["string","null"]},"toolName":{"type":"string"}},"required":["completedAt","createdAt","errorMessage","executionTimeMs","id","inputTruncated","iteration","model","outputTruncated","startedAt","status","toolCallId","toolDescription","toolName"],"title":"V1AgentsIdExecutionsExecutionIdToolCallsGetResponsesContentApplicationJsonSchemaToolCallsItems"},"Agents_listToolCalls_Response_200":{"type":"object","properties":{"toolCalls":{"type":"array","items":{"$ref":"#/components/schemas/V1AgentsIdExecutionsExecutionIdToolCallsGetResponsesContentApplicationJsonSchemaToolCallsItems"}}},"required":["toolCalls"],"title":"Agents_listToolCalls_Response_200"},"Agents_getToolCallDetail_Response_200":{"type":"object","properties":{"createdAt":{"type":"string"},"errorMessage":{"type":["string","null"]},"executionTimeMs":{"type":["integer","null"]},"id":{"type":"string"},"inputParameters":{"description":"Any type"},"model":{"type":["string","null"]},"outputResult":{"description":"Any type"},"status":{"type":"string"},"toolDescription":{"type":["string","null"]},"toolId":{"type":["string","null"]},"toolName":{"type":"string"}},"required":["createdAt","errorMessage","executionTimeMs","id","model","status","toolDescription","toolId","toolName"],"title":"Agents_getToolCallDetail_Response_200"},"V1AgentsIdExportRuntimeGetParametersFormat":{"type":"string","enum":["json","bundle"],"description":"`json` (the default) returns the exported definition. `bundle` returns a vendorable `application/zip` with `agent.json` (the same definition), `runtime/` (the prebuilt `@runtypelabs/runtime` ESM package for the platform runtime version, installable as `file:./runtime`), `manifest.json`, and `LICENSE` (the runtime ships under FSL-1.1-ALv2).","title":"V1AgentsIdExportRuntimeGetParametersFormat"},"V1AgentsIdExportRuntimeGetResponsesContentApplicationJsonSchemaAgentType":{"type":"string","enum":["runtype","external"],"title":"V1AgentsIdExportRuntimeGetResponsesContentApplicationJsonSchemaAgentType"},"RuntimeHostDependencyOneOf0Kind":{"type":"string","enum":["durable-pause-host"],"title":"RuntimeHostDependencyOneOf0Kind"},"RuntimeHostDependencyOneOf0StepsItemsOwnerKind":{"type":"string","enum":["flow","agent","capability","inline-tool"],"title":"RuntimeHostDependencyOneOf0StepsItemsOwnerKind"},"RuntimeHostDependencyOneOf0StepsItems":{"type":"object","properties":{"ownerId":{"type":"string"},"ownerKind":{"$ref":"#/components/schemas/RuntimeHostDependencyOneOf0StepsItemsOwnerKind"},"ownerName":{"type":"string"},"stepId":{"type":"string"},"stepType":{"type":"string"}},"required":["ownerKind","stepId","stepType"],"title":"RuntimeHostDependencyOneOf0StepsItems"},"RuntimeHostDependency0":{"type":"object","properties":{"interface":{"type":"string"},"kind":{"$ref":"#/components/schemas/RuntimeHostDependencyOneOf0Kind"},"reason":{"type":"string"},"steps":{"type":"array","items":{"$ref":"#/components/schemas/RuntimeHostDependencyOneOf0StepsItems"}}},"required":["interface","kind","reason","steps"],"title":"RuntimeHostDependency0"},"RuntimeHostDependencyOneOf1AgentsItemsOwnerKind":{"type":"string","enum":["flow","agent","capability","inline-tool"],"title":"RuntimeHostDependencyOneOf1AgentsItemsOwnerKind"},"RuntimeHostDependencyOneOf1AgentsItems":{"type":"object","properties":{"ownerId":{"type":"string"},"ownerKind":{"$ref":"#/components/schemas/RuntimeHostDependencyOneOf1AgentsItemsOwnerKind"},"ownerName":{"type":"string"},"stepId":{"type":"string"}},"required":["ownerKind"],"title":"RuntimeHostDependencyOneOf1AgentsItems"},"RuntimeHostDependencyOneOf1Kind":{"type":"string","enum":["background-run-coordinator"],"title":"RuntimeHostDependencyOneOf1Kind"},"RuntimeHostDependency1":{"type":"object","properties":{"agents":{"type":"array","items":{"$ref":"#/components/schemas/RuntimeHostDependencyOneOf1AgentsItems"}},"interface":{"type":"string"},"kind":{"$ref":"#/components/schemas/RuntimeHostDependencyOneOf1Kind"},"reason":{"type":"string"}},"required":["agents","interface","kind","reason"],"title":"RuntimeHostDependency1"},"RuntimeHostDependencyOneOf2Kind":{"type":"string","enum":["hosted-tool-resolver"],"title":"RuntimeHostDependencyOneOf2Kind"},"RuntimeHostDependencyOneOf2ToolsItemsOwnerKind":{"type":"string","enum":["flow","agent","capability","inline-tool"],"title":"RuntimeHostDependencyOneOf2ToolsItemsOwnerKind"},"RuntimeHostDependencyOneOf2ToolsItems":{"type":"object","properties":{"ownerId":{"type":"string"},"ownerKind":{"$ref":"#/components/schemas/RuntimeHostDependencyOneOf2ToolsItemsOwnerKind"},"ownerName":{"type":"string"},"stepId":{"type":"string"},"toolId":{"type":"string"}},"required":["ownerKind","toolId"],"title":"RuntimeHostDependencyOneOf2ToolsItems"},"RuntimeHostDependency2":{"type":"object","properties":{"interface":{"type":"string"},"kind":{"$ref":"#/components/schemas/RuntimeHostDependencyOneOf2Kind"},"reason":{"type":"string"},"tools":{"type":"array","items":{"$ref":"#/components/schemas/RuntimeHostDependencyOneOf2ToolsItems"}}},"required":["interface","kind","reason","tools"],"title":"RuntimeHostDependency2"},"RuntimeHostDependencyOneOf3Kind":{"type":"string","enum":["record-store"],"title":"RuntimeHostDependencyOneOf3Kind"},"RuntimeHostDependencyOneOf3StepsItemsOwnerKind":{"type":"string","enum":["flow","agent","capability","inline-tool"],"title":"RuntimeHostDependencyOneOf3StepsItemsOwnerKind"},"RuntimeHostDependencyOneOf3StepsItems":{"type":"object","properties":{"ownerId":{"type":"string"},"ownerKind":{"$ref":"#/components/schemas/RuntimeHostDependencyOneOf3StepsItemsOwnerKind"},"ownerName":{"type":"string"},"stepId":{"type":"string"},"stepType":{"type":"string"}},"required":["ownerKind","stepId","stepType"],"title":"RuntimeHostDependencyOneOf3StepsItems"},"RuntimeHostDependency3":{"type":"object","properties":{"interface":{"type":"string"},"kind":{"$ref":"#/components/schemas/RuntimeHostDependencyOneOf3Kind"},"reason":{"type":"string"},"steps":{"type":"array","items":{"$ref":"#/components/schemas/RuntimeHostDependencyOneOf3StepsItems"}}},"required":["interface","kind","reason","steps"],"title":"RuntimeHostDependency3"},"RuntimeHostDependency4":{"type":"object","properties":{"interface":{"type":"string"},"kind":{"type":"string"},"reason":{"type":"string"}},"required":["interface","kind","reason"],"description":"Forward-compatibility member: a host dependency whose `kind` this API version does not define. Render `interface` and `reason`; kind-specific evidence arrives as additional properties.","title":"RuntimeHostDependency4"},"RuntimeHostDependency":{"oneOf":[{"$ref":"#/components/schemas/RuntimeHostDependency0"},{"$ref":"#/components/schemas/RuntimeHostDependency1"},{"$ref":"#/components/schemas/RuntimeHostDependency2"},{"$ref":"#/components/schemas/RuntimeHostDependency3"},{"$ref":"#/components/schemas/RuntimeHostDependency4"}],"title":"RuntimeHostDependency"},"V1AgentsIdExportRuntimeGetResponsesContentApplicationJsonSchemaRelease":{"type":"object","properties":{"alias":{"type":"string"},"aliasRevision":{"type":"integer"},"versionId":{"type":"string"}},"required":["versionId"],"description":"The published version this export contains. `alias` and `aliasRevision` are present when a release alias selected it. Absent when the export read the agent's current definition.","title":"V1AgentsIdExportRuntimeGetResponsesContentApplicationJsonSchemaRelease"},"RuntimeExportedSkill":{"type":"object","properties":{"approvalDelta":{"type":"array","items":{"type":"string"}},"body":{"type":"string"},"description":{"type":"string"},"resolvedTools":{"type":"array","items":{"type":"object","additionalProperties":{"description":"Any type"}}},"skillId":{"type":"string"},"skillVersionId":{"type":"string","description":"The skill version this snapshot was resolved from."},"slug":{"type":"string","description":"Skill slug; the agent loads it as `skill:<slug>`."}},"required":["approvalDelta","body","description","resolvedTools","slug"],"title":"RuntimeExportedSkill"},"RuntimeExportWarningChildKind":{"type":"string","enum":["agent","flow","question_set","mcp_server"],"description":"What kind of child the warning is about. `question_set` names the question set id in `childId`. `mcp_server` names a registered MCP server the export kept as an `mcp:` reference instead of inlining it (`unsupported_mcp_auth` for OAuth, `not_found` when the server is missing or inactive); only a host that implements `resolveHostedToolRefs` can run its tools.","title":"RuntimeExportWarningChildKind"},"RuntimeExportWarningCode":{"type":"string","enum":["child_dropped","child_stubbed"],"description":"`child_dropped`: the child is absent from the artifact. `child_stubbed`: the artifact carries a stub the runtime cannot run, or a configured decision tool without its question set.","title":"RuntimeExportWarningCode"},"RuntimeExportWarningReason":{"type":"string","enum":["not_found","claude_managed_unsupported","max_depth_exceeded","invalid_flow_config","unresolved_tool_ref","unsupported_mcp_auth","question_set_unresolved"],"description":"Why the export could not embed the child. `question_set_unresolved`: a configured `decision_judge` tool references a question set that is missing, unpublished, owned by another account, or pinned to a version that is not published; the tool stays in the artifact without `config.questionSet`, so a self-hosted runtime in own-key mode refuses its calls (platform and hybrid modes resolve it through Runtype).","title":"RuntimeExportWarningReason"},"RuntimeExportWarning":{"type":"object","properties":{"childId":{"type":"string"},"childKind":{"$ref":"#/components/schemas/RuntimeExportWarningChildKind","description":"What kind of child the warning is about. `question_set` names the question set id in `childId`. `mcp_server` names a registered MCP server the export kept as an `mcp:` reference instead of inlining it (`unsupported_mcp_auth` for OAuth, `not_found` when the server is missing or inactive); only a host that implements `resolveHostedToolRefs` can run its tools."},"code":{"$ref":"#/components/schemas/RuntimeExportWarningCode","description":"`child_dropped`: the child is absent from the artifact. `child_stubbed`: the artifact carries a stub the runtime cannot run, or a configured decision tool without its question set."},"message":{"type":"string"},"parentId":{"type":"string","description":"The agent whose capability referenced the child, when the child came from one."},"reason":{"$ref":"#/components/schemas/RuntimeExportWarningReason","description":"Why the export could not embed the child. `question_set_unresolved`: a configured `decision_judge` tool references a question set that is missing, unpublished, owned by another account, or pinned to a version that is not published; the tool stays in the artifact without `config.questionSet`, so a self-hosted runtime in own-key mode refuses its calls (platform and hybrid modes resolve it through Runtype)."},"toolName":{"type":"string","description":"The capability or tool name that referenced the child."}},"required":["childKind","code","message","reason"],"title":"RuntimeExportWarning"},"Agents_exportAgentForRuntime_Response_200":{"type":"object","properties":{"agentType":{"$ref":"#/components/schemas/V1AgentsIdExportRuntimeGetResponsesContentApplicationJsonSchemaAgentType"},"capabilities":{"type":"array","items":{"type":"object","additionalProperties":{"description":"Any type"}}},"config":{"type":"object","additionalProperties":{"description":"Any type"}},"description":{"type":["string","null"]},"externalConfig":{"type":"object","additionalProperties":{"description":"Any type"}},"hostDependencies":{"type":"array","items":{"$ref":"#/components/schemas/RuntimeHostDependency"}},"id":{"type":"string"},"name":{"type":"string"},"release":{"$ref":"#/components/schemas/V1AgentsIdExportRuntimeGetResponsesContentApplicationJsonSchemaRelease","description":"The published version this export contains. `alias` and `aliasRevision` are present when a release alias selected it. Absent when the export read the agent's current definition."},"skills":{"type":"array","items":{"$ref":"#/components/schemas/RuntimeExportedSkill"},"description":"Skills bound to the agent, snapshotted with the skill version each resolved to. `executeAgent` loads them with no host wiring. Absent when the agent has no bound skills."},"warnings":{"type":"array","items":{"$ref":"#/components/schemas/RuntimeExportWarning"},"description":"Referenced sub-agents, flows and question sets the export could not embed, each with the reason. The export still returns `200`; a tool or capability that names a dropped child is absent from the artifact. Empty when every child was embedded."}},"required":["agentType","config","description","hostDependencies","id","name","warnings"],"title":"Agents_exportAgentForRuntime_Response_200"},"RuntimeExportErrorDetailsItems":{"type":"object","properties":{"code":{"type":"string","description":"Stable Runtype validation code (e.g. MISSING_REQUIRED_FIELD, INVALID_ENUM)."},"message":{"type":"string"},"path":{"type":"string","description":"Dotted JSON path to the offending field."},"suggestion":{"type":"string","description":"Actionable hint (allowed values, accepted range, …)."}},"required":["message"],"title":"RuntimeExportErrorDetailsItems"},"RuntimeExportError":{"type":"object","properties":{"code":{"type":"string","description":"Stable refusal code: `raw_credential_in_export` or `selector_unsupported_agent_type`."},"details":{"type":"array","items":{"$ref":"#/components/schemas/RuntimeExportErrorDetailsItems"}},"error":{"type":"string"},"requiredScopes":{"type":"array","items":{"type":"string"},"description":"On `insufficient_scope`: every API key scope this request needs."}},"required":["error"],"title":"RuntimeExportError"},"Agents_publishAgent_Response_200":{"type":"object","properties":{"_warnings":{"type":"array","items":{"type":"string"}},"message":{"type":"string"},"publishedVersionId":{"type":"string"},"success":{"type":"boolean"}},"required":["message","publishedVersionId","success"],"title":"Agents_publishAgent_Response_200"},"Agents_refreshCachedAgentCard_Response_200":{"type":"object","properties":{"agentType":{"type":"string"},"changeReport":{"type":"object","additionalProperties":{"description":"Any type"}},"claudeManagedConfig":{"type":["object","null"],"additionalProperties":{"description":"Any type"}},"config":{"type":["object","null"],"additionalProperties":{"description":"Any type"}},"createdAt":{"type":"string"},"description":{"type":["string","null"]},"externalConfig":{"type":["object","null"],"additionalProperties":{"description":"Any type"}},"icon":{"type":["string","null"]},"id":{"type":"string"},"name":{"type":"string"},"organizationId":{"type":["string","null"]},"status":{"type":"string"},"updatedAt":{"type":"string"},"userId":{"type":"string"}},"required":["agentType","changeReport","claudeManagedConfig","config","createdAt","description","externalConfig","icon","id","name","organizationId","status","updatedAt","userId"],"title":"Agents_refreshCachedAgentCard_Response_200"},"AgentResumeContinuationJsonResponseStatus":{"type":"string","enum":["completed","paused","failed"],"title":"AgentResumeContinuationJsonResponseStatus"},"AgentResumeContinuationJsonResponseStopReason":{"type":"string","enum":["end_turn","paused","error"],"title":"AgentResumeContinuationJsonResponseStopReason"},"AgentResumeContinuationJsonResponse":{"type":"object","properties":{"blockReason":{"type":"string"},"code":{"type":"string"},"error":{"type":"string"},"iterations":{"type":"integer","minimum":0},"pausedReason":{"$ref":"#/components/schemas/DispatchPausedReason"},"result":{"type":"string"},"status":{"$ref":"#/components/schemas/AgentResumeContinuationJsonResponseStatus"},"stopReason":{"$ref":"#/components/schemas/AgentResumeContinuationJsonResponseStopReason"},"success":{"type":"boolean"},"totalCost":{"type":"number","format":"double"},"upgradeUrl":{"type":"string"}},"required":["iterations","result","status","stopReason","success","totalCost"],"title":"AgentResumeContinuationJsonResponse"},"V1AgentsIdRunInsightsGetResponsesContentApplicationJsonSchemaDataCost":{"type":"object","properties":{"avgPerRun":{"type":"number","format":"double"}},"required":["avgPerRun"],"title":"V1AgentsIdRunInsightsGetResponsesContentApplicationJsonSchemaDataCost"},"V1AgentsIdRunInsightsGetResponsesContentApplicationJsonSchemaDataTokens":{"type":"object","properties":{"avgInputPerRun":{"type":"number","format":"double"},"avgPerRun":{"type":"number","format":"double"}},"required":["avgInputPerRun","avgPerRun"],"title":"V1AgentsIdRunInsightsGetResponsesContentApplicationJsonSchemaDataTokens"},"V1AgentsIdRunInsightsGetResponsesContentApplicationJsonSchemaDataToolsItems":{"type":"object","properties":{"calls":{"type":"integer"},"failedCalls":{"type":"integer"},"runsUsing":{"type":"integer"},"toolName":{"type":"string"}},"required":["calls","failedCalls","runsUsing","toolName"],"title":"V1AgentsIdRunInsightsGetResponsesContentApplicationJsonSchemaDataToolsItems"},"V1AgentsIdRunInsightsGetResponsesContentApplicationJsonSchemaDataVersionsItems":{"type":"object","properties":{"agentVersionId":{"type":["string","null"]},"failed":{"type":"integer"},"label":{"type":["string","null"]},"runs":{"type":"integer"},"versionNumber":{"type":["integer","null"],"description":"The immutable version number, for ordering; labels are user-set"}},"required":["agentVersionId","failed","label","runs","versionNumber"],"title":"V1AgentsIdRunInsightsGetResponsesContentApplicationJsonSchemaDataVersionsItems"},"V1AgentsIdRunInsightsGetResponsesContentApplicationJsonSchemaDataWindow":{"type":"object","properties":{"from":{"type":["string","null"]},"runs":{"type":"integer"},"to":{"type":["string","null"]}},"required":["from","runs","to"],"title":"V1AgentsIdRunInsightsGetResponsesContentApplicationJsonSchemaDataWindow"},"V1AgentsIdRunInsightsGetResponsesContentApplicationJsonSchemaData":{"type":"object","properties":{"attachedTools":{"type":"array","items":{"type":"string"}},"attachedToolsRuns":{"type":"integer","description":"Runs in the window on that version, the only runs neverCalledTools is judged over"},"attachedToolsVersionId":{"type":["string","null"],"description":"The version attachedTools was read from; null when the agent has no published version"},"cost":{"oneOf":[{"$ref":"#/components/schemas/V1AgentsIdRunInsightsGetResponsesContentApplicationJsonSchemaDataCost"},{"type":"null"}]},"neverCalledTools":{"type":"array","items":{"type":"string"}},"tokens":{"oneOf":[{"$ref":"#/components/schemas/V1AgentsIdRunInsightsGetResponsesContentApplicationJsonSchemaDataTokens"},{"type":"null"}]},"tools":{"type":"array","items":{"$ref":"#/components/schemas/V1AgentsIdRunInsightsGetResponsesContentApplicationJsonSchemaDataToolsItems"}},"versions":{"type":"array","items":{"$ref":"#/components/schemas/V1AgentsIdRunInsightsGetResponsesContentApplicationJsonSchemaDataVersionsItems"}},"window":{"$ref":"#/components/schemas/V1AgentsIdRunInsightsGetResponsesContentApplicationJsonSchemaDataWindow"}},"required":["attachedTools","attachedToolsRuns","attachedToolsVersionId","cost","neverCalledTools","tokens","tools","versions","window"],"title":"V1AgentsIdRunInsightsGetResponsesContentApplicationJsonSchemaData"},"Agents_rollUpRecentRunsOfAnAgent_Response_200":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/V1AgentsIdRunInsightsGetResponsesContentApplicationJsonSchemaData"},"success":{"type":"boolean"}},"required":["data","success"],"title":"Agents_rollUpRecentRunsOfAnAgent_Response_200"},"ManagedAgentRunSummary":{"type":"object","properties":{"agentId":{"type":"string"},"conversationId":{"type":"string"},"costThousandths":{"type":"number","format":"double","description":"Cost in thousandths of a cent ($1 = 100,000)."},"createdAt":{"type":"string"},"error":{"type":["string","null"]},"executionId":{"type":"string","description":"The DO-minted execution id for the turn."},"finalText":{"type":["string","null"],"description":"The final assistant text (may be large or null)."},"id":{"type":"string","description":"Run id (typeid, `mar_…`)."},"inputTokens":{"type":"number","format":"double"},"lastEventSeq":{"type":"number","format":"double","description":"The durable seq at settle (reconnect ceiling)."},"outputTokens":{"type":"number","format":"double"},"settledAt":{"type":"string"},"startedAt":{"type":"string"},"status":{"type":"string","description":"'completed' | 'failed' | 'interrupted'."}},"required":["agentId","conversationId","costThousandths","createdAt","error","executionId","finalText","id","inputTokens","lastEventSeq","outputTokens","settledAt","startedAt","status"],"title":"ManagedAgentRunSummary"},"Agents_listManagedAgentRuns_Response_200":{"type":"object","properties":{"runs":{"type":"array","items":{"$ref":"#/components/schemas/ManagedAgentRunSummary"}}},"required":["runs"],"title":"Agents_listManagedAgentRuns_Response_200"},"ManagedAgentRunOutput":{"type":"object","properties":{"anthropicFileId":{"type":"string"},"assetRef":{"type":["string","null"],"description":"Asset-storage key the bytes were persisted to."},"createdAt":{"type":"string"},"filename":{"type":"string"},"id":{"type":"string","description":"Deliverable pointer id (typeid, `mao_…`)."},"mimeType":{"type":"string"},"sizeBytes":{"type":"number","format":"double"}},"required":["anthropicFileId","assetRef","createdAt","filename","id","mimeType","sizeBytes"],"title":"ManagedAgentRunOutput"},"Agents_getAManagedAgentRun_Response_200":{"type":"object","properties":{"outputs":{"type":"array","items":{"$ref":"#/components/schemas/ManagedAgentRunOutput"}},"run":{"$ref":"#/components/schemas/ManagedAgentRunSummary"}},"required":["outputs","run"],"title":"Agents_getAManagedAgentRun_Response_200"},"TokenAudiencePolicyEntryAllowedGrantsItems":{"type":"string","enum":["principal","delegated"],"title":"TokenAudiencePolicyEntryAllowedGrantsItems"},"TokenAudiencePolicyEntryTargetKind":{"type":"string","enum":["resource"],"description":"Always `resource` in this release.","title":"TokenAudiencePolicyEntryTargetKind"},"TokenAudiencePolicyEntry":{"type":"object","properties":{"allowedGrants":{"type":"array","items":{"$ref":"#/components/schemas/TokenAudiencePolicyEntryAllowedGrantsItems"},"description":"`principal` lets the agent get its own tokens for this resource with client credentials."},"allowedScopes":{"type":"array","items":{"type":"string"},"description":"Scopes a token for this resource may carry."},"resource":{"type":"string","description":"Canonical resource URI (https, no query or fragment), for example `https://mcp.example.com/mcp`."},"targetKind":{"$ref":"#/components/schemas/TokenAudiencePolicyEntryTargetKind","description":"Always `resource` in this release."},"ttlCeilingSeconds":{"type":["integer","null"],"minimum":120,"maximum":300,"description":"Lowers the 300-second token lifetime for this resource."}},"required":["allowedGrants","resource"],"title":"TokenAudiencePolicyEntry"},"TokenAudiencePolicy":{"type":"object","properties":{"agentId":{"type":"string"},"entries":{"type":"array","items":{"$ref":"#/components/schemas/TokenAudiencePolicyEntry"}},"policyRevision":{"type":"integer","description":"Increases on every change; 0 when no policy was ever set."},"updatedAt":{"type":["string","null"]},"updatedByUserId":{"type":["string","null"]}},"required":["agentId","entries","policyRevision","updatedAt","updatedByUserId"],"title":"TokenAudiencePolicy"},"ReplaceTokenAudiencePolicyRequest":{"type":"object","properties":{"entries":{"type":"array","items":{"$ref":"#/components/schemas/TokenAudiencePolicyEntry"}},"expectedPolicyRevision":{"type":"integer","minimum":0,"description":"Refuse with 409 unless the current revision equals this."}},"required":["entries"],"title":"ReplaceTokenAudiencePolicyRequest"},"SessionPreviewUrlWarningCode":{"type":"string","enum":["SESSION_PREVIEW_URL"],"title":"SessionPreviewUrlWarningCode"},"SessionPreviewUrlWarningSeverity":{"type":"string","enum":["warning"],"title":"SessionPreviewUrlWarningSeverity"},"SessionPreviewUrlWarning":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/SessionPreviewUrlWarningCode"},"message":{"type":"string"},"path":{"type":"string","description":"The saved field that holds the URL, for example `entries[0].resource`."},"severity":{"$ref":"#/components/schemas/SessionPreviewUrlWarningSeverity"},"suggestedFix":{"type":"string"}},"required":["code","message","path","severity","suggestedFix"],"title":"SessionPreviewUrlWarning"},"ReplaceTokenAudiencePolicyResponse":{"type":"object","properties":{"agentId":{"type":"string"},"entries":{"type":"array","items":{"$ref":"#/components/schemas/TokenAudiencePolicyEntry"}},"policyRevision":{"type":"integer","description":"Increases on every change; 0 when no policy was ever set."},"updatedAt":{"type":["string","null"]},"updatedByUserId":{"type":["string","null"]},"warnings":{"type":"array","items":{"$ref":"#/components/schemas/SessionPreviewUrlWarning"},"description":"Resources that are session sandbox preview URLs, which stop working when the sandbox container stops. Present only when non-empty; never blocks the write."}},"required":["agentId","entries","policyRevision","updatedAt","updatedByUserId"],"title":"ReplaceTokenAudiencePolicyResponse"},"Agents_executeAgentVoiceTextToSpeech_Response_200":{"type":"object","properties":{"audioBase64":{"type":"string"},"audioUrl":{"type":"string"},"duration":{"type":"number","format":"double"},"modelId":{"type":"string"},"success":{"type":"boolean"},"voiceId":{"type":"string"}},"required":["success"],"title":"Agents_executeAgentVoiceTextToSpeech_Response_200"},"CreateVoiceAgentDraftRequestConfigAdvisor":{"type":"object","properties":{"model":{"type":"string"},"systemPrompt":{"type":"string"}},"required":["model"],"title":"CreateVoiceAgentDraftRequestConfigAdvisor"},"CreateVoiceAgentDraftRequestConfigArtifactsTypesItems":{"type":"string","enum":["markdown","component"],"title":"CreateVoiceAgentDraftRequestConfigArtifactsTypesItems"},"CreateVoiceAgentDraftRequestConfigArtifacts":{"type":"object","properties":{"enabled":{"type":"boolean"},"types":{"type":"array","items":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigArtifactsTypesItems"}}},"required":["enabled","types"],"title":"CreateVoiceAgentDraftRequestConfigArtifacts"},"CreateVoiceAgentDraftRequestConfigBusyMessageRoutingMode":{"type":"string","enum":["enforced","off"],"title":"CreateVoiceAgentDraftRequestConfigBusyMessageRoutingMode"},"CreateVoiceAgentDraftRequestConfigBusyMessageRouting":{"type":"object","properties":{"classifierModel":{"type":"string","minLength":1,"maxLength":200},"mode":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigBusyMessageRoutingMode"}},"title":"CreateVoiceAgentDraftRequestConfigBusyMessageRouting"},"CreateVoiceAgentDraftRequestConfigContextManagementCompactionStrategy":{"type":"string","enum":["auto","provider_native","summary"],"title":"CreateVoiceAgentDraftRequestConfigContextManagementCompactionStrategy"},"CreateVoiceAgentDraftRequestConfigContextManagementCompaction":{"type":"object","properties":{"enabled":{"type":"boolean"},"instructions":{"type":"string","maxLength":4000},"model":{"type":"string"},"retainRecentTokens":{"type":"integer","minimum":0},"strategy":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigContextManagementCompactionStrategy"},"thresholdRatio":{"type":"number","format":"double","minimum":0.3,"maximum":0.98},"thresholdTokens":{"type":"integer","minimum":50000}},"title":"CreateVoiceAgentDraftRequestConfigContextManagementCompaction"},"CreateVoiceAgentDraftRequestConfigContextManagementToolResultsPruneMode":{"type":"string","enum":["mask","off"],"title":"CreateVoiceAgentDraftRequestConfigContextManagementToolResultsPruneMode"},"CreateVoiceAgentDraftRequestConfigContextManagementToolResults":{"type":"object","properties":{"inlineThresholdChars":{"type":"integer","minimum":1024,"description":"Deprecated and ignored. Tool results are never spilled.","deprecated":true},"pruneHotWindowTokens":{"type":"integer","minimum":4000},"pruneMode":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigContextManagementToolResultsPruneMode"}},"title":"CreateVoiceAgentDraftRequestConfigContextManagementToolResults"},"CreateVoiceAgentDraftRequestConfigContextManagement":{"type":"object","properties":{"compaction":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigContextManagementCompaction"},"toolResults":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigContextManagementToolResults"}},"title":"CreateVoiceAgentDraftRequestConfigContextManagement"},"CreateVoiceAgentDraftRequestConfigDurabilityForced":{"type":"string","enum":["durable","in_process"],"title":"CreateVoiceAgentDraftRequestConfigDurabilityForced"},"CreateVoiceAgentDraftRequestConfigDurability":{"type":"object","properties":{"forced":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigDurabilityForced"},"maxBudgetMs":{"type":["integer","null"],"minimum":1000,"maximum":86400000},"watchLeaseMs":{"type":["integer","null"],"minimum":10000,"maximum":1800000}},"title":"CreateVoiceAgentDraftRequestConfigDurability"},"CreateVoiceAgentDraftRequestConfigErrorHandlingFallbacksItemsOneOf0Type":{"type":"string","enum":["retry"],"title":"CreateVoiceAgentDraftRequestConfigErrorHandlingFallbacksItemsOneOf0Type"},"CreateVoiceAgentDraftRequestConfigErrorHandlingFallbacksItems0":{"type":"object","properties":{"delay":{"type":"integer","minimum":0,"maximum":60000},"type":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigErrorHandlingFallbacksItemsOneOf0Type"}},"required":["type"],"title":"CreateVoiceAgentDraftRequestConfigErrorHandlingFallbacksItems0"},"CreateVoiceAgentDraftRequestConfigErrorHandlingFallbacksItemsOneOf1Type":{"type":"string","enum":["model"],"title":"CreateVoiceAgentDraftRequestConfigErrorHandlingFallbacksItemsOneOf1Type"},"CreateVoiceAgentDraftRequestConfigErrorHandlingFallbacksItems1":{"type":"object","properties":{"delay":{"type":"integer","minimum":0,"maximum":60000},"maxTokens":{"type":"integer","minimum":1},"model":{"type":"string"},"temperature":{"type":"number","format":"double","minimum":0,"maximum":2},"type":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigErrorHandlingFallbacksItemsOneOf1Type"}},"required":["model","type"],"title":"CreateVoiceAgentDraftRequestConfigErrorHandlingFallbacksItems1"},"CreateVoiceAgentDraftRequestConfigErrorHandlingFallbacksItemsOneOf2Type":{"type":"string","enum":["message"],"title":"CreateVoiceAgentDraftRequestConfigErrorHandlingFallbacksItemsOneOf2Type"},"CreateVoiceAgentDraftRequestConfigErrorHandlingFallbacksItems2":{"type":"object","properties":{"delay":{"type":"integer","minimum":0,"maximum":60000},"message":{"type":"string"},"type":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigErrorHandlingFallbacksItemsOneOf2Type"}},"required":["message","type"],"title":"CreateVoiceAgentDraftRequestConfigErrorHandlingFallbacksItems2"},"CreateVoiceAgentDraftRequestConfigErrorHandlingFallbacksItems":{"oneOf":[{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigErrorHandlingFallbacksItems0"},{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigErrorHandlingFallbacksItems1"},{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigErrorHandlingFallbacksItems2"}],"title":"CreateVoiceAgentDraftRequestConfigErrorHandlingFallbacksItems"},"CreateVoiceAgentDraftRequestConfigErrorHandlingOnError":{"type":"string","enum":["fail","continue","fallback"],"title":"CreateVoiceAgentDraftRequestConfigErrorHandlingOnError"},"CreateVoiceAgentDraftRequestConfigErrorHandlingTriggersItemsType":{"type":"string","enum":["error","empty-output"],"title":"CreateVoiceAgentDraftRequestConfigErrorHandlingTriggersItemsType"},"CreateVoiceAgentDraftRequestConfigErrorHandlingTriggersItems":{"type":"object","properties":{"type":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigErrorHandlingTriggersItemsType"}},"required":["type"],"title":"CreateVoiceAgentDraftRequestConfigErrorHandlingTriggersItems"},"CreateVoiceAgentDraftRequestConfigErrorHandling":{"type":"object","properties":{"fallbacks":{"type":"array","items":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigErrorHandlingFallbacksItems"}},"onError":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigErrorHandlingOnError"},"triggers":{"type":"array","items":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigErrorHandlingTriggersItems"}}},"required":["onError"],"title":"CreateVoiceAgentDraftRequestConfigErrorHandling"},"CreateVoiceAgentDraftRequestConfigLoggingPolicy":{"type":"string","enum":["default","on","off"],"title":"CreateVoiceAgentDraftRequestConfigLoggingPolicy"},"CreateVoiceAgentDraftRequestConfigLoopConfig":{"type":"object","properties":{"enableReflection":{"type":"boolean"},"maxCost":{"type":"number","format":"double","minimum":0},"maxTurns":{"type":"integer","minimum":1,"maximum":100},"reflectionInterval":{"type":"integer","minimum":1,"maximum":50},"treatLengthCutoffAsFailure":{"type":"boolean"}},"title":"CreateVoiceAgentDraftRequestConfigLoopConfig"},"CreateVoiceAgentDraftRequestConfigMemoryPointerScope":{"type":"string","enum":["shared","alias","version"],"title":"CreateVoiceAgentDraftRequestConfigMemoryPointerScope"},"CreateVoiceAgentDraftRequestConfigMemory":{"type":"object","properties":{"enabled":{"type":"boolean"},"injectSummary":{"type":"boolean"},"pointerScope":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigMemoryPointerScope"},"profileTemplate":{"type":"string"}},"required":["enabled"],"title":"CreateVoiceAgentDraftRequestConfigMemory"},"CreateVoiceAgentDraftRequestConfigOutputValidatorsItemsOneOf0Type":{"type":"string","enum":["candidate-question","requested-json","no-action","json-schema"],"title":"CreateVoiceAgentDraftRequestConfigOutputValidatorsItemsOneOf0Type"},"CreateVoiceAgentDraftRequestConfigOutputValidatorsItems0":{"type":"object","properties":{"maxBounces":{"type":"integer","minimum":0,"maximum":10},"schema":{"type":"object","additionalProperties":{"description":"Any type"}},"type":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigOutputValidatorsItemsOneOf0Type"}},"required":["type"],"title":"CreateVoiceAgentDraftRequestConfigOutputValidatorsItems0"},"CreateVoiceAgentDraftRequestConfigOutputValidatorsItemsOneOf1Type":{"type":"string","enum":["custom"],"title":"CreateVoiceAgentDraftRequestConfigOutputValidatorsItemsOneOf1Type"},"CreateVoiceAgentDraftRequestConfigOutputValidatorsItems1":{"type":"object","properties":{"maxBounces":{"type":"integer","minimum":0,"maximum":10},"name":{"type":"string","minLength":1,"maxLength":128},"timeoutMs":{"type":"integer","minimum":1,"maximum":300000},"type":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigOutputValidatorsItemsOneOf1Type"}},"required":["name","type"],"title":"CreateVoiceAgentDraftRequestConfigOutputValidatorsItems1"},"CreateVoiceAgentDraftRequestConfigOutputValidatorsItemsOneOf2Type":{"type":"string","enum":["flow"],"title":"CreateVoiceAgentDraftRequestConfigOutputValidatorsItemsOneOf2Type"},"CreateVoiceAgentDraftRequestConfigOutputValidatorsItems2":{"type":"object","properties":{"flowId":{"type":"string","minLength":1},"maxBounces":{"type":"integer","minimum":0,"maximum":10},"outputVariable":{"type":"string","minLength":1,"maxLength":128},"timeoutMs":{"type":"integer","minimum":1,"maximum":300000},"type":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigOutputValidatorsItemsOneOf2Type"}},"required":["flowId","type"],"title":"CreateVoiceAgentDraftRequestConfigOutputValidatorsItems2"},"CreateVoiceAgentDraftRequestConfigOutputValidatorsItemsOneOf3Type":{"type":"string","enum":["tool"],"title":"CreateVoiceAgentDraftRequestConfigOutputValidatorsItemsOneOf3Type"},"CreateVoiceAgentDraftRequestConfigOutputValidatorsItems3":{"type":"object","properties":{"maxBounces":{"type":"integer","minimum":0,"maximum":10},"timeoutMs":{"type":"integer","minimum":1,"maximum":300000},"toolId":{"type":"string","minLength":1},"type":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigOutputValidatorsItemsOneOf3Type"}},"required":["toolId","type"],"title":"CreateVoiceAgentDraftRequestConfigOutputValidatorsItems3"},"CreateVoiceAgentDraftRequestConfigOutputValidatorsItems":{"oneOf":[{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigOutputValidatorsItems0"},{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigOutputValidatorsItems1"},{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigOutputValidatorsItems2"},{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigOutputValidatorsItems3"}],"title":"CreateVoiceAgentDraftRequestConfigOutputValidatorsItems"},"CreateVoiceAgentDraftRequestConfigOutput":{"type":"object","properties":{"validators":{"type":"array","items":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigOutputValidatorsItems"}}},"title":"CreateVoiceAgentDraftRequestConfigOutput"},"CreateVoiceAgentDraftRequestConfigPiiRedaction":{"type":"string","enum":["default","off","redact"],"title":"CreateVoiceAgentDraftRequestConfigPiiRedaction"},"CreateVoiceAgentDraftRequestConfigReasoningOneOf1ReasoningEffort":{"type":"string","enum":["minimal","low","medium","high","xhigh","max"],"title":"CreateVoiceAgentDraftRequestConfigReasoningOneOf1ReasoningEffort"},"CreateVoiceAgentDraftRequestConfigReasoningOneOf1ReasoningSummary":{"type":"string","enum":["auto","detailed"],"title":"CreateVoiceAgentDraftRequestConfigReasoningOneOf1ReasoningSummary"},"CreateVoiceAgentDraftRequestConfigReasoning1":{"type":"object","properties":{"budgetTokens":{"type":"integer","minimum":1000,"maximum":100000},"effort":{"type":"string","minLength":1,"maxLength":32},"enabled":{"type":"boolean"},"includeThoughts":{"type":"boolean"},"reasoningEffort":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigReasoningOneOf1ReasoningEffort"},"reasoningSummary":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigReasoningOneOf1ReasoningSummary"},"thinkingBudget":{"type":"integer","minimum":1024,"maximum":65536},"thinkingLevel":{"type":"string","minLength":1,"maxLength":32}},"required":["enabled"],"title":"CreateVoiceAgentDraftRequestConfigReasoning1"},"CreateVoiceAgentDraftRequestConfigReasoning":{"oneOf":[{"type":"boolean"},{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigReasoning1"}],"title":"CreateVoiceAgentDraftRequestConfigReasoning"},"CreateVoiceAgentDraftRequestConfigSandboxCodingAgentsItems":{"type":"string","enum":["opencode"],"title":"CreateVoiceAgentDraftRequestConfigSandboxCodingAgentsItems"},"CreateVoiceAgentDraftRequestConfigSandboxInstanceType":{"type":"string","enum":["standard-1","standard-2","standard-3","standard-4"],"description":"Only standard-4 is supported on the hosted Agent Sandbox path; other sizes cannot be enabled.","title":"CreateVoiceAgentDraftRequestConfigSandboxInstanceType"},"CreateVoiceAgentDraftRequestConfigSandboxNetworkAccess0":{"type":"string","enum":["none","essentials","open"],"title":"CreateVoiceAgentDraftRequestConfigSandboxNetworkAccess0"},"CreateVoiceAgentDraftRequestConfigSandboxNetworkAccessOneOf1Profile":{"type":"string","enum":["none","essentials","open"],"title":"CreateVoiceAgentDraftRequestConfigSandboxNetworkAccessOneOf1Profile"},"CreateVoiceAgentDraftRequestConfigSandboxNetworkAccess1":{"type":"object","properties":{"allow":{"type":"array","items":{"type":"string"}},"profile":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigSandboxNetworkAccessOneOf1Profile"}},"title":"CreateVoiceAgentDraftRequestConfigSandboxNetworkAccess1"},"CreateVoiceAgentDraftRequestConfigSandboxNetworkAccess":{"oneOf":[{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigSandboxNetworkAccess0"},{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigSandboxNetworkAccess1"}],"title":"CreateVoiceAgentDraftRequestConfigSandboxNetworkAccess"},"CreateVoiceAgentDraftRequestConfigSandboxPersistence":{"type":"string","enum":["ephemeral","conversation","named"],"description":"Supported: ephemeral or conversation. Named remains parseable for stored configs but cannot be enabled.","title":"CreateVoiceAgentDraftRequestConfigSandboxPersistence"},"CreateVoiceAgentDraftRequestConfigSandboxProvider":{"type":"string","enum":["runtype-sandbox","daytona"],"description":"Only runtype-sandbox is currently supported. Daytona is retained for stored-config parsing but rejected at authoring/execution.","title":"CreateVoiceAgentDraftRequestConfigSandboxProvider"},"CreateVoiceAgentDraftRequestConfigSandboxSleepAfter":{"type":"string","enum":["5m","15m","30m","1h"],"title":"CreateVoiceAgentDraftRequestConfigSandboxSleepAfter"},"CreateVoiceAgentDraftRequestConfigSandboxTtl":{"type":"string","enum":["5m","1h","24h","unlimited"],"title":"CreateVoiceAgentDraftRequestConfigSandboxTtl"},"CreateVoiceAgentDraftRequestConfigSandbox":{"type":"object","properties":{"codingAgents":{"type":"array","items":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigSandboxCodingAgentsItems"},"description":"Coding agents the Sandbox can run as typed sessions. Non-empty adds the agent_session_* tools; empty or absent adds none."},"enabled":{"type":"boolean"},"instanceType":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigSandboxInstanceType","description":"Only standard-4 is supported on the hosted Agent Sandbox path; other sizes cannot be enabled."},"networkAccess":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigSandboxNetworkAccess"},"persistence":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigSandboxPersistence","description":"Supported: ephemeral or conversation. Named remains parseable for stored configs but cannot be enabled."},"provider":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigSandboxProvider","description":"Only runtype-sandbox is currently supported. Daytona is retained for stored-config parsing but rejected at authoring/execution."},"secretEnv":{"type":"object","additionalProperties":{"type":"string","minLength":1}},"setupCommands":{"type":"array","items":{"type":"string","minLength":1}},"sleepAfter":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigSandboxSleepAfter"},"ttl":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigSandboxTtl"}},"required":["enabled"],"title":"CreateVoiceAgentDraftRequestConfigSandbox"},"CreateVoiceAgentDraftRequestConfigStateMergeStrategy":{"type":"string","enum":["replace","merge"],"default":"merge","title":"CreateVoiceAgentDraftRequestConfigStateMergeStrategy"},"CreateVoiceAgentDraftRequestConfigStatePredictStateItems":{"type":"object","properties":{"stateKey":{"type":"string","minLength":1},"tool":{"type":"string","minLength":1},"toolArgument":{"type":"string","minLength":1}},"required":["stateKey","tool","toolArgument"],"title":"CreateVoiceAgentDraftRequestConfigStatePredictStateItems"},"CreateVoiceAgentDraftRequestConfigState":{"type":"object","properties":{"initial":{"type":"object","additionalProperties":{"description":"Any type"}},"mergeStrategy":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigStateMergeStrategy","default":"merge"},"predictState":{"type":"array","items":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigStatePredictStateItems"}},"schema":{"type":"object","additionalProperties":{"description":"Any type"}}},"title":"CreateVoiceAgentDraftRequestConfigState"},"CreateVoiceAgentDraftRequestConfigTemporal":{"type":"object","properties":{"elapsedThresholdSeconds":{"type":"integer","minimum":0},"groundNow":{"type":"boolean"},"injectElapsed":{"type":"boolean"},"timezone":{"type":"string"}},"title":"CreateVoiceAgentDraftRequestConfigTemporal"},"CreateVoiceAgentDraftRequestConfigTenancyStrategyAssuranceFloorEndUser":{"type":"string","enum":["asserted","verified"],"title":"CreateVoiceAgentDraftRequestConfigTenancyStrategyAssuranceFloorEndUser"},"CreateVoiceAgentDraftRequestConfigTenancyStrategyAssuranceFloorTenant":{"type":"string","enum":["asserted","verified"],"title":"CreateVoiceAgentDraftRequestConfigTenancyStrategyAssuranceFloorTenant"},"CreateVoiceAgentDraftRequestConfigTenancyStrategyAssuranceFloor":{"type":"object","properties":{"endUser":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigTenancyStrategyAssuranceFloorEndUser"},"tenant":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigTenancyStrategyAssuranceFloorTenant"}},"title":"CreateVoiceAgentDraftRequestConfigTenancyStrategyAssuranceFloor"},"CreateVoiceAgentDraftRequestConfigTenancyStrategyPreset":{"type":"string","enum":["internal","tenant-isolated","end-user-isolated"],"title":"CreateVoiceAgentDraftRequestConfigTenancyStrategyPreset"},"CreateVoiceAgentDraftRequestConfigTenancyStrategy":{"type":"object","properties":{"assuranceFloor":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigTenancyStrategyAssuranceFloor"},"preset":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigTenancyStrategyPreset"}},"required":["preset"],"title":"CreateVoiceAgentDraftRequestConfigTenancyStrategy"},"CreateVoiceAgentDraftRequestConfigToolsApprovalApprover":{"type":"string","enum":["owner","end-user"],"title":"CreateVoiceAgentDraftRequestConfigToolsApprovalApprover"},"CreateVoiceAgentDraftRequestConfigToolsApprovalChoices":{"type":"object","properties":{"alwaysAllow":{"type":"boolean"},"alwaysDeny":{"type":"boolean"}},"title":"CreateVoiceAgentDraftRequestConfigToolsApprovalChoices"},"CreateVoiceAgentDraftRequestConfigToolsApprovalRequire":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"boolean"}],"title":"CreateVoiceAgentDraftRequestConfigToolsApprovalRequire"},"CreateVoiceAgentDraftRequestConfigToolsApproval":{"type":"object","properties":{"approver":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigToolsApprovalApprover"},"choices":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigToolsApprovalChoices"},"notifyUser":{"type":"boolean"},"requestReason":{"type":"boolean"},"require":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigToolsApprovalRequire"},"timeout":{"type":"number","format":"double"}},"required":["require"],"title":"CreateVoiceAgentDraftRequestConfigToolsApproval"},"CreateVoiceAgentDraftRequestConfigToolsCodeModeConfig":{"type":"object","properties":{"description":{"type":"string"},"timeoutMs":{"type":"integer","minimum":1000,"maximum":600000},"toolPool":{"type":"array","items":{"type":"string"}}},"required":["toolPool"],"title":"CreateVoiceAgentDraftRequestConfigToolsCodeModeConfig"},"CreateVoiceAgentDraftRequestConfigToolsIntent":{"type":"string","enum":["mandatory","best-effort"],"title":"CreateVoiceAgentDraftRequestConfigToolsIntent"},"CreateVoiceAgentDraftRequestConfigToolsMcpServersItemsAuthType":{"type":"string","enum":["api_key","bearer","basic","custom_header","headers","none"],"title":"CreateVoiceAgentDraftRequestConfigToolsMcpServersItemsAuthType"},"CreateVoiceAgentDraftRequestConfigToolsMcpServersItemsAuth":{"type":"object","properties":{"headerName":{"type":"string"},"headers":{"type":"object","additionalProperties":{"type":"string"}},"password":{"type":"string"},"token":{"type":"string"},"type":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigToolsMcpServersItemsAuthType"},"username":{"type":"string"}},"required":["type"],"title":"CreateVoiceAgentDraftRequestConfigToolsMcpServersItemsAuth"},"CreateVoiceAgentDraftRequestConfigToolsMcpServersItemsTargetKind":{"type":"string","enum":["sandbox-deployment"],"title":"CreateVoiceAgentDraftRequestConfigToolsMcpServersItemsTargetKind"},"CreateVoiceAgentDraftRequestConfigToolsMcpServersItemsTarget":{"type":"object","properties":{"bearerSecretName":{"type":"string"},"deploymentId":{"type":"string","pattern":"^sbd_[0-9abcdefghjkmnpqrstvwxyz]{20,32}$"},"kind":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigToolsMcpServersItemsTargetKind"},"path":{"type":"string"}},"required":["deploymentId","kind"],"title":"CreateVoiceAgentDraftRequestConfigToolsMcpServersItemsTarget"},"CreateVoiceAgentDraftRequestConfigToolsMcpServersItemsTransport":{"type":"string","enum":["streamable_http","rest"],"title":"CreateVoiceAgentDraftRequestConfigToolsMcpServersItemsTransport"},"CreateVoiceAgentDraftRequestConfigToolsMcpServersItems":{"type":"object","properties":{"allowedTools":{"type":"array","items":{"type":"string"}},"auth":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigToolsMcpServersItemsAuth"},"enabled":{"type":"boolean"},"id":{"type":"string"},"identityAudiences":{"type":"array","items":{"type":"string"}},"name":{"type":"string"},"target":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigToolsMcpServersItemsTarget"},"timeout":{"type":"number","format":"double"},"transport":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigToolsMcpServersItemsTransport"},"url":{"type":"string"}},"required":["id"],"title":"CreateVoiceAgentDraftRequestConfigToolsMcpServersItems"},"CreateVoiceAgentDraftRequestConfigToolsPerToolLimits":{"type":"object","properties":{"maxCalls":{"type":"number","format":"double"},"required":{"type":"boolean"}},"title":"CreateVoiceAgentDraftRequestConfigToolsPerToolLimits"},"CreateVoiceAgentDraftRequestConfigToolsRuntimeToolsItemsToolType":{"type":"string","enum":["flow","custom","external","local","advisor","subagent","search"],"title":"CreateVoiceAgentDraftRequestConfigToolsRuntimeToolsItemsToolType"},"CreateVoiceAgentDraftRequestConfigToolsRuntimeToolsItems":{"type":"object","properties":{"config":{"type":"object","additionalProperties":{"description":"Any type"}},"description":{"type":"string"},"hiddenParameterNames":{"type":"array","items":{"type":"string","minLength":1}},"idempotent":{"type":"boolean"},"name":{"type":"string"},"parametersSchema":{"type":"object","additionalProperties":{"description":"Any type"}},"toolType":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigToolsRuntimeToolsItemsToolType"}},"required":["config","description","name","parametersSchema","toolType"],"title":"CreateVoiceAgentDraftRequestConfigToolsRuntimeToolsItems"},"CreateVoiceAgentDraftRequestConfigToolsSubagentConfigDefaultExecutionMode":{"type":"string","enum":["attached","detached"],"title":"CreateVoiceAgentDraftRequestConfigToolsSubagentConfigDefaultExecutionMode"},"CreateVoiceAgentDraftRequestConfigToolsSubagentConfigDefaultNotify":{"type":"string","enum":["none","narrate","react"],"title":"CreateVoiceAgentDraftRequestConfigToolsSubagentConfigDefaultNotify"},"CreateVoiceAgentDraftRequestConfigToolsSubagentConfigExecutionModesItems":{"type":"string","enum":["attached","detached"],"title":"CreateVoiceAgentDraftRequestConfigToolsSubagentConfigExecutionModesItems"},"CreateVoiceAgentDraftRequestConfigToolsSubagentConfig":{"type":"object","properties":{"allowNesting":{"type":"boolean"},"defaultExecutionMode":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigToolsSubagentConfigDefaultExecutionMode"},"defaultMaxTurns":{"type":"integer","minimum":1,"maximum":100},"defaultModel":{"type":"string"},"defaultNotify":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigToolsSubagentConfigDefaultNotify"},"defaultTimeoutMs":{"type":"integer","minimum":1000,"maximum":600000},"detachedMaxBudgetMs":{"type":"integer","minimum":1000,"maximum":86400000},"detachedNoProgressBudgetMs":{"type":"integer","minimum":1000,"maximum":86400000},"executionModes":{"type":"array","items":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigToolsSubagentConfigExecutionModesItems"}},"maxSpawnsPerRun":{"type":"integer","minimum":1,"maximum":50},"maxTurnsLimit":{"type":"integer","minimum":1,"maximum":100},"toolPool":{"type":"array","items":{"type":"string"}}},"required":["toolPool"],"title":"CreateVoiceAgentDraftRequestConfigToolsSubagentConfig"},"CreateVoiceAgentDraftRequestConfigToolsToolCallStrategy":{"type":"string","enum":["auto","required","none"],"title":"CreateVoiceAgentDraftRequestConfigToolsToolCallStrategy"},"CreateVoiceAgentDraftRequestConfigToolsToolSearch":{"type":"object","properties":{"alwaysLoaded":{"type":"array","items":{"type":"string"}},"enabled":{"type":"boolean"},"threshold":{"type":"number","format":"double"}},"title":"CreateVoiceAgentDraftRequestConfigToolsToolSearch"},"CreateVoiceAgentDraftRequestConfigTools":{"type":"object","properties":{"approval":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigToolsApproval"},"codeModeConfig":{"oneOf":[{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigToolsCodeModeConfig"},{"type":"null"}]},"intent":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigToolsIntent"},"maxToolCalls":{"type":"integer","minimum":1,"maximum":100},"mcpServers":{"type":"array","items":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigToolsMcpServersItems"}},"perToolLimits":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigToolsPerToolLimits"}},"runtimeTools":{"type":"array","items":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigToolsRuntimeToolsItems"}},"subagentConfig":{"oneOf":[{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigToolsSubagentConfig"},{"type":"null"}]},"toolCallStrategy":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigToolsToolCallStrategy"},"toolConfigs":{"type":"object","additionalProperties":{"type":"object","additionalProperties":{"description":"Any type"}}},"toolIds":{"type":"array","items":{"type":"string"}},"toolSearch":{"oneOf":[{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigToolsToolSearch"},{"type":"null"}]}},"title":"CreateVoiceAgentDraftRequestConfigTools"},"CreateVoiceAgentDraftRequestConfigVoiceDirectTools":{"type":"object","properties":{"enabled":{"type":"boolean"},"model":{"type":"string","minLength":1}},"title":"CreateVoiceAgentDraftRequestConfigVoiceDirectTools"},"CreateVoiceAgentDraftRequestConfigVoiceElevenLabs":{"type":"object","properties":{"modelId":{"type":"string","minLength":1},"similarity":{"type":"number","format":"double","minimum":0,"maximum":1},"stability":{"type":"number","format":"double","minimum":0,"maximum":1},"voiceId":{"type":"string","minLength":1}},"title":"CreateVoiceAgentDraftRequestConfigVoiceElevenLabs"},"CreateVoiceAgentDraftRequestConfigVoiceEndpointingStrategy":{"type":"string","enum":["provider_vad","server_vad","client_commit","manual"],"title":"CreateVoiceAgentDraftRequestConfigVoiceEndpointingStrategy"},"CreateVoiceAgentDraftRequestConfigVoiceEndpointing":{"type":"object","properties":{"silenceMs":{"type":"integer","minimum":0,"maximum":30000},"strategy":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigVoiceEndpointingStrategy"}},"required":["strategy"],"title":"CreateVoiceAgentDraftRequestConfigVoiceEndpointing"},"CreateVoiceAgentDraftRequestConfigVoiceInterruptionMode":{"type":"string","enum":["none","cancel","barge-in"],"title":"CreateVoiceAgentDraftRequestConfigVoiceInterruptionMode"},"CreateVoiceAgentDraftRequestConfigVoiceSpeechMode":{"type":"string","enum":["pipeline","speech_to_speech","provider_managed"],"title":"CreateVoiceAgentDraftRequestConfigVoiceSpeechMode"},"CreateVoiceAgentDraftRequestConfigVoiceSpeechSynthesizerSettings":{"type":"object","properties":{"similarity":{"type":"number","format":"double","minimum":0,"maximum":1},"stability":{"type":"number","format":"double","minimum":0,"maximum":1}},"title":"CreateVoiceAgentDraftRequestConfigVoiceSpeechSynthesizerSettings"},"CreateVoiceAgentDraftRequestConfigVoiceSpeechSynthesizer":{"type":"object","properties":{"model":{"type":"string","minLength":1},"provider":{"type":"string","minLength":1},"settings":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigVoiceSpeechSynthesizerSettings"},"voiceId":{"type":"string","minLength":1}},"required":["provider"],"title":"CreateVoiceAgentDraftRequestConfigVoiceSpeechSynthesizer"},"CreateVoiceAgentDraftRequestConfigVoiceSpeechTranscriber":{"type":"object","properties":{"model":{"type":"string","minLength":1},"provider":{"type":"string","minLength":1}},"required":["provider"],"title":"CreateVoiceAgentDraftRequestConfigVoiceSpeechTranscriber"},"CreateVoiceAgentDraftRequestConfigVoiceSpeech":{"type":"object","properties":{"mode":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigVoiceSpeechMode"},"synthesizer":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigVoiceSpeechSynthesizer"},"transcriber":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigVoiceSpeechTranscriber"}},"required":["mode","synthesizer","transcriber"],"title":"CreateVoiceAgentDraftRequestConfigVoiceSpeech"},"CreateVoiceAgentDraftRequestConfigVoice":{"type":"object","properties":{"directTools":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigVoiceDirectTools"},"disclosure":{"type":"boolean"},"elevenLabs":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigVoiceElevenLabs"},"enabled":{"type":"boolean"},"endpointing":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigVoiceEndpointing"},"greeting":{"type":"string","maxLength":2000},"interruptionMode":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigVoiceInterruptionMode"},"language":{"type":"string","minLength":1,"maxLength":64},"provider":{"type":"string","minLength":1},"speech":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigVoiceSpeech"}},"title":"CreateVoiceAgentDraftRequestConfigVoice"},"CreateVoiceAgentDraftRequestConfig":{"type":"object","properties":{"advisor":{"oneOf":[{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigAdvisor"},{"type":"null"}]},"artifacts":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigArtifacts"},"busyMessageRouting":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigBusyMessageRouting"},"contextManagement":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigContextManagement"},"durability":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigDurability"},"errorHandling":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigErrorHandling"},"frequencyPenalty":{"type":"number","format":"double","minimum":-2,"maximum":2},"loggingPolicy":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigLoggingPolicy"},"loopConfig":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigLoopConfig"},"maxTokens":{"type":["integer","null"],"minimum":1},"memory":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigMemory"},"model":{"type":"string"},"output":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigOutput"},"piiRedaction":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigPiiRedaction"},"presencePenalty":{"type":"number","format":"double","minimum":-2,"maximum":2},"reasoning":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigReasoning"},"sandbox":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigSandbox"},"seed":{"type":"integer"},"state":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigState"},"systemPrompt":{"type":"string"},"temperature":{"type":"number","format":"double","minimum":0,"maximum":2},"temporal":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigTemporal"},"tenancyStrategy":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigTenancyStrategy"},"tools":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigTools"},"topK":{"type":"integer","minimum":1,"maximum":500},"topP":{"type":"number","format":"double","minimum":0,"maximum":1},"voice":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfigVoice"}},"title":"CreateVoiceAgentDraftRequestConfig"},"CreateVoiceAgentDraftRequest":{"type":"object","properties":{"config":{"$ref":"#/components/schemas/CreateVoiceAgentDraftRequestConfig"},"description":{"type":"string"},"name":{"type":"string","minLength":1}},"title":"CreateVoiceAgentDraftRequest"},"CreateVoiceAgentDraftResponse":{"type":"object","properties":{"draftId":{"type":"string","description":"Pass as the `agentDraftId` query parameter when opening `/ws/agents/{id}/voice` to run this draft."},"expiresAt":{"type":"string","description":"After this time the draft can no longer start a call. A call already running keeps it."}},"required":["draftId","expiresAt"],"title":"CreateVoiceAgentDraftResponse"},"V1AnalyticsEndUserConversationsGetParametersPeriod":{"type":"string","enum":["billing_period","7d","30d","90d"],"title":"V1AnalyticsEndUserConversationsGetParametersPeriod"},"V1AnalyticsEndUserConversationsGetParametersSort":{"type":"string","enum":["conversations","messages"],"default":"conversations","title":"V1AnalyticsEndUserConversationsGetParametersSort"},"V1AnalyticsEndUserConversationsGetResponsesContentApplicationJsonSchemaAttributed":{"type":"object","properties":{"conversations":{"type":"integer","minimum":0},"endUsers":{"type":"integer","minimum":0},"messages":{"type":"integer","minimum":0}},"required":["conversations","endUsers","messages"],"title":"V1AnalyticsEndUserConversationsGetResponsesContentApplicationJsonSchemaAttributed"},"V1AnalyticsEndUserConversationsGetResponsesContentApplicationJsonSchemaEndUsersItemsEndUser":{"type":"object","properties":{"email":{"type":["string","null"]},"externalId":{"type":"string"},"id":{"type":"string"},"name":{"type":["string","null"]},"productTenantId":{"type":["string","null"]}},"required":["email","externalId","id","name","productTenantId"],"title":"V1AnalyticsEndUserConversationsGetResponsesContentApplicationJsonSchemaEndUsersItemsEndUser"},"V1AnalyticsEndUserConversationsGetResponsesContentApplicationJsonSchemaEndUsersItems":{"type":"object","properties":{"conversations":{"type":"integer","minimum":0},"endUser":{"$ref":"#/components/schemas/V1AnalyticsEndUserConversationsGetResponsesContentApplicationJsonSchemaEndUsersItemsEndUser"},"firstConversationAt":{"type":"string"},"lastConversationAt":{"type":"string"},"messages":{"type":"integer","minimum":0}},"required":["conversations","endUser","firstConversationAt","lastConversationAt","messages"],"title":"V1AnalyticsEndUserConversationsGetResponsesContentApplicationJsonSchemaEndUsersItems"},"V1AnalyticsEndUserConversationsGetResponsesContentApplicationJsonSchemaPeriodPreset":{"type":"string","enum":["billing_period","7d","30d","90d"],"title":"V1AnalyticsEndUserConversationsGetResponsesContentApplicationJsonSchemaPeriodPreset"},"V1AnalyticsEndUserConversationsGetResponsesContentApplicationJsonSchemaPeriod":{"type":"object","properties":{"days":{"type":"integer","exclusiveMinimum":0},"endDate":{"type":"string"},"preset":{"$ref":"#/components/schemas/V1AnalyticsEndUserConversationsGetResponsesContentApplicationJsonSchemaPeriodPreset"},"startDate":{"type":"string"}},"required":["days","endDate","startDate"],"title":"V1AnalyticsEndUserConversationsGetResponsesContentApplicationJsonSchemaPeriod"},"V1AnalyticsEndUserConversationsGetResponsesContentApplicationJsonSchemaScope":{"type":"object","properties":{"productId":{"type":"string"},"productTenantId":{"type":["string","null"]}},"required":["productId","productTenantId"],"title":"V1AnalyticsEndUserConversationsGetResponsesContentApplicationJsonSchemaScope"},"V1AnalyticsEndUserConversationsGetResponsesContentApplicationJsonSchemaTotals":{"type":"object","properties":{"conversations":{"type":"integer","minimum":0},"messages":{"type":"integer","minimum":0}},"required":["conversations","messages"],"title":"V1AnalyticsEndUserConversationsGetResponsesContentApplicationJsonSchemaTotals"},"V1AnalyticsEndUserConversationsGetResponsesContentApplicationJsonSchemaUnattributed":{"type":"object","properties":{"conversations":{"type":"integer","minimum":0},"messages":{"type":"integer","minimum":0}},"required":["conversations","messages"],"title":"V1AnalyticsEndUserConversationsGetResponsesContentApplicationJsonSchemaUnattributed"},"Analytics_getProductConversationsByEndUser_Response_200":{"type":"object","properties":{"attributed":{"$ref":"#/components/schemas/V1AnalyticsEndUserConversationsGetResponsesContentApplicationJsonSchemaAttributed"},"endUsers":{"type":"array","items":{"$ref":"#/components/schemas/V1AnalyticsEndUserConversationsGetResponsesContentApplicationJsonSchemaEndUsersItems"}},"generatedAt":{"type":"string"},"period":{"$ref":"#/components/schemas/V1AnalyticsEndUserConversationsGetResponsesContentApplicationJsonSchemaPeriod"},"scope":{"$ref":"#/components/schemas/V1AnalyticsEndUserConversationsGetResponsesContentApplicationJsonSchemaScope"},"totals":{"$ref":"#/components/schemas/V1AnalyticsEndUserConversationsGetResponsesContentApplicationJsonSchemaTotals"},"unattributed":{"$ref":"#/components/schemas/V1AnalyticsEndUserConversationsGetResponsesContentApplicationJsonSchemaUnattributed"}},"required":["attributed","endUsers","generatedAt","period","scope","totals","unattributed"],"title":"Analytics_getProductConversationsByEndUser_Response_200"},"V1AnalyticsEndUserUsageGetParametersPeriod":{"type":"string","enum":["billing_period","7d","30d","90d"],"title":"V1AnalyticsEndUserUsageGetParametersPeriod"},"V1AnalyticsEndUserUsageGetParametersSort":{"type":"string","enum":["spend","executions"],"default":"spend","title":"V1AnalyticsEndUserUsageGetParametersSort"},"V1AnalyticsEndUserUsageGetResponsesContentApplicationJsonSchemaCoverage":{"type":"object","properties":{"attributedExecutions":{"type":"integer","minimum":0},"attributedSpendThousandthsCent":{"type":"integer","minimum":0},"unattributedExecutions":{"type":"integer","minimum":0},"unattributedSpendThousandthsCent":{"type":"integer","minimum":0}},"required":["attributedExecutions","attributedSpendThousandthsCent","unattributedExecutions","unattributedSpendThousandthsCent"],"title":"V1AnalyticsEndUserUsageGetResponsesContentApplicationJsonSchemaCoverage"},"V1AnalyticsEndUserUsageGetResponsesContentApplicationJsonSchemaEndUsersItemsEndUser":{"type":"object","properties":{"email":{"type":["string","null"]},"id":{"type":"string"},"name":{"type":["string","null"]},"productTenantId":{"type":["string","null"]}},"required":["email","id","name","productTenantId"],"title":"V1AnalyticsEndUserUsageGetResponsesContentApplicationJsonSchemaEndUsersItemsEndUser"},"V1AnalyticsEndUserUsageGetResponsesContentApplicationJsonSchemaEndUsersItems":{"type":"object","properties":{"costPerExecutionDollars":{"type":["number","null"],"format":"double","minimum":0},"endUser":{"$ref":"#/components/schemas/V1AnalyticsEndUserUsageGetResponsesContentApplicationJsonSchemaEndUsersItemsEndUser"},"executions":{"type":"integer","minimum":0},"lastSeenAt":{"type":"string"},"spendDollars":{"type":"number","format":"double","minimum":0},"spendThousandthsCent":{"type":"integer","minimum":0}},"required":["costPerExecutionDollars","endUser","executions","lastSeenAt","spendDollars","spendThousandthsCent"],"title":"V1AnalyticsEndUserUsageGetResponsesContentApplicationJsonSchemaEndUsersItems"},"V1AnalyticsEndUserUsageGetResponsesContentApplicationJsonSchemaPeriodPreset":{"type":"string","enum":["billing_period","7d","30d","90d"],"title":"V1AnalyticsEndUserUsageGetResponsesContentApplicationJsonSchemaPeriodPreset"},"V1AnalyticsEndUserUsageGetResponsesContentApplicationJsonSchemaPeriod":{"type":"object","properties":{"days":{"type":"integer","exclusiveMinimum":0},"endDate":{"type":"string"},"preset":{"$ref":"#/components/schemas/V1AnalyticsEndUserUsageGetResponsesContentApplicationJsonSchemaPeriodPreset"},"startDate":{"type":"string"}},"required":["days","endDate","startDate"],"title":"V1AnalyticsEndUserUsageGetResponsesContentApplicationJsonSchemaPeriod"},"V1AnalyticsEndUserUsageGetResponsesContentApplicationJsonSchemaRetentionRetentionDays":{"type":"string","enum":["93"],"title":"V1AnalyticsEndUserUsageGetResponsesContentApplicationJsonSchemaRetentionRetentionDays"},"V1AnalyticsEndUserUsageGetResponsesContentApplicationJsonSchemaRetention":{"type":"object","properties":{"attributionStartedAt":{"type":["string","null"]},"earliestAvailableAt":{"type":["string","null"]},"retentionDays":{"$ref":"#/components/schemas/V1AnalyticsEndUserUsageGetResponsesContentApplicationJsonSchemaRetentionRetentionDays"}},"required":["attributionStartedAt","earliestAvailableAt","retentionDays"],"title":"V1AnalyticsEndUserUsageGetResponsesContentApplicationJsonSchemaRetention"},"V1AnalyticsEndUserUsageGetResponsesContentApplicationJsonSchemaScope":{"type":"object","properties":{"productId":{"type":"string"},"productTenantId":{"type":["string","null"]}},"required":["productId","productTenantId"],"title":"V1AnalyticsEndUserUsageGetResponsesContentApplicationJsonSchemaScope"},"V1AnalyticsEndUserUsageGetResponsesContentApplicationJsonSchemaTotals":{"type":"object","properties":{"executions":{"type":"integer","minimum":0},"spendDollars":{"type":"number","format":"double","minimum":0},"spendThousandthsCent":{"type":"integer","minimum":0}},"required":["executions","spendDollars","spendThousandthsCent"],"title":"V1AnalyticsEndUserUsageGetResponsesContentApplicationJsonSchemaTotals"},"V1AnalyticsEndUserUsageGetResponsesContentApplicationJsonSchemaUnattributed":{"type":"object","properties":{"executions":{"type":"integer","minimum":0},"spendDollars":{"type":"number","format":"double","minimum":0},"spendThousandthsCent":{"type":"integer","minimum":0}},"required":["executions","spendDollars","spendThousandthsCent"],"title":"V1AnalyticsEndUserUsageGetResponsesContentApplicationJsonSchemaUnattributed"},"Analytics_getProductUsageByEndUser_Response_200":{"type":"object","properties":{"coverage":{"$ref":"#/components/schemas/V1AnalyticsEndUserUsageGetResponsesContentApplicationJsonSchemaCoverage"},"endUsers":{"type":"array","items":{"$ref":"#/components/schemas/V1AnalyticsEndUserUsageGetResponsesContentApplicationJsonSchemaEndUsersItems"}},"generatedAt":{"type":"string"},"period":{"$ref":"#/components/schemas/V1AnalyticsEndUserUsageGetResponsesContentApplicationJsonSchemaPeriod"},"retention":{"$ref":"#/components/schemas/V1AnalyticsEndUserUsageGetResponsesContentApplicationJsonSchemaRetention"},"scope":{"$ref":"#/components/schemas/V1AnalyticsEndUserUsageGetResponsesContentApplicationJsonSchemaScope"},"tenantIds":{"type":"array","items":{"type":"string"}},"totals":{"$ref":"#/components/schemas/V1AnalyticsEndUserUsageGetResponsesContentApplicationJsonSchemaTotals"},"unattributed":{"$ref":"#/components/schemas/V1AnalyticsEndUserUsageGetResponsesContentApplicationJsonSchemaUnattributed"}},"required":["coverage","endUsers","generatedAt","period","retention","scope","tenantIds","totals","unattributed"],"title":"Analytics_getProductUsageByEndUser_Response_200"},"V1AnalyticsRecordResultsGetResponsesContentApplicationJsonSchemaOneOf0DailyExecutionsItemsFailedExecutions":{"oneOf":[{"type":"number","format":"double"},{"type":"string"}],"title":"V1AnalyticsRecordResultsGetResponsesContentApplicationJsonSchemaOneOf0DailyExecutionsItemsFailedExecutions"},"V1AnalyticsRecordResultsGetResponsesContentApplicationJsonSchemaOneOf0DailyExecutionsItemsFlowsFailure":{"oneOf":[{"type":"number","format":"double"},{"type":"string"}],"title":"V1AnalyticsRecordResultsGetResponsesContentApplicationJsonSchemaOneOf0DailyExecutionsItemsFlowsFailure"},"V1AnalyticsRecordResultsGetResponsesContentApplicationJsonSchemaOneOf0DailyExecutionsItemsFlowsSuccess":{"oneOf":[{"type":"number","format":"double"},{"type":"string"}],"title":"V1AnalyticsRecordResultsGetResponsesContentApplicationJsonSchemaOneOf0DailyExecutionsItemsFlowsSuccess"},"V1AnalyticsRecordResultsGetResponsesContentApplicationJsonSchemaOneOf0DailyExecutionsItemsPromptsFailure":{"oneOf":[{"type":"number","format":"double"},{"type":"string"}],"title":"V1AnalyticsRecordResultsGetResponsesContentApplicationJsonSchemaOneOf0DailyExecutionsItemsPromptsFailure"},"V1AnalyticsRecordResultsGetResponsesContentApplicationJsonSchemaOneOf0DailyExecutionsItemsPromptsSuccess":{"oneOf":[{"type":"number","format":"double"},{"type":"string"}],"title":"V1AnalyticsRecordResultsGetResponsesContentApplicationJsonSchemaOneOf0DailyExecutionsItemsPromptsSuccess"},"V1AnalyticsRecordResultsGetResponsesContentApplicationJsonSchemaOneOf0DailyExecutionsItemsSuccessfulExecutions":{"oneOf":[{"type":"number","format":"double"},{"type":"string"}],"title":"V1AnalyticsRecordResultsGetResponsesContentApplicationJsonSchemaOneOf0DailyExecutionsItemsSuccessfulExecutions"},"V1AnalyticsRecordResultsGetResponsesContentApplicationJsonSchemaOneOf0DailyExecutionsItemsTotalExecutions":{"oneOf":[{"type":"number","format":"double"},{"type":"string"}],"title":"V1AnalyticsRecordResultsGetResponsesContentApplicationJsonSchemaOneOf0DailyExecutionsItemsTotalExecutions"},"V1AnalyticsRecordResultsGetResponsesContentApplicationJsonSchemaOneOf0DailyExecutionsItems":{"type":"object","properties":{"date":{"type":"string"},"failedExecutions":{"$ref":"#/components/schemas/V1AnalyticsRecordResultsGetResponsesContentApplicationJsonSchemaOneOf0DailyExecutionsItemsFailedExecutions"},"flowsFailure":{"$ref":"#/components/schemas/V1AnalyticsRecordResultsGetResponsesContentApplicationJsonSchemaOneOf0DailyExecutionsItemsFlowsFailure"},"flowsSuccess":{"$ref":"#/components/schemas/V1AnalyticsRecordResultsGetResponsesContentApplicationJsonSchemaOneOf0DailyExecutionsItemsFlowsSuccess"},"promptsFailure":{"$ref":"#/components/schemas/V1AnalyticsRecordResultsGetResponsesContentApplicationJsonSchemaOneOf0DailyExecutionsItemsPromptsFailure"},"promptsSuccess":{"$ref":"#/components/schemas/V1AnalyticsRecordResultsGetResponsesContentApplicationJsonSchemaOneOf0DailyExecutionsItemsPromptsSuccess"},"successfulExecutions":{"$ref":"#/components/schemas/V1AnalyticsRecordResultsGetResponsesContentApplicationJsonSchemaOneOf0DailyExecutionsItemsSuccessfulExecutions"},"totalExecutions":{"$ref":"#/components/schemas/V1AnalyticsRecordResultsGetResponsesContentApplicationJsonSchemaOneOf0DailyExecutionsItemsTotalExecutions"}},"required":["date","failedExecutions","flowsFailure","flowsSuccess","promptsFailure","promptsSuccess","successfulExecutions","totalExecutions"],"title":"V1AnalyticsRecordResultsGetResponsesContentApplicationJsonSchemaOneOf0DailyExecutionsItems"},"V1AnalyticsRecordResultsGetResponsesContentApplicationJsonSchemaOneOf0Period":{"type":"object","properties":{"days":{"type":"integer"},"endDate":{"type":"string"},"startDate":{"type":"string"}},"required":["days","endDate","startDate"],"title":"V1AnalyticsRecordResultsGetResponsesContentApplicationJsonSchemaOneOf0Period"},"V1AnalyticsRecordResultsGetResponsesContentApplicationJsonSchemaOneOf0Summary":{"type":"object","properties":{"failedExecutions":{"type":"integer"},"flowExecutions":{"type":"integer"},"promptExecutions":{"type":"integer"},"successRate":{"type":"number","format":"double"},"successfulExecutions":{"type":"integer"},"totalExecutions":{"type":"integer"}},"required":["failedExecutions","flowExecutions","promptExecutions","successRate","successfulExecutions","totalExecutions"],"title":"V1AnalyticsRecordResultsGetResponsesContentApplicationJsonSchemaOneOf0Summary"},"AnalyticsGetRecordResultsResponse2000":{"type":"object","properties":{"dailyExecutions":{"type":"array","items":{"$ref":"#/components/schemas/V1AnalyticsRecordResultsGetResponsesContentApplicationJsonSchemaOneOf0DailyExecutionsItems"}},"period":{"$ref":"#/components/schemas/V1AnalyticsRecordResultsGetResponsesContentApplicationJsonSchemaOneOf0Period"},"summary":{"$ref":"#/components/schemas/V1AnalyticsRecordResultsGetResponsesContentApplicationJsonSchemaOneOf0Summary"}},"required":["dailyExecutions","period","summary"],"title":"AnalyticsGetRecordResultsResponse2000"},"V1AnalyticsRecordResultsGetResponsesContentApplicationJsonSchemaOneOf1DataPagination":{"type":"object","properties":{"hasNextPage":{"type":"boolean"},"hasPrevPage":{"type":"boolean"},"limit":{"type":"integer"},"nextCursor":{"type":["string","null"]},"page":{"type":"integer"},"total":{"type":"integer"},"totalPages":{"type":"integer"}},"required":["hasNextPage","hasPrevPage","limit","nextCursor","page","total","totalPages"],"title":"V1AnalyticsRecordResultsGetResponsesContentApplicationJsonSchemaOneOf1DataPagination"},"V1AnalyticsRecordResultsGetResponsesContentApplicationJsonSchemaOneOf1DataResultsItems":{"type":"object","properties":{"completionTokens":{"type":["integer","null"]},"createdAt":{"type":"string"},"estimatedCost":{"type":["string","null"],"description":"Deprecated alias for `modelCost`; identical value.","deprecated":true},"executionTimeMs":{"type":["integer","null"]},"flowId":{"type":["string","null"]},"flowName":{"type":["string","null"]},"id":{"type":"string"},"modelCost":{"type":["string","null"]},"modelUsed":{"type":["string","null"]},"promptId":{"type":["string","null"]},"promptName":{"type":["string","null"]},"promptResponseFormat":{"type":["string","null"]},"promptText":{"type":["string","null"]},"promptTokens":{"type":["integer","null"]},"recordId":{"type":"string"},"recordName":{"type":"string"},"recordType":{"type":"string"},"result":{"type":["string","null"]},"status":{"type":"string"},"toolCost":{"type":["string","null"],"description":"Built-in tool spend for this execution, as a decimal string. `null` means unknown, not zero: rows written before per-run cost was split into model and tool portions carry no tool figure. A run that genuinely used no billable tool records `\"0\"`. Sum with `modelCost` for the run total, and treat `null` as unknown rather than zero."},"totalTokens":{"type":["integer","null"]}},"required":["completionTokens","createdAt","estimatedCost","executionTimeMs","flowId","flowName","id","modelCost","modelUsed","promptId","promptName","promptResponseFormat","promptText","promptTokens","recordId","recordName","recordType","result","status","toolCost","totalTokens"],"title":"V1AnalyticsRecordResultsGetResponsesContentApplicationJsonSchemaOneOf1DataResultsItems"},"V1AnalyticsRecordResultsGetResponsesContentApplicationJsonSchemaOneOf1Data":{"type":"object","properties":{"pagination":{"$ref":"#/components/schemas/V1AnalyticsRecordResultsGetResponsesContentApplicationJsonSchemaOneOf1DataPagination"},"results":{"type":"array","items":{"$ref":"#/components/schemas/V1AnalyticsRecordResultsGetResponsesContentApplicationJsonSchemaOneOf1DataResultsItems"}}},"required":["pagination","results"],"title":"V1AnalyticsRecordResultsGetResponsesContentApplicationJsonSchemaOneOf1Data"},"AnalyticsGetRecordResultsResponse2001":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/V1AnalyticsRecordResultsGetResponsesContentApplicationJsonSchemaOneOf1Data"},"success":{"type":"boolean"}},"required":["data","success"],"title":"AnalyticsGetRecordResultsResponse2001"},"Analytics_getRecordResults_Response_200":{"oneOf":[{"$ref":"#/components/schemas/AnalyticsGetRecordResultsResponse2000"},{"$ref":"#/components/schemas/AnalyticsGetRecordResultsResponse2001"}],"title":"Analytics_getRecordResults_Response_200"},"V1AnalyticsStatsGetResponsesContentApplicationJsonSchemaData":{"type":"object","properties":{"totalAgents":{"type":"integer"},"totalEvals":{"type":"integer"},"totalExecutions":{"type":"integer"},"totalFlows":{"type":"integer"},"totalProducts":{"type":"integer"},"totalPrompts":{"type":"integer"},"totalRecords":{"type":"integer"}},"required":["totalAgents","totalEvals","totalExecutions","totalFlows","totalProducts","totalPrompts","totalRecords"],"title":"V1AnalyticsStatsGetResponsesContentApplicationJsonSchemaData"},"V1AnalyticsStatsGetResponsesContentApplicationJsonSchemaFilters":{"type":"object","properties":{"from":{"type":["string","null"]},"to":{"type":["string","null"]}},"required":["from","to"],"title":"V1AnalyticsStatsGetResponsesContentApplicationJsonSchemaFilters"},"Analytics_getAnalyticsStats_Response_200":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/V1AnalyticsStatsGetResponsesContentApplicationJsonSchemaData"},"filters":{"$ref":"#/components/schemas/V1AnalyticsStatsGetResponsesContentApplicationJsonSchemaFilters"},"generatedAt":{"type":"string"}},"required":["data","filters","generatedAt"],"title":"Analytics_getAnalyticsStats_Response_200"},"V1AssetsPostRequestBodyContentApplicationJsonSchemaOneOf0Visibility":{"type":"string","enum":["public","private"],"title":"V1AssetsPostRequestBodyContentApplicationJsonSchemaOneOf0Visibility"},"AssetsStoreAnAssetRequest0":{"type":"object","properties":{"content":{"type":"string","minLength":1},"contentType":{"type":"string","minLength":1},"executionId":{"type":"string","minLength":1},"filename":{"type":"string","minLength":1},"flowId":{"type":"string","minLength":1},"visibility":{"$ref":"#/components/schemas/V1AssetsPostRequestBodyContentApplicationJsonSchemaOneOf0Visibility"}},"required":["content"],"title":"AssetsStoreAnAssetRequest0"},"V1AssetsPostRequestBodyContentApplicationJsonSchemaOneOf1Visibility":{"type":"string","enum":["public","private"],"title":"V1AssetsPostRequestBodyContentApplicationJsonSchemaOneOf1Visibility"},"AssetsStoreAnAssetRequest1":{"type":"object","properties":{"contentType":{"type":"string","minLength":1},"executionId":{"type":"string","minLength":1},"filename":{"type":"string","minLength":1},"flowId":{"type":"string","minLength":1},"url":{"type":"string","minLength":1},"visibility":{"$ref":"#/components/schemas/V1AssetsPostRequestBodyContentApplicationJsonSchemaOneOf1Visibility"}},"required":["url"],"title":"AssetsStoreAnAssetRequest1"},"Assets_storeAnAsset_Request":{"oneOf":[{"$ref":"#/components/schemas/AssetsStoreAnAssetRequest0"},{"$ref":"#/components/schemas/AssetsStoreAnAssetRequest1"}],"title":"Assets_storeAnAsset_Request"},"V1AssetsPostResponsesContentApplicationJsonSchemaVisibility":{"type":"string","enum":["public","private"],"title":"V1AssetsPostResponsesContentApplicationJsonSchemaVisibility"},"Assets_storeAnAsset_Response_200":{"type":"object","properties":{"assetId":{"type":"string"},"contentType":{"type":"string"},"expiresIn":{"type":"number","format":"double"},"originalUrl":{"type":"string"},"sizeBytes":{"type":"number","format":"double"},"url":{"type":"string"},"visibility":{"$ref":"#/components/schemas/V1AssetsPostResponsesContentApplicationJsonSchemaVisibility"}},"required":["assetId","contentType","sizeBytes","url","visibility"],"title":"Assets_storeAnAsset_Response_200"},"V1AssetsPostResponsesContentApplicationJsonSchemaCode":{"type":"string","enum":["invalid_request","storage_not_configured","store_failed"],"title":"V1AssetsPostResponsesContentApplicationJsonSchemaCode"},"StoreAnAssetRequestBadRequestError":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/V1AssetsPostResponsesContentApplicationJsonSchemaCode"},"error":{"type":"string"}},"required":["code","error"],"title":"StoreAnAssetRequestBadRequestError"},"StoreAnAssetRequestServiceUnavailableError":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/V1AssetsPostResponsesContentApplicationJsonSchemaCode"},"error":{"type":"string"}},"required":["code","error"],"title":"StoreAnAssetRequestServiceUnavailableError"},"V1AssetsAssetIdExtendPostResponsesContentApplicationJsonSchemaRendering":{"type":"string","enum":["preview"],"title":"V1AssetsAssetIdExtendPostResponsesContentApplicationJsonSchemaRendering"},"Assets_extendPreviewExpiry_Response_200":{"type":"object","properties":{"assetId":{"type":"string","description":"The asset ID that was extended."},"expiresAt":{"type":["string","null"],"description":"New expiration timestamp (ISO 8601). null = permanent (plan grants no-expiry previews)."},"expiresIn":{"type":["number","null"],"format":"double","description":"Seconds until the new expiration. null = permanent."},"rendering":{"$ref":"#/components/schemas/V1AssetsAssetIdExtendPostResponsesContentApplicationJsonSchemaRendering"},"url":{"type":"string","description":"The public URL of the asset (unchanged by extension)."}},"required":["assetId","expiresAt","expiresIn","rendering","url"],"title":"Assets_extendPreviewExpiry_Response_200"},"V1AuthMeGetResponsesContentApplicationJsonSchemaOnboardingIntent":{"type":"string","enum":["build_new","connect_existing","unstated"],"title":"V1AuthMeGetResponsesContentApplicationJsonSchemaOnboardingIntent"},"Authentication_getCurrentUserInfo_Response_200":{"type":"object","properties":{"hasOrganization":{"type":"boolean"},"onboardingIntent":{"$ref":"#/components/schemas/V1AuthMeGetResponsesContentApplicationJsonSchemaOnboardingIntent"},"orgId":{"type":["string","null"]},"orgRole":{"type":["string","null"]},"orgSlug":{"type":["string","null"]},"sessionId":{"type":["string","null"]},"userId":{"type":"string"},"workspaceOrganizationId":{"type":["string","null"]}},"required":["hasOrganization","onboardingIntent","userId","workspaceOrganizationId"],"title":"Authentication_getCurrentUserInfo_Response_200"},"Authentication_provisionTheCallerWorkspaceOrganization_Response_200":{"type":"object","properties":{"created":{"type":"boolean"},"organizationId":{"type":"string"}},"required":["created","organizationId"],"title":"Authentication_provisionTheCallerWorkspaceOrganization_Response_200"},"V1AuthMeWorkspacePostResponsesContentApplicationJsonSchemaCode":{"type":"string","enum":["WORKSPACE_MODEL_DISABLED"],"title":"V1AuthMeWorkspacePostResponsesContentApplicationJsonSchemaCode"},"ProvisionTheCallerWorkspaceOrganizationRequestForbiddenError":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/V1AuthMeWorkspacePostResponsesContentApplicationJsonSchemaCode"},"error":{"type":"string"}},"required":["error"],"title":"ProvisionTheCallerWorkspaceOrganizationRequestForbiddenError"},"Batch_cancelABatchExecution_Response_200":{"type":"object","properties":{"message":{"type":"string"},"success":{"type":"boolean"}},"required":["message","success"],"title":"Batch_cancelABatchExecution_Response_200"},"BatchFlowDefinition":{"type":"object","properties":{"description":{"type":["string","null"]},"id":{"type":"string","description":"Saved-flow identity retained when the definition is a pinned snapshot."},"name":{"type":"string","minLength":1},"steps":{"type":"array","items":{"type":"object","additionalProperties":{"description":"Any type"}},"description":"Flow steps, in the same shape as a saved flow definition."}},"required":["name","steps"],"description":"Inline flow definition executed per record without saving the flow.","title":"BatchFlowDefinition"},"V1BatchFlowPostRequestBodyContentApplicationJsonSchemaMessagesItems":{"type":"object","properties":{"content":{"description":"Any type"},"role":{"type":"string","minLength":1}},"required":["role"],"title":"V1BatchFlowPostRequestBodyContentApplicationJsonSchemaMessagesItems"},"V1BatchFlowPostRequestBodyContentApplicationJsonSchemaOptions":{"type":"object","properties":{"chunkSize":{"type":"integer","minimum":1,"maximum":250,"description":"Records admitted to one processing chunk before progress is flushed and batch gates are re-checked."},"flowTimeoutMs":{"type":"integer","minimum":1000,"maximum":1800000,"description":"Flow-wide deadline passed to every per-record flow execution."},"maxRetries":{"type":"integer","minimum":0,"maximum":10,"description":"Retries per failed record."},"modelOverride":{"type":"string","minLength":1,"description":"Model id applied to every prompt step in this batch."},"progressFlushSize":{"type":"integer","minimum":1,"maximum":100,"description":"Deprecated and ignored. Completed results are now persisted per record as they finish, so no partial progress is held in memory and this threshold has no effect. Still accepted for backward compatibility."},"recordConcurrency":{"type":"integer","minimum":1,"maximum":150,"description":"Max records dispatched in parallel within a processing chunk."},"skipCacheWarm":{"type":"boolean","description":"Skip the serial prompt-cache canary before fan-out."},"stepTimeoutMs":{"type":"integer","minimum":1000,"maximum":1800000,"description":"Per-step deadline passed to every per-record flow execution."},"timeoutMs":{"type":"integer","minimum":1000,"maximum":1800000,"description":"Per-record execution timeout in milliseconds."}},"title":"V1BatchFlowPostRequestBodyContentApplicationJsonSchemaOptions"},"BatchInlineRecord":{"type":"object","properties":{"metadata":{"type":"object","additionalProperties":{"description":"Any type"},"description":"Arbitrary JSON payload exposed to the flow as {{_record.metadata.*}}. Any shape is accepted; nothing is written to the records table."},"name":{"type":"string","minLength":1,"description":"Display name for the record. Batch results and step results are keyed by this name, so keep it unique within one batch."},"type":{"type":"string","minLength":1,"description":"Record type label exposed to the flow as {{_record.type}}."}},"required":["metadata","name","type"],"description":"An ad-hoc record processed in place of a saved record. Inline records never touch the records table; each is minted a synthetic id for the lifetime of the batch.","title":"BatchInlineRecord"},"V1BatchFlowPostResponsesContentApplicationJsonSchemaStatus":{"type":"string","enum":["queued","processing","completed","failed","cancelled"],"title":"V1BatchFlowPostResponsesContentApplicationJsonSchemaStatus"},"Batch_submitABatchFlowExecution_Response_200":{"type":"object","properties":{"batchExecutionId":{"type":"string"},"status":{"$ref":"#/components/schemas/V1BatchFlowPostResponsesContentApplicationJsonSchemaStatus"}},"required":["batchExecutionId","status"],"title":"Batch_submitABatchFlowExecution_Response_200"},"BatchLaneRefusalErrorCode":{"type":"string","enum":["RUNTIME_LANE_INELIGIBLE"],"description":"The flow uses capabilities the batch host cannot run.","title":"BatchLaneRefusalErrorCode"},"BatchLaneRefusalErrorDetailsItems":{"type":"object","properties":{"code":{"type":"string","description":"Stable Runtype validation code (e.g. MISSING_REQUIRED_FIELD, INVALID_ENUM)."},"message":{"type":"string"},"path":{"type":"string","description":"Dotted JSON path to the offending field."},"suggestion":{"type":"string","description":"Actionable hint (allowed values, accepted range, …)."}},"required":["message"],"title":"BatchLaneRefusalErrorDetailsItems"},"BatchLaneRefusalError":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/BatchLaneRefusalErrorCode","description":"The flow uses capabilities the batch host cannot run."},"details":{"type":"array","items":{"$ref":"#/components/schemas/BatchLaneRefusalErrorDetailsItems"}},"error":{"type":"string"},"requiredScopes":{"type":"array","items":{"type":"string"},"description":"On `insufficient_scope`: every API key scope this request needs."},"reasons":{"type":"array","items":{"type":"string"},"description":"Stable reason codes: `ineligible:*` capabilities (e.g. `ineligible:wait-until`), or `eval-override:*` for an eval override the batch host cannot apply."}},"required":["code","error","reasons"],"title":"BatchLaneRefusalError"},"V1BatchStatusIdGetResponsesContentApplicationJsonSchemaExecutionEngineSummary":{"type":"string","enum":["runtime","legacy","mixed"],"description":"Run-level engine summary derived from the batch's per-record executionEngine values: 'runtime' or 'legacy' when every attributed record ran on that engine, 'mixed' when the batch spans both (e.g. a mid-flight fallback), and null when the run has no attributed records (runs recorded before attribution shipped).","title":"V1BatchStatusIdGetResponsesContentApplicationJsonSchemaExecutionEngineSummary"},"V1BatchStatusIdGetResponsesContentApplicationJsonSchemaStatus":{"type":"string","enum":["queued","processing","completed","failed","cancelled"],"title":"V1BatchStatusIdGetResponsesContentApplicationJsonSchemaStatus"},"Batch_getBatchExecutionStatus_Response_200":{"type":"object","properties":{"batchExecutionId":{"type":"string"},"completedAt":{"type":"string"},"executionEngineSummary":{"$ref":"#/components/schemas/V1BatchStatusIdGetResponsesContentApplicationJsonSchemaExecutionEngineSummary","description":"Run-level engine summary derived from the batch's per-record executionEngine values: 'runtime' or 'legacy' when every attributed record ran on that engine, 'mixed' when the batch spans both (e.g. a mid-flight fallback), and null when the run has no attributed records (runs recorded before attribution shipped)."},"failedRecords":{"type":"integer"},"flowId":{"type":"string"},"processedRecords":{"type":"integer"},"progress":{"type":"integer"},"results":{"type":"array","items":{"description":"Any type"}},"startedAt":{"type":"string"},"status":{"$ref":"#/components/schemas/V1BatchStatusIdGetResponsesContentApplicationJsonSchemaStatus"},"successCount":{"type":"integer"},"totalRecords":{"type":"integer"}},"required":["batchExecutionId","failedRecords","flowId","processedRecords","startedAt","status","totalRecords"],"title":"Batch_getBatchExecutionStatus_Response_200"},"V1BatchSummaryGetResponsesContentApplicationJsonSchemaBatchesItemsStartedAt":{"oneOf":[{"type":"string"},{"type":"string","format":"date-time"}],"title":"V1BatchSummaryGetResponsesContentApplicationJsonSchemaBatchesItemsStartedAt"},"V1BatchSummaryGetResponsesContentApplicationJsonSchemaBatchesItems":{"type":"object","properties":{"failedRecords":{"type":"integer"},"flowName":{"type":"string"},"id":{"type":"string"},"processedRecords":{"type":"integer"},"progress":{"type":"integer"},"startedAt":{"$ref":"#/components/schemas/V1BatchSummaryGetResponsesContentApplicationJsonSchemaBatchesItemsStartedAt"},"status":{"type":"string"},"totalRecords":{"type":"integer"}},"required":["failedRecords","flowName","id","processedRecords","progress","startedAt","status","totalRecords"],"title":"V1BatchSummaryGetResponsesContentApplicationJsonSchemaBatchesItems"},"V1BatchSummaryGetResponsesContentApplicationJsonSchemaRecentItemsStartedAt":{"oneOf":[{"type":"string"},{"type":"string","format":"date-time"}],"title":"V1BatchSummaryGetResponsesContentApplicationJsonSchemaRecentItemsStartedAt"},"V1BatchSummaryGetResponsesContentApplicationJsonSchemaRecentItems":{"type":"object","properties":{"failedRecords":{"type":"integer"},"flowName":{"type":"string"},"id":{"type":"string"},"processedRecords":{"type":"integer"},"progress":{"type":"integer"},"startedAt":{"$ref":"#/components/schemas/V1BatchSummaryGetResponsesContentApplicationJsonSchemaRecentItemsStartedAt"},"status":{"type":"string"},"totalRecords":{"type":"integer"}},"required":["failedRecords","flowName","id","processedRecords","progress","startedAt","status","totalRecords"],"title":"V1BatchSummaryGetResponsesContentApplicationJsonSchemaRecentItems"},"Batch_getBatchSummary_Response_200":{"type":"object","properties":{"activeBatches":{"type":"integer"},"batches":{"type":"array","items":{"$ref":"#/components/schemas/V1BatchSummaryGetResponsesContentApplicationJsonSchemaBatchesItems"}},"recent":{"type":"array","items":{"$ref":"#/components/schemas/V1BatchSummaryGetResponsesContentApplicationJsonSchemaRecentItems"}},"recentlyCompleted":{"type":"integer"}},"required":["activeBatches","batches","recent","recentlyCompleted"],"title":"Batch_getBatchSummary_Response_200"},"Batch_getPerRecordCostForABatch_Response_200":{"type":"object","properties":{"batchExecutionId":{"type":"string"},"billedCostThousandthsCent":{"type":["integer","null"],"description":"Exact raw Runtype-funded provider and hosted-tool cost before account margin, in thousandths of a cent ($1 = 100,000), or null when historical/unpriced rows make the split unavailable."},"billedCostUsd":{"type":["number","null"],"format":"double","description":"Dollar projection of billedCostThousandthsCent (raw Runtype-funded cost before account margin), or null when the exact split is unavailable."},"recordId":{"type":"string"},"selfReportedCostUsd":{"type":"number","format":"double","description":"Portion of totalCostUsd asserted by an externally-run agent pushed to /v1/executions/ingest. Unverified: Runtype neither dispatched nor paid for it. 0 unless external runs were ingested."},"totalCostUsd":{"type":"number","format":"double"},"unpricedExecutions":{"type":"integer","description":"Count of rows inside totalCostUsd that recorded no cost figure. Their contribution is 0 because the cost is unknown, not because it was free."}},"required":["batchExecutionId","billedCostThousandthsCent","billedCostUsd","recordId","selfReportedCostUsd","totalCostUsd","unpricedExecutions"],"title":"Batch_getPerRecordCostForABatch_Response_200"},"V1BatchBatchIdRecordsRecordIdStepsGetResponsesContentApplicationJsonSchemaDataItemsExecutionEngine":{"type":"string","enum":["runtime","legacy","external"],"description":"Engine that actually executed this step ('runtime' | 'legacy' | 'external'). Recorded at write time from the committed lane decision; never inferred later. 'external' marks a run a customer executed outside Runtype and reported through ingest. Null for rows written before attribution shipped and for units that never started executing.","title":"V1BatchBatchIdRecordsRecordIdStepsGetResponsesContentApplicationJsonSchemaDataItemsExecutionEngine"},"V1BatchBatchIdRecordsRecordIdStepsGetResponsesContentApplicationJsonSchemaDataItemsSourcesItems":{"type":"object","properties":{"title":{"type":"string"},"url":{"type":"string"}},"required":["url"],"title":"V1BatchBatchIdRecordsRecordIdStepsGetResponsesContentApplicationJsonSchemaDataItemsSourcesItems"},"V1BatchBatchIdRecordsRecordIdStepsGetResponsesContentApplicationJsonSchemaDataItems":{"type":"object","properties":{"batchExecutionId":{"type":["string","null"]},"cacheReadTokens":{"type":["integer","null"]},"cacheWriteTokens":{"type":["integer","null"]},"completedAt":{"type":["string","null"]},"completionTokens":{"type":["integer","null"]},"createdAt":{"type":"string"},"durationMs":{"type":["integer","null"]},"errorMessage":{"type":["string","null"]},"estimatedCost":{"type":["string","null"]},"executionEngine":{"$ref":"#/components/schemas/V1BatchBatchIdRecordsRecordIdStepsGetResponsesContentApplicationJsonSchemaDataItemsExecutionEngine","description":"Engine that actually executed this step ('runtime' | 'legacy' | 'external'). Recorded at write time from the committed lane decision; never inferred later. 'external' marks a run a customer executed outside Runtype and reported through ingest. Null for rows written before attribution shipped and for units that never started executing."},"executionSessionId":{"type":["string","null"]},"flowId":{"type":["string","null"]},"flowVersionId":{"type":["string","null"]},"id":{"type":"string"},"inputVariables":{"description":"Any type"},"modelUsed":{"type":["string","null"]},"order":{"type":["integer","null"]},"organizationId":{"type":["string","null"]},"outputPreview":{"type":["string","null"]},"promptTokens":{"type":["integer","null"]},"reasoningConfig":{"description":"Any type"},"reasoningRejection":{"description":"Any type"},"reasoningRequested":{"description":"Any type"},"reasoningTokens":{"type":["integer","null"]},"recordId":{"type":["string","null"]},"recordMetadata":{"description":"Any type"},"recordName":{"type":["string","null"]},"resolvedPrompt":{"type":["string","null"]},"retryCount":{"type":["integer","null"]},"sources":{"type":["array","null"],"items":{"$ref":"#/components/schemas/V1BatchBatchIdRecordsRecordIdStepsGetResponsesContentApplicationJsonSchemaDataItemsSourcesItems"}},"startedAt":{"type":["string","null"]},"status":{"type":"string"},"stepConfig":{"description":"Any type"},"stepId":{"type":["string","null"]},"stepName":{"type":"string"},"stepType":{"type":"string"},"totalTokens":{"type":["integer","null"]},"userId":{"type":"string"}},"required":["batchExecutionId","completedAt","createdAt","durationMs","executionSessionId","flowId","flowVersionId","id","order","organizationId","outputPreview","recordId","recordName","startedAt","status","stepId","stepName","stepType","userId"],"title":"V1BatchBatchIdRecordsRecordIdStepsGetResponsesContentApplicationJsonSchemaDataItems"},"Batch_getStepResultsForABatchRecord_Response_200":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1BatchBatchIdRecordsRecordIdStepsGetResponsesContentApplicationJsonSchemaDataItems"}}},"required":["data"],"title":"Batch_getStepResultsForABatchRecord_Response_200"},"Batch_getBatchExecutionTotalCost_Response_200":{"type":"object","properties":{"batchExecutionId":{"type":"string"},"billedCostThousandthsCent":{"type":["integer","null"],"description":"Exact raw Runtype-funded provider and hosted-tool cost before account margin, in thousandths of a cent ($1 = 100,000), or null when historical/unpriced rows make the split unavailable."},"billedCostUsd":{"type":["number","null"],"format":"double","description":"Dollar projection of billedCostThousandthsCent (raw Runtype-funded cost before account margin), or null when the exact split is unavailable."},"selfReportedCostUsd":{"type":"number","format":"double","description":"Portion of totalCostUsd asserted by an externally-run agent pushed to /v1/executions/ingest. Unverified: Runtype neither dispatched nor paid for it. 0 unless external runs were ingested."},"totalCostUsd":{"type":"number","format":"double"},"unpricedExecutions":{"type":"integer","description":"Count of rows inside totalCostUsd that recorded no cost figure. Their contribution is 0 because the cost is unknown, not because it was free."}},"required":["batchExecutionId","billedCostThousandthsCent","billedCostUsd","selfReportedCostUsd","totalCostUsd","unpricedExecutions"],"title":"Batch_getBatchExecutionTotalCost_Response_200"},"V1ClientTokensGetResponsesContentApplicationJsonSchemaClientTokensItemsEnvironment":{"type":"string","enum":["test","live"],"title":"V1ClientTokensGetResponsesContentApplicationJsonSchemaClientTokensItemsEnvironment"},"V1ClientTokensGetResponsesContentApplicationJsonSchemaClientTokensItems":{"type":"object","properties":{"agentIds":{"type":"array","items":{"type":"string"}},"allowedOrigins":{"type":"array","items":{"type":"string"}},"config":{"type":"object","additionalProperties":{"description":"Any type"}},"conversationCount":{"type":"integer"},"createdAt":{"type":"string"},"defaultFlowId":{"type":["string","null"]},"environment":{"$ref":"#/components/schemas/V1ClientTokensGetResponsesContentApplicationJsonSchemaClientTokensItemsEnvironment"},"flowIds":{"type":"array","items":{"type":"string"}},"id":{"type":"string"},"isActive":{"type":"boolean"},"lastUsedAt":{"type":["string","null"]},"maxMessagesPerSession":{"type":["integer","null"]},"name":{"type":["string","null"]},"pinToVersion":{"type":["string","null"]},"productSurfaceId":{"type":["string","null"]},"rateLimitPerHour":{"type":["integer","null"]},"rateLimitPerMinute":{"type":["integer","null"]},"sessionIdleTimeoutMinutes":{"type":["integer","null"]},"targetAlias":{"type":["string","null"],"description":"Release alias this token follows, re-resolved on every admission. Null when the token follows no pointer."},"targetVersionId":{"type":["string","null"],"description":"Exact agent version this token runs. Null when the token pins no version."},"tokenHint":{"type":["string","null"]},"tokenPrefix":{"type":"string"},"tokenValue":{"type":["string","null"]},"updatedAt":{"type":"string"}},"required":["agentIds","allowedOrigins","config","createdAt","defaultFlowId","environment","flowIds","id","isActive","lastUsedAt","maxMessagesPerSession","name","pinToVersion","rateLimitPerHour","rateLimitPerMinute","sessionIdleTimeoutMinutes","targetAlias","targetVersionId","tokenHint","tokenPrefix","tokenValue","updatedAt"],"title":"V1ClientTokensGetResponsesContentApplicationJsonSchemaClientTokensItems"},"V1ClientTokensGetResponsesContentApplicationJsonSchemaPagination":{"type":"object","properties":{"hasMore":{"type":"boolean"},"limit":{"type":"integer"},"offset":{"type":"integer"}},"required":["hasMore","limit","offset"],"title":"V1ClientTokensGetResponsesContentApplicationJsonSchemaPagination"},"Client_Tokens_listClientTokens_Response_200":{"type":"object","properties":{"clientTokens":{"type":"array","items":{"$ref":"#/components/schemas/V1ClientTokensGetResponsesContentApplicationJsonSchemaClientTokensItems"}},"pagination":{"$ref":"#/components/schemas/V1ClientTokensGetResponsesContentApplicationJsonSchemaPagination"}},"required":["clientTokens"],"title":"Client Tokens_listClientTokens_Response_200"},"V1ClientTokensPostRequestBodyContentApplicationJsonSchemaEnvironment":{"type":"string","enum":["test","live"],"default":"live","title":"V1ClientTokensPostRequestBodyContentApplicationJsonSchemaEnvironment"},"V1ClientTokensPostResponsesContentApplicationJsonSchemaClientTokenEnvironment":{"type":"string","enum":["test","live"],"title":"V1ClientTokensPostResponsesContentApplicationJsonSchemaClientTokenEnvironment"},"V1ClientTokensPostResponsesContentApplicationJsonSchemaClientToken":{"type":"object","properties":{"agentIds":{"type":"array","items":{"type":"string"}},"allowedOrigins":{"type":"array","items":{"type":"string"}},"config":{"type":"object","additionalProperties":{"description":"Any type"}},"conversationCount":{"type":"integer"},"createdAt":{"type":"string"},"defaultFlowId":{"type":["string","null"]},"environment":{"$ref":"#/components/schemas/V1ClientTokensPostResponsesContentApplicationJsonSchemaClientTokenEnvironment"},"flowIds":{"type":"array","items":{"type":"string"}},"id":{"type":"string"},"isActive":{"type":"boolean"},"lastUsedAt":{"type":["string","null"]},"maxMessagesPerSession":{"type":["integer","null"]},"name":{"type":["string","null"]},"pinToVersion":{"type":["string","null"]},"productSurfaceId":{"type":["string","null"]},"rateLimitPerHour":{"type":["integer","null"]},"rateLimitPerMinute":{"type":["integer","null"]},"sessionIdleTimeoutMinutes":{"type":["integer","null"]},"targetAlias":{"type":["string","null"],"description":"Release alias this token follows, re-resolved on every admission. Null when the token follows no pointer."},"targetVersionId":{"type":["string","null"],"description":"Exact agent version this token runs. Null when the token pins no version."},"tokenHint":{"type":["string","null"]},"tokenPrefix":{"type":"string"},"tokenValue":{"type":["string","null"]},"updatedAt":{"type":"string"}},"required":["agentIds","allowedOrigins","config","createdAt","defaultFlowId","environment","flowIds","id","isActive","lastUsedAt","maxMessagesPerSession","name","pinToVersion","rateLimitPerHour","rateLimitPerMinute","sessionIdleTimeoutMinutes","targetAlias","targetVersionId","tokenHint","tokenPrefix","tokenValue","updatedAt"],"title":"V1ClientTokensPostResponsesContentApplicationJsonSchemaClientToken"},"V1ClientTokensPostResponsesContentApplicationJsonSchemaWarningsItems":{"type":"object","properties":{"message":{"type":"string"},"type":{"type":"string"}},"required":["message","type"],"title":"V1ClientTokensPostResponsesContentApplicationJsonSchemaWarningsItems"},"Client_Tokens_createClientToken_Response_201":{"type":"object","properties":{"clientToken":{"$ref":"#/components/schemas/V1ClientTokensPostResponsesContentApplicationJsonSchemaClientToken"},"token":{"type":"string"},"warnings":{"type":"array","items":{"$ref":"#/components/schemas/V1ClientTokensPostResponsesContentApplicationJsonSchemaWarningsItems"}}},"required":["clientToken","token","warnings"],"title":"Client Tokens_createClientToken_Response_201"},"V1ClientTokensIdGetResponsesContentApplicationJsonSchemaClientTokenEnvironment":{"type":"string","enum":["test","live"],"title":"V1ClientTokensIdGetResponsesContentApplicationJsonSchemaClientTokenEnvironment"},"V1ClientTokensIdGetResponsesContentApplicationJsonSchemaClientToken":{"type":"object","properties":{"agentIds":{"type":"array","items":{"type":"string"}},"allowedOrigins":{"type":"array","items":{"type":"string"}},"config":{"type":"object","additionalProperties":{"description":"Any type"}},"conversationCount":{"type":"integer"},"createdAt":{"type":"string"},"defaultFlowId":{"type":["string","null"]},"environment":{"$ref":"#/components/schemas/V1ClientTokensIdGetResponsesContentApplicationJsonSchemaClientTokenEnvironment"},"flowIds":{"type":"array","items":{"type":"string"}},"id":{"type":"string"},"isActive":{"type":"boolean"},"lastUsedAt":{"type":["string","null"]},"maxMessagesPerSession":{"type":["integer","null"]},"name":{"type":["string","null"]},"pinToVersion":{"type":["string","null"]},"productSurfaceId":{"type":["string","null"]},"rateLimitPerHour":{"type":["integer","null"]},"rateLimitPerMinute":{"type":["integer","null"]},"sessionIdleTimeoutMinutes":{"type":["integer","null"]},"targetAlias":{"type":["string","null"],"description":"Release alias this token follows, re-resolved on every admission. Null when the token follows no pointer."},"targetVersionId":{"type":["string","null"],"description":"Exact agent version this token runs. Null when the token pins no version."},"tokenHint":{"type":["string","null"]},"tokenPrefix":{"type":"string"},"tokenValue":{"type":["string","null"]},"updatedAt":{"type":"string"}},"required":["agentIds","allowedOrigins","config","createdAt","defaultFlowId","environment","flowIds","id","isActive","lastUsedAt","maxMessagesPerSession","name","pinToVersion","rateLimitPerHour","rateLimitPerMinute","sessionIdleTimeoutMinutes","targetAlias","targetVersionId","tokenHint","tokenPrefix","tokenValue","updatedAt"],"title":"V1ClientTokensIdGetResponsesContentApplicationJsonSchemaClientToken"},"Client_Tokens_getClientToken_Response_200":{"type":"object","properties":{"clientToken":{"$ref":"#/components/schemas/V1ClientTokensIdGetResponsesContentApplicationJsonSchemaClientToken"}},"required":["clientToken"],"title":"Client Tokens_getClientToken_Response_200"},"V1ClientTokensIdPutResponsesContentApplicationJsonSchemaClientTokenEnvironment":{"type":"string","enum":["test","live"],"title":"V1ClientTokensIdPutResponsesContentApplicationJsonSchemaClientTokenEnvironment"},"V1ClientTokensIdPutResponsesContentApplicationJsonSchemaClientToken":{"type":"object","properties":{"agentIds":{"type":"array","items":{"type":"string"}},"allowedOrigins":{"type":"array","items":{"type":"string"}},"config":{"type":"object","additionalProperties":{"description":"Any type"}},"conversationCount":{"type":"integer"},"createdAt":{"type":"string"},"defaultFlowId":{"type":["string","null"]},"environment":{"$ref":"#/components/schemas/V1ClientTokensIdPutResponsesContentApplicationJsonSchemaClientTokenEnvironment"},"flowIds":{"type":"array","items":{"type":"string"}},"id":{"type":"string"},"isActive":{"type":"boolean"},"lastUsedAt":{"type":["string","null"]},"maxMessagesPerSession":{"type":["integer","null"]},"name":{"type":["string","null"]},"pinToVersion":{"type":["string","null"]},"productSurfaceId":{"type":["string","null"]},"rateLimitPerHour":{"type":["integer","null"]},"rateLimitPerMinute":{"type":["integer","null"]},"sessionIdleTimeoutMinutes":{"type":["integer","null"]},"targetAlias":{"type":["string","null"],"description":"Release alias this token follows, re-resolved on every admission. Null when the token follows no pointer."},"targetVersionId":{"type":["string","null"],"description":"Exact agent version this token runs. Null when the token pins no version."},"tokenHint":{"type":["string","null"]},"tokenPrefix":{"type":"string"},"tokenValue":{"type":["string","null"]},"updatedAt":{"type":"string"}},"required":["agentIds","allowedOrigins","config","createdAt","defaultFlowId","environment","flowIds","id","isActive","lastUsedAt","maxMessagesPerSession","name","pinToVersion","rateLimitPerHour","rateLimitPerMinute","sessionIdleTimeoutMinutes","targetAlias","targetVersionId","tokenHint","tokenPrefix","tokenValue","updatedAt"],"title":"V1ClientTokensIdPutResponsesContentApplicationJsonSchemaClientToken"},"V1ClientTokensIdPutResponsesContentApplicationJsonSchemaWarningsItems":{"type":"object","properties":{"message":{"type":"string"},"type":{"type":"string"}},"required":["message","type"],"title":"V1ClientTokensIdPutResponsesContentApplicationJsonSchemaWarningsItems"},"Client_Tokens_updateClientToken_Response_200":{"type":"object","properties":{"clientToken":{"$ref":"#/components/schemas/V1ClientTokensIdPutResponsesContentApplicationJsonSchemaClientToken"},"warnings":{"type":"array","items":{"$ref":"#/components/schemas/V1ClientTokensIdPutResponsesContentApplicationJsonSchemaWarningsItems"}}},"required":["clientToken","warnings"],"title":"Client Tokens_updateClientToken_Response_200"},"CredentialLifecycleErrorCode":{"type":"string","enum":["CREDENTIAL_REVOKED","CREDENTIAL_INACTIVE"],"description":"CREDENTIAL_REVOKED: the credential was revoked; revocation is permanent, so create a new one. CREDENTIAL_INACTIVE: activate the credential before you rotate it.","title":"CredentialLifecycleErrorCode"},"CredentialLifecycleErrorDetailsItems":{"type":"object","properties":{"code":{"type":"string","description":"Stable Runtype validation code (e.g. MISSING_REQUIRED_FIELD, INVALID_ENUM)."},"message":{"type":"string"},"path":{"type":"string","description":"Dotted JSON path to the offending field."},"suggestion":{"type":"string","description":"Actionable hint (allowed values, accepted range, …)."}},"required":["message"],"title":"CredentialLifecycleErrorDetailsItems"},"CredentialLifecycleError":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/CredentialLifecycleErrorCode","description":"CREDENTIAL_REVOKED: the credential was revoked; revocation is permanent, so create a new one. CREDENTIAL_INACTIVE: activate the credential before you rotate it."},"details":{"type":"array","items":{"$ref":"#/components/schemas/CredentialLifecycleErrorDetailsItems"}},"error":{"type":"string"},"requiredScopes":{"type":"array","items":{"type":"string"},"description":"On `insufficient_scope`: every API key scope this request needs."},"message":{"type":"string","description":"Human-readable reason."}},"required":["code","error","message"],"title":"CredentialLifecycleError"},"Client_Tokens_deleteClientToken_Response_200":{"type":"object","properties":{"message":{"type":"string"},"success":{"type":"boolean"}},"required":["message","success"],"title":"Client Tokens_deleteClientToken_Response_200"},"V1ClientTokensIdConversationsGetResponsesContentApplicationJsonSchemaConversationsItems":{"type":"object","properties":{"createdAt":{"type":"string"},"firstMessage":{"type":["string","null"]},"flowId":{"description":"Any type"},"id":{"type":"string"},"messageCount":{"description":"Any type"},"name":{"type":["string","null"]},"origin":{"description":"Any type"},"updatedAt":{"type":"string"}},"required":["createdAt","firstMessage","id","name","updatedAt"],"title":"V1ClientTokensIdConversationsGetResponsesContentApplicationJsonSchemaConversationsItems"},"V1ClientTokensIdConversationsGetResponsesContentApplicationJsonSchemaPagination":{"type":"object","properties":{"hasMore":{"type":"boolean"},"limit":{"type":"integer"},"offset":{"type":"integer"}},"required":["hasMore","limit","offset"],"title":"V1ClientTokensIdConversationsGetResponsesContentApplicationJsonSchemaPagination"},"Client_Tokens_listConversationsForClientToken_Response_200":{"type":"object","properties":{"conversations":{"type":"array","items":{"$ref":"#/components/schemas/V1ClientTokensIdConversationsGetResponsesContentApplicationJsonSchemaConversationsItems"}},"pagination":{"$ref":"#/components/schemas/V1ClientTokensIdConversationsGetResponsesContentApplicationJsonSchemaPagination"}},"required":["conversations","pagination"],"title":"Client Tokens_listConversationsForClientToken_Response_200"},"V1ClientTokensIdRegeneratePostResponsesContentApplicationJsonSchemaClientTokenEnvironment":{"type":"string","enum":["test","live"],"title":"V1ClientTokensIdRegeneratePostResponsesContentApplicationJsonSchemaClientTokenEnvironment"},"V1ClientTokensIdRegeneratePostResponsesContentApplicationJsonSchemaClientToken":{"type":"object","properties":{"agentIds":{"type":"array","items":{"type":"string"}},"allowedOrigins":{"type":"array","items":{"type":"string"}},"createdAt":{"type":"string"},"defaultFlowId":{"type":["string","null"]},"environment":{"$ref":"#/components/schemas/V1ClientTokensIdRegeneratePostResponsesContentApplicationJsonSchemaClientTokenEnvironment"},"flowIds":{"type":"array","items":{"type":"string"}},"id":{"type":"string"},"isActive":{"type":"boolean"},"name":{"type":["string","null"]},"pinToVersion":{"type":["string","null"]},"targetAlias":{"type":["string","null"]},"targetVersionId":{"type":["string","null"]},"tokenHint":{"type":["string","null"]},"tokenPrefix":{"type":"string"},"tokenValue":{"type":["string","null"]},"updatedAt":{"type":"string"}},"required":["agentIds","allowedOrigins","createdAt","defaultFlowId","environment","flowIds","id","isActive","name","pinToVersion","targetAlias","targetVersionId","tokenHint","tokenPrefix","tokenValue","updatedAt"],"title":"V1ClientTokensIdRegeneratePostResponsesContentApplicationJsonSchemaClientToken"},"Client_Tokens_regenerateClientToken_Response_200":{"type":"object","properties":{"clientToken":{"$ref":"#/components/schemas/V1ClientTokensIdRegeneratePostResponsesContentApplicationJsonSchemaClientToken"},"message":{"type":"string"},"token":{"type":"string"}},"required":["clientToken","message","token"],"title":"Client Tokens_regenerateClientToken_Response_200"},"Client_Tokens_revokeClientToken_Response_200":{"type":"object","properties":{"message":{"type":"string"},"success":{"type":"boolean"}},"required":["message","success"],"title":"Client Tokens_revokeClientToken_Response_200"},"Client_Tokens_getClientTokenValue_Response_200":{"type":"object","properties":{"token":{"type":"string"}},"required":["token"],"title":"Client Tokens_getClientTokenValue_Response_200"},"GetClientTokenValueRequestBadRequestError":{"type":"object","properties":{"error":{"type":"string"},"hint":{"type":"string"}},"required":["error"],"title":"GetClientTokenValueRequestBadRequestError"},"V1ClientApprovePostRequestBodyContentApplicationJsonSchemaDecision":{"type":"string","enum":["approved","denied"],"title":"V1ClientApprovePostRequestBodyContentApplicationJsonSchemaDecision"},"DispatchToolOutputContinuationJsonResponseAgentTargetResolution":{"type":"string","enum":["alias","version","legacy-live-row"],"description":"How the run selected its definition: `alias` or `version` for a request that named a selector, `legacy-live-row` for a run that read the mutable agent row. Matches `GET /v1/executions/{executionId}/status`.","title":"DispatchToolOutputContinuationJsonResponseAgentTargetResolution"},"DispatchToolOutputContinuationJsonResponseStatus":{"type":"string","enum":["completed","paused","failed"],"title":"DispatchToolOutputContinuationJsonResponseStatus"},"DispatchToolOutputContinuationJsonResponse":{"type":"object","properties":{"agentTargetResolution":{"$ref":"#/components/schemas/DispatchToolOutputContinuationJsonResponseAgentTargetResolution","description":"How the run selected its definition: `alias` or `version` for a request that named a selector, `legacy-live-row` for a run that read the mutable agent row. Matches `GET /v1/executions/{executionId}/status`."},"agentVersionId":{"type":"string","description":"The agent version recorded for the run. When `agentTargetResolution` is `legacy-live-row`, this is the version the agent row pointed at, and the run read the mutable row rather than that version. Absent when neither exists."},"alias":{"type":"string","description":"The release alias (for example `live`) the version was resolved through, when one was."},"blockReason":{"type":"string"},"code":{"type":"string"},"error":{"type":"string"},"events":{"type":"array","items":{"$ref":"#/components/schemas/ExecutionStreamEvent"}},"executionId":{"type":"string"},"pausedReason":{"$ref":"#/components/schemas/DispatchPausedReason"},"status":{"$ref":"#/components/schemas/DispatchToolOutputContinuationJsonResponseStatus"},"success":{"type":"boolean"},"upgradeUrl":{"type":"string"}},"required":["events","executionId","status","success"],"title":"DispatchToolOutputContinuationJsonResponse"},"V1ClientChatPostRequestBodyContentApplicationJsonSchemaClientToolsItemsAnnotations":{"type":"object","properties":{"consequentialHint":{"type":"boolean"},"debugging":{"type":"boolean"},"destructiveHint":{"type":"boolean"},"idempotentHint":{"type":"boolean"},"openWorldHint":{"type":"boolean"},"readOnlyHint":{"type":"boolean"},"untrustedContentHint":{"type":"boolean"}},"title":"V1ClientChatPostRequestBodyContentApplicationJsonSchemaClientToolsItemsAnnotations"},"V1ClientChatPostRequestBodyContentApplicationJsonSchemaClientToolsItemsOrigin":{"type":"string","enum":["webmcp","sdk"],"title":"V1ClientChatPostRequestBodyContentApplicationJsonSchemaClientToolsItemsOrigin"},"V1ClientChatPostRequestBodyContentApplicationJsonSchemaClientToolsItemsParametersSchemaType":{"type":"string","enum":["object"],"title":"V1ClientChatPostRequestBodyContentApplicationJsonSchemaClientToolsItemsParametersSchemaType"},"V1ClientChatPostRequestBodyContentApplicationJsonSchemaClientToolsItemsParametersSchema":{"type":"object","properties":{"type":{"$ref":"#/components/schemas/V1ClientChatPostRequestBodyContentApplicationJsonSchemaClientToolsItemsParametersSchemaType"}},"required":["type"],"title":"V1ClientChatPostRequestBodyContentApplicationJsonSchemaClientToolsItemsParametersSchema"},"V1ClientChatPostRequestBodyContentApplicationJsonSchemaClientToolsItems":{"type":"object","properties":{"annotations":{"$ref":"#/components/schemas/V1ClientChatPostRequestBodyContentApplicationJsonSchemaClientToolsItemsAnnotations"},"description":{"type":"string","minLength":1},"name":{"type":"string","minLength":1},"origin":{"$ref":"#/components/schemas/V1ClientChatPostRequestBodyContentApplicationJsonSchemaClientToolsItemsOrigin"},"pageOrigin":{"type":"string"},"parametersSchema":{"$ref":"#/components/schemas/V1ClientChatPostRequestBodyContentApplicationJsonSchemaClientToolsItemsParametersSchema"},"untrustedContentHint":{"type":"boolean"}},"required":["description","name","parametersSchema"],"title":"V1ClientChatPostRequestBodyContentApplicationJsonSchemaClientToolsItems"},"V1ClientChatPostRequestBodyContentApplicationJsonSchemaDelivery":{"type":"string","enum":["socket"],"description":"Set to `socket` to receive this turn on the client session socket named by `realtime` in the init response, instead of in this response. When the server honors it, the response is `202 {executionId, conversationId, delivery: \"socket\"}`. Otherwise the turn streams over Server-Sent Events as usual.","title":"V1ClientChatPostRequestBodyContentApplicationJsonSchemaDelivery"},"V1ClientChatPostRequestBodyContentApplicationJsonSchemaIdentityProof":{"type":"object","properties":{"provider":{"type":"string","minLength":1,"maxLength":64},"token":{"type":"string","minLength":1,"maxLength":8192}},"required":["provider","token"],"description":"Customer-native auth proof for the Identity Exchange. When present and the surface has a matching integration, the verified tenant/end-user replace any body-asserted tenant/endUser (which are never trusted for web-embedded callers). A proof that fails verification is rejected with 401 `invalid_identity_proof`.","title":"V1ClientChatPostRequestBodyContentApplicationJsonSchemaIdentityProof"},"V1ClientChatPostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1ItemsOneOf0Type":{"type":"string","enum":["text"],"title":"V1ClientChatPostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1ItemsOneOf0Type"},"V1ClientChatPostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1Items0":{"type":"object","properties":{"text":{"type":"string"},"type":{"$ref":"#/components/schemas/V1ClientChatPostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1ItemsOneOf0Type"}},"required":["text","type"],"title":"V1ClientChatPostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1Items0"},"V1ClientChatPostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1ItemsOneOf1Type":{"type":"string","enum":["image"],"title":"V1ClientChatPostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1ItemsOneOf1Type"},"V1ClientChatPostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1Items1":{"type":"object","properties":{"image":{"type":"string"},"mimeType":{"type":"string"},"type":{"$ref":"#/components/schemas/V1ClientChatPostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1ItemsOneOf1Type"}},"required":["image","type"],"title":"V1ClientChatPostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1Items1"},"V1ClientChatPostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1ItemsOneOf2Type":{"type":"string","enum":["file"],"title":"V1ClientChatPostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1ItemsOneOf2Type"},"V1ClientChatPostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1Items2":{"type":"object","properties":{"data":{"type":"string"},"filename":{"type":"string"},"mimeType":{"type":"string"},"type":{"$ref":"#/components/schemas/V1ClientChatPostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1ItemsOneOf2Type"}},"required":["data","filename","mimeType","type"],"title":"V1ClientChatPostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1Items2"},"V1ClientChatPostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1ItemsOneOf3Type":{"type":"string","enum":["reasoning"],"title":"V1ClientChatPostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1ItemsOneOf3Type"},"V1ClientChatPostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1Items3":{"type":"object","properties":{"providerOptions":{"type":"object","additionalProperties":{"description":"Any type"}},"text":{"type":"string"},"type":{"$ref":"#/components/schemas/V1ClientChatPostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1ItemsOneOf3Type"}},"required":["text","type"],"title":"V1ClientChatPostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1Items3"},"V1ClientChatPostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1Items":{"oneOf":[{"$ref":"#/components/schemas/V1ClientChatPostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1Items0"},{"$ref":"#/components/schemas/V1ClientChatPostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1Items1"},{"$ref":"#/components/schemas/V1ClientChatPostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1Items2"},{"$ref":"#/components/schemas/V1ClientChatPostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1Items3"}],"title":"V1ClientChatPostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1Items"},"V1ClientChatPostRequestBodyContentApplicationJsonSchemaMessagesItemsContent1":{"type":"array","items":{"$ref":"#/components/schemas/V1ClientChatPostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1Items"},"title":"V1ClientChatPostRequestBodyContentApplicationJsonSchemaMessagesItemsContent1"},"V1ClientChatPostRequestBodyContentApplicationJsonSchemaMessagesItemsContent":{"oneOf":[{"type":"string","minLength":1},{"$ref":"#/components/schemas/V1ClientChatPostRequestBodyContentApplicationJsonSchemaMessagesItemsContent1"}],"title":"V1ClientChatPostRequestBodyContentApplicationJsonSchemaMessagesItemsContent"},"V1ClientChatPostRequestBodyContentApplicationJsonSchemaMessagesItemsRole":{"type":"string","enum":["user","assistant","system"],"title":"V1ClientChatPostRequestBodyContentApplicationJsonSchemaMessagesItemsRole"},"V1ClientChatPostRequestBodyContentApplicationJsonSchemaMessagesItems":{"type":"object","properties":{"content":{"$ref":"#/components/schemas/V1ClientChatPostRequestBodyContentApplicationJsonSchemaMessagesItemsContent"},"displayContent":{"type":"string","maxLength":32768,"description":"The text a human actually saw for this message, when it differs from `content`. Stored beside the model content and returned by the history routes; NEVER read by execution, and never treated as authority. Send it for a message whose visible form is not its model form (a structured payload, a hidden `llmContent` variant, a directive rendered as UI). Absent means no projection was captured; an empty string is a deliberate empty projection, and the two are distinguished on read. For a message id the conversation already stores, only this field is taken — the stored model content wins — which makes a re-sent turn an idempotent repair path for a display-projection finalization that never landed. Plain text or Markdown, never rendered HTML."},"id":{"type":"string"},"role":{"$ref":"#/components/schemas/V1ClientChatPostRequestBodyContentApplicationJsonSchemaMessagesItemsRole"}},"required":["content","role"],"title":"V1ClientChatPostRequestBodyContentApplicationJsonSchemaMessagesItems"},"V1ClientChatPostRequestBodyContentApplicationJsonSchemaSubmitMode":{"type":"string","enum":["normal","interrupt","steer","auto"],"title":"V1ClientChatPostRequestBodyContentApplicationJsonSchemaSubmitMode"},"V1ClientChatPostRequestBodyContentApplicationJsonSchemaVoicePriorToolResultsItems":{"type":"object","properties":{"arguments":{"type":"object","additionalProperties":{"description":"Any type"}},"name":{"type":"string","minLength":1,"maxLength":128},"result":{"description":"Any type"},"toolCallId":{"type":"string","pattern":"^[A-Za-z0-9_-]+$","minLength":1,"maxLength":128}},"required":["arguments","name","toolCallId"],"title":"V1ClientChatPostRequestBodyContentApplicationJsonSchemaVoicePriorToolResultsItems"},"V1ClientChatPostRequestBodyContentApplicationJsonSchemaVoice":{"type":"object","properties":{"priorToolResults":{"type":"array","items":{"$ref":"#/components/schemas/V1ClientChatPostRequestBodyContentApplicationJsonSchemaVoicePriorToolResultsItems"},"description":"Page tools the voice call already ran this turn. Replayed to the model as answered calls to the offered `clientTools`, deduplicated by `toolCallId`, so the agent narrates rather than re-calls. At most 8 entries; the JSON `arguments` plus `result` of each entry may total 32,768 characters."},"spoken":{"type":"boolean","description":"The user turn came from a live voice call and the reply will be spoken by a voice model. The turn runs with a per-turn instruction to lead with a short, speakable answer; the instruction is never stored in the conversation."}},"description":"Voice context for this turn. Omit for typed chat; behavior is unchanged when absent.","title":"V1ClientChatPostRequestBodyContentApplicationJsonSchemaVoice"},"V1ClientChatPostResponsesContentApplicationJsonSchemaDetailsItems":{"type":"object","properties":{"code":{"type":"string","description":"Stable Runtype validation code (e.g. MISSING_REQUIRED_FIELD, INVALID_ENUM)."},"message":{"type":"string"},"path":{"type":"string","description":"Dotted JSON path to the offending field."},"suggestion":{"type":"string","description":"Actionable hint (allowed values, accepted range, …)."}},"required":["message"],"title":"V1ClientChatPostResponsesContentApplicationJsonSchemaDetailsItems"},"SendAClientChatMessageRequestUnauthorizedError":{"type":"object","properties":{"code":{"type":"string","description":"Stable error code. `insufficient_scope` marks an API key that lacks a scope this request needs."},"details":{"type":"array","items":{"$ref":"#/components/schemas/V1ClientChatPostResponsesContentApplicationJsonSchemaDetailsItems"}},"error":{"type":"string"},"requiredScopes":{"type":"array","items":{"type":"string"},"description":"On `insufficient_scope`: every API key scope this request needs."},"errorDescription":{"type":"string","description":"Why the supplied `identityProof` was refused (for example an expired assertion, an unknown issuer, or a proof minted for another tenant). Diagnostic text for the embedding site, not a value to branch on."}},"required":["error"],"title":"SendAClientChatMessageRequestUnauthorizedError"},"V1ClientConversationsGetResponsesContentApplicationJsonSchemaDataItems":{"type":"object","properties":{"createdAt":{"type":"string","description":"ISO-8601 timestamp of the first turn, i.e. when the conversation was created."},"flowId":{"type":["string","null"],"description":"Deprecated alias of `targetId`, carrying the same value. Retained for clients written before the rename; read `targetId` instead."},"id":{"type":"string","description":"Conversation id."},"messageCount":{"type":"number","format":"double","description":"Number of stored messages. Falls back to the length of the stored transcript when the conversation predates the counter."},"preview":{"type":["string","null"],"description":"Plain-text excerpt of the conversation's most recent visitor-visible message, bounded to 140 Unicode code points, for a scannable history list. Derived from `displayContent` when the message has one and never from opaque model-only content, so it cannot become the one place internals leak. Null when the latest visible message has no text — including when its captured projection is deliberately empty."},"targetId":{"type":["string","null"],"description":"The flow or agent this conversation ran against, and the exact value to pass as the `targetId` list/delete filter. Null for a conversation stored without one. Canonical replacement for `flowId`."},"title":{"type":"string","description":"Display title. Uses a timestamp fallback unless conversation-title generation is enabled and produces a title from the opening exchange."},"updatedAt":{"type":"string","description":"ISO-8601 timestamp of the most recent write. Sort key for \"resume where I left off\" in a widget."}},"required":["createdAt","flowId","id","messageCount","preview","targetId","title","updatedAt"],"title":"V1ClientConversationsGetResponsesContentApplicationJsonSchemaDataItems"},"Client_Runtime_listTheVisitorsOwnConversations_Response_200":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1ClientConversationsGetResponsesContentApplicationJsonSchemaDataItems"},"description":"Conversations owned by the calling visitor, newest first."},"nextCursor":{"type":["string","null"],"description":"Opaque cursor for the next page, or null when exhausted."}},"required":["data","nextCursor"],"title":"Client Runtime_listTheVisitorsOwnConversations_Response_200"},"Client_Runtime_deleteAllOfTheVisitorsOwnConversations_Response_200":{"type":"object","properties":{"deleted":{"type":"number","format":"double","description":"Number of conversations deleted. The delete-all route returns 0 when the visitor has no history, rather than an error."}},"required":["deleted"],"title":"Client Runtime_deleteAllOfTheVisitorsOwnConversations_Response_200"},"Client_Runtime_stopADurableClientExecution_Response_202":{"type":"object","properties":{"accepted":{"type":"boolean"},"executionId":{"type":"string"}},"required":["accepted","executionId"],"title":"Client Runtime_stopADurableClientExecution_Response_202"},"StopADurableClientExecutionRequestConflictError":{"type":"object","properties":{"accepted":{"type":"boolean"},"executionId":{"type":"string"},"reason":{"type":"string"}},"required":["accepted","executionId"],"title":"StopADurableClientExecutionRequestConflictError"},"ClientInputDeliveryReceiptStatus":{"type":"string","enum":["pending","applied","settled","not_applied"],"title":"ClientInputDeliveryReceiptStatus"},"ClientInputDeliveryReceipt":{"type":"object","properties":{"deliveryId":{"type":"string","minLength":1},"executionId":{"type":"string","minLength":1},"initial":{"type":"boolean"},"outcome":{"type":"string"},"sequence":{"type":"integer","minimum":0},"status":{"$ref":"#/components/schemas/ClientInputDeliveryReceiptStatus"}},"required":["deliveryId","executionId","initial","sequence","status"],"title":"ClientInputDeliveryReceipt"},"V1ClientConversationsIdGetResponsesContentApplicationJsonSchemaMessagesItems":{"type":"object","properties":{"content":{"description":"The MODEL channel content, exactly as stored: a plain string, or an array of multi-modal content parts. Absent on a stored message that carried no content, and deliberately WITHHELD when the message has no `displayContent` and its stored content is not plainly render-safe — opaque structure is not handed to a renderer that would show a visitor internals. Prefer `displayContent` for rendering whenever it is present."},"displayAvailable":{"type":"boolean","description":"Whether this message has a visitor-renderable form at all — either a captured `displayContent`, or stored content that is plainly render-safe. False means the message exists in the transcript but its visible form cannot be reconstructed (a legacy message whose content was model-only); render a placeholder rather than anything derived from `content`."},"displayContent":{"type":"string","description":"The text a human actually saw for this message, as captured by the client. Present only when a projection was recorded; an empty string is a deliberate empty projection and is NOT the same as absence. Render this in preference to `content`. Plain text or Markdown, never rendered HTML, and never model input."},"id":{"type":"string","description":"Client-supplied or server-minted message id."},"role":{"type":"string","description":"Message author, typically 'user' or 'assistant'."},"timestamp":{"type":"string","description":"ISO-8601 send time. Absent on messages stored without one."}},"required":["displayAvailable","id","role"],"title":"V1ClientConversationsIdGetResponsesContentApplicationJsonSchemaMessagesItems"},"Client_Runtime_readOneOfTheVisitorsOwnConversations_Response_200":{"type":"object","properties":{"conversationRevision":{"type":"string","description":"Opaque change token for this conversation. Compare for equality only — it is unordered and unparseable. It changes on every transcript mutation, including a display-projection finalization that deliberately leaves `updatedAt` untouched, so a client can tell whether a transcript it cached is still current. The same token is returned by `/client/init` and by the display-projections route."},"createdAt":{"type":"string","description":"ISO-8601 timestamp of the first turn, i.e. when the conversation was created."},"flowId":{"type":["string","null"],"description":"Deprecated alias of `targetId`, carrying the same value. Retained for clients written before the rename; read `targetId` instead."},"id":{"type":"string","description":"Conversation id."},"messageCount":{"type":"number","format":"double","description":"Number of stored messages. Falls back to the length of the stored transcript when the conversation predates the counter."},"messages":{"type":"array","items":{"$ref":"#/components/schemas/V1ClientConversationsIdGetResponsesContentApplicationJsonSchemaMessagesItems"},"description":"The stored transcript, oldest first. Renderable fields only: tool invocations and other execution internals are not exposed here."},"nextMessageCursor":{"type":["string","null"],"description":"Opaque cursor for the next older message page, or null when the beginning is reached."},"preview":{"type":["string","null"],"description":"Plain-text excerpt of the conversation's most recent visitor-visible message, bounded to 140 Unicode code points, for a scannable history list. Derived from `displayContent` when the message has one and never from opaque model-only content, so it cannot become the one place internals leak. Null when the latest visible message has no text — including when its captured projection is deliberately empty."},"targetId":{"type":["string","null"],"description":"The flow or agent this conversation ran against, and the exact value to pass as the `targetId` list/delete filter. Null for a conversation stored without one. Canonical replacement for `flowId`."},"title":{"type":"string","description":"Display title. Uses a timestamp fallback unless conversation-title generation is enabled and produces a title from the opening exchange."},"updatedAt":{"type":"string","description":"ISO-8601 timestamp of the most recent write. Sort key for \"resume where I left off\" in a widget."}},"required":["conversationRevision","createdAt","flowId","id","messageCount","messages","nextMessageCursor","preview","targetId","title","updatedAt"],"title":"Client Runtime_readOneOfTheVisitorsOwnConversations_Response_200"},"Client_Runtime_deleteOneOfTheVisitorsOwnConversations_Response_200":{"type":"object","properties":{"deleted":{"type":"number","format":"double","description":"Number of conversations deleted. The delete-all route returns 0 when the visitor has no history, rather than an error."}},"required":["deleted"],"title":"Client Runtime_deleteOneOfTheVisitorsOwnConversations_Response_200"},"V1ClientConversationsIdDisplayProjectionsPatchRequestBodyContentApplicationJsonSchemaMessagesItems":{"type":"object","properties":{"displayContent":{"type":"string","maxLength":32768,"description":"The final text a human saw for that message. An empty string is a valid, deliberate empty projection."},"id":{"type":"string","minLength":1,"description":"Id of a message this conversation ALREADY stores. An id it does not hold fails the whole batch."}},"required":["displayContent","id"],"title":"V1ClientConversationsIdDisplayProjectionsPatchRequestBodyContentApplicationJsonSchemaMessagesItems"},"Client_Runtime_finalizeTheVisibleTextOfStoredMessages_Response_200":{"type":"object","properties":{"conversationRevision":{"type":"string","description":"The conversation's change token after this call. Unchanged when the projections were already current, so a client can replay a lost finalization safely. Compare for equality only."}},"required":["conversationRevision"],"title":"Client Runtime_finalizeTheVisibleTextOfStoredMessages_Response_200"},"V1ClientFeedbackPostRequestBodyContentApplicationJsonSchemaType":{"type":"string","enum":["upvote","downvote","copy","csat","nps"],"title":"V1ClientFeedbackPostRequestBodyContentApplicationJsonSchemaType"},"Client_Runtime_submitFeedbackOnAMessage_Response_200":{"type":"object","properties":{"feedbackId":{"type":"string"},"message":{"type":"string"},"success":{"type":"boolean"}},"required":["feedbackId","success"],"title":"Client Runtime_submitFeedbackOnAMessage_Response_200"},"V1FeedbackPostResponsesContentApplicationJsonSchemaDetailsItems":{"type":"object","properties":{"code":{"type":"string","description":"Stable Runtype validation code (e.g. MISSING_REQUIRED_FIELD, INVALID_ENUM)."},"message":{"type":"string"},"path":{"type":"string","description":"Dotted JSON path to the offending field."},"suggestion":{"type":"string","description":"Actionable hint (allowed values, accepted range, …)."}},"required":["message"],"title":"V1FeedbackPostResponsesContentApplicationJsonSchemaDetailsItems"},"SubmitFeedbackOnAMessageRequestBadRequestError":{"type":"object","properties":{"code":{"type":"string","description":"Stable error code. `insufficient_scope` marks an API key that lacks a scope this request needs."},"details":{"type":"array","items":{"$ref":"#/components/schemas/V1FeedbackPostResponsesContentApplicationJsonSchemaDetailsItems"}},"error":{"type":"string"},"requiredScopes":{"type":"array","items":{"type":"string"},"description":"On `insufficient_scope`: every API key scope this request needs."}},"required":["error"],"title":"SubmitFeedbackOnAMessageRequestBadRequestError"},"V1ClientInitPostRequestBodyContentApplicationJsonSchemaOneOf0IdentityProof1":{"type":"object","properties":{"provider":{"type":"string","minLength":1,"maxLength":64},"token":{"type":"string","minLength":1,"maxLength":8192}},"required":["provider","token"],"description":"Customer-native auth proof for the Identity Exchange. When present and the surface has a matching integration, the verified tenant/end-user replace any body-asserted tenant/endUser (which are never trusted for web-embedded callers). A proof that fails verification is rejected with 401 `invalid_identity_proof`.","title":"V1ClientInitPostRequestBodyContentApplicationJsonSchemaOneOf0IdentityProof1"},"V1ClientInitPostRequestBodyContentApplicationJsonSchemaOneOf0IdentityProof":{"oneOf":[{"type":"string","minLength":1,"maxLength":8192},{"$ref":"#/components/schemas/V1ClientInitPostRequestBodyContentApplicationJsonSchemaOneOf0IdentityProof1"}],"description":"Customer-native auth proof for the Identity Exchange, as a bare token string or the `{ provider, token }` object `/v1/client/chat` accepts. The integration is selected by the verified issuer, not by `provider`: in the object form `provider` is a consistency hint (a hint that disagrees with the matched integration is rejected), and the bare string carries no hint. A Runtype-hosted `rt_eu_` token is sent as the bare string.","title":"V1ClientInitPostRequestBodyContentApplicationJsonSchemaOneOf0IdentityProof"},"ClientRuntimeInitializeAClientSessionRequest0":{"type":"object","properties":{"durableRecovery":{"type":"boolean"},"flowId":{"type":"string"},"identityProof":{"$ref":"#/components/schemas/V1ClientInitPostRequestBodyContentApplicationJsonSchemaOneOf0IdentityProof","description":"Customer-native auth proof for the Identity Exchange, as a bare token string or the `{ provider, token }` object `/v1/client/chat` accepts. The integration is selected by the verified issuer, not by `provider`: in the object form `provider` is a consistency hint (a hint that disagrees with the matched integration is rejected), and the bare string carries no hint. A Runtype-hosted `rt_eu_` token is sent as the bare string."},"token":{"type":"string","minLength":1},"visitorHistory":{"type":"boolean"},"visitorToken":{"type":"string","minLength":1,"maxLength":200}},"required":["token"],"title":"ClientRuntimeInitializeAClientSessionRequest0"},"V1ClientInitPostRequestBodyContentApplicationJsonSchemaOneOf1IdentityProof1":{"type":"object","properties":{"provider":{"type":"string","minLength":1,"maxLength":64},"token":{"type":"string","minLength":1,"maxLength":8192}},"required":["provider","token"],"description":"Customer-native auth proof for the Identity Exchange. When present and the surface has a matching integration, the verified tenant/end-user replace any body-asserted tenant/endUser (which are never trusted for web-embedded callers). A proof that fails verification is rejected with 401 `invalid_identity_proof`.","title":"V1ClientInitPostRequestBodyContentApplicationJsonSchemaOneOf1IdentityProof1"},"V1ClientInitPostRequestBodyContentApplicationJsonSchemaOneOf1IdentityProof":{"oneOf":[{"type":"string","minLength":1,"maxLength":8192},{"$ref":"#/components/schemas/V1ClientInitPostRequestBodyContentApplicationJsonSchemaOneOf1IdentityProof1"}],"description":"Customer-native auth proof for the Identity Exchange, as a bare token string or the `{ provider, token }` object `/v1/client/chat` accepts. The integration is selected by the verified issuer, not by `provider`: in the object form `provider` is a consistency hint (a hint that disagrees with the matched integration is rejected), and the bare string carries no hint. A Runtype-hosted `rt_eu_` token is sent as the bare string.","title":"V1ClientInitPostRequestBodyContentApplicationJsonSchemaOneOf1IdentityProof"},"ClientRuntimeInitializeAClientSessionRequest1":{"type":"object","properties":{"durableRecovery":{"type":"boolean"},"flowId":{"type":"string"},"identityProof":{"$ref":"#/components/schemas/V1ClientInitPostRequestBodyContentApplicationJsonSchemaOneOf1IdentityProof","description":"Customer-native auth proof for the Identity Exchange, as a bare token string or the `{ provider, token }` object `/v1/client/chat` accepts. The integration is selected by the verified issuer, not by `provider`: in the object form `provider` is a consistency hint (a hint that disagrees with the matched integration is rejected), and the bare string carries no hint. A Runtype-hosted `rt_eu_` token is sent as the bare string."},"sessionId":{"type":"string"},"token":{"type":"string","minLength":1},"visitorHistory":{"type":"boolean"},"visitorToken":{"type":"string","minLength":1,"maxLength":200}},"required":["sessionId","token"],"title":"ClientRuntimeInitializeAClientSessionRequest1"},"V1ClientInitPostRequestBodyContentApplicationJsonSchemaOneOf2IdentityProof1":{"type":"object","properties":{"provider":{"type":"string","minLength":1,"maxLength":64},"token":{"type":"string","minLength":1,"maxLength":8192}},"required":["provider","token"],"description":"Customer-native auth proof for the Identity Exchange. When present and the surface has a matching integration, the verified tenant/end-user replace any body-asserted tenant/endUser (which are never trusted for web-embedded callers). A proof that fails verification is rejected with 401 `invalid_identity_proof`.","title":"V1ClientInitPostRequestBodyContentApplicationJsonSchemaOneOf2IdentityProof1"},"V1ClientInitPostRequestBodyContentApplicationJsonSchemaOneOf2IdentityProof":{"oneOf":[{"type":"string","minLength":1,"maxLength":8192},{"$ref":"#/components/schemas/V1ClientInitPostRequestBodyContentApplicationJsonSchemaOneOf2IdentityProof1"}],"description":"Customer-native auth proof for the Identity Exchange, as a bare token string or the `{ provider, token }` object `/v1/client/chat` accepts. The integration is selected by the verified issuer, not by `provider`: in the object form `provider` is a consistency hint (a hint that disagrees with the matched integration is rejected), and the bare string carries no hint. A Runtype-hosted `rt_eu_` token is sent as the bare string.","title":"V1ClientInitPostRequestBodyContentApplicationJsonSchemaOneOf2IdentityProof"},"ClientRuntimeInitializeAClientSessionRequest2":{"type":"object","properties":{"conversationId":{"type":"string"},"durableRecovery":{"type":"boolean"},"flowId":{"type":"string"},"identityProof":{"$ref":"#/components/schemas/V1ClientInitPostRequestBodyContentApplicationJsonSchemaOneOf2IdentityProof","description":"Customer-native auth proof for the Identity Exchange, as a bare token string or the `{ provider, token }` object `/v1/client/chat` accepts. The integration is selected by the verified issuer, not by `provider`: in the object form `provider` is a consistency hint (a hint that disagrees with the matched integration is rejected), and the bare string carries no hint. A Runtype-hosted `rt_eu_` token is sent as the bare string."},"token":{"type":"string","minLength":1},"visitorHistory":{"type":"boolean"},"visitorToken":{"type":"string","minLength":1,"maxLength":200}},"required":["conversationId","token","visitorToken"],"title":"ClientRuntimeInitializeAClientSessionRequest2"},"V1ClientInitPostRequestBodyContentApplicationJsonSchemaOneOf3IdentityProof1":{"type":"object","properties":{"provider":{"type":"string","minLength":1,"maxLength":64},"token":{"type":"string","minLength":1,"maxLength":8192}},"required":["provider","token"],"description":"Customer-native auth proof for the Identity Exchange. When present and the surface has a matching integration, the verified tenant/end-user replace any body-asserted tenant/endUser (which are never trusted for web-embedded callers). A proof that fails verification is rejected with 401 `invalid_identity_proof`.","title":"V1ClientInitPostRequestBodyContentApplicationJsonSchemaOneOf3IdentityProof1"},"V1ClientInitPostRequestBodyContentApplicationJsonSchemaOneOf3IdentityProof":{"oneOf":[{"type":"string","minLength":1,"maxLength":8192},{"$ref":"#/components/schemas/V1ClientInitPostRequestBodyContentApplicationJsonSchemaOneOf3IdentityProof1"}],"description":"Customer-native auth proof for the Identity Exchange, as a bare token string or the `{ provider, token }` object `/v1/client/chat` accepts. The integration is selected by the verified issuer, not by `provider`: in the object form `provider` is a consistency hint (a hint that disagrees with the matched integration is rejected), and the bare string carries no hint. A Runtype-hosted `rt_eu_` token is sent as the bare string.","title":"V1ClientInitPostRequestBodyContentApplicationJsonSchemaOneOf3IdentityProof"},"ClientRuntimeInitializeAClientSessionRequest3":{"type":"object","properties":{"conversationId":{"type":"string"},"durableRecovery":{"type":"boolean"},"flowId":{"type":"string"},"identityProof":{"$ref":"#/components/schemas/V1ClientInitPostRequestBodyContentApplicationJsonSchemaOneOf3IdentityProof","description":"Customer-native auth proof for the Identity Exchange, as a bare token string or the `{ provider, token }` object `/v1/client/chat` accepts. The integration is selected by the verified issuer, not by `provider`: in the object form `provider` is a consistency hint (a hint that disagrees with the matched integration is rejected), and the bare string carries no hint. A Runtype-hosted `rt_eu_` token is sent as the bare string."},"token":{"type":"string","minLength":1},"visitorHistory":{"type":"boolean"},"visitorToken":{"type":"string","minLength":1,"maxLength":200}},"required":["conversationId","identityProof","token"],"title":"ClientRuntimeInitializeAClientSessionRequest3"},"Client_Runtime_initializeAClientSession_Request":{"oneOf":[{"$ref":"#/components/schemas/ClientRuntimeInitializeAClientSessionRequest0"},{"$ref":"#/components/schemas/ClientRuntimeInitializeAClientSessionRequest1"},{"$ref":"#/components/schemas/ClientRuntimeInitializeAClientSessionRequest2"},{"$ref":"#/components/schemas/ClientRuntimeInitializeAClientSessionRequest3"}],"title":"Client Runtime_initializeAClientSession_Request"},"V1ClientInitPostResponsesContentApplicationJsonSchemaApp":{"type":"object","properties":{"id":{"type":"string","description":"Runtype App id backing this session."}},"required":["id"],"description":"Present instead of `flow` for a Runtype App token whose manifest declares record namespaces but no flows or agents. Exactly one of `flow` and `app` is returned.","title":"V1ClientInitPostResponsesContentApplicationJsonSchemaApp"},"V1ClientInitPostResponsesContentApplicationJsonSchemaConfigWebmcp":{"type":"object","properties":{"requireConfirmFor":{"type":"array","items":{"type":"string"},"description":"The bound chat surface's `behavior.webmcp.requireConfirmFor` patterns. A client must show its confirmation for a matching page tool even when its own auto-approval policy would skip it. This is client-side behavior, not a server-enforced boundary."}},"required":["requireConfirmFor"],"description":"Present only when the bound chat surface enables WebMCP and lists `requireConfirmFor` patterns.","title":"V1ClientInitPostResponsesContentApplicationJsonSchemaConfigWebmcp"},"V1ClientInitPostResponsesContentApplicationJsonSchemaConfig":{"type":"object","properties":{"placeholder":{"type":"string","description":"Composer placeholder text. Defaults to 'Type your message...' when the client token sets none."},"theme":{"description":"Persona theme tokens stored on the client token, passed through verbatim. Null when unthemed."},"webmcp":{"$ref":"#/components/schemas/V1ClientInitPostResponsesContentApplicationJsonSchemaConfigWebmcp","description":"Present only when the bound chat surface enables WebMCP and lists `requireConfirmFor` patterns."},"welcomeMessage":{"type":["string","null"],"description":"Opening message to render before the visitor's first turn. Null when the client token sets none."}},"required":["placeholder","welcomeMessage"],"description":"Widget display config, read from the client token's stored config. Always returned, with null standing in for an unset welcome message or theme.","title":"V1ClientInitPostResponsesContentApplicationJsonSchemaConfig"},"V1ClientInitPostResponsesContentApplicationJsonSchemaDurableRecovery":{"type":"object","properties":{"enabled":{"type":"boolean","description":"Whether this initialized client-token session has the visitor credential and the durable-turns opt-in needed to use the durable execution reconnect route. The opt-in is the chat surface `behavior.durableTurns.enabled` for a surface-bound token and `config.durableTurns.enabled` for a standalone token. Reporting only: individual turns still self-identify as durable through replay cursors."},"steer":{"type":"boolean","description":"Whether the native durable target supports non-interrupting user-message delivery."}},"required":["enabled"],"description":"Returned when the request negotiates `durableRecovery`. Older servers omit it; clients must then keep ordinary streaming behavior.","title":"V1ClientInitPostResponsesContentApplicationJsonSchemaDurableRecovery"},"V1ClientInitPostResponsesContentApplicationJsonSchemaFlow":{"type":"object","properties":{"description":{"type":["string","null"],"description":"Flow description, null when the flow has none. Flow sessions only."},"id":{"type":"string","description":"Resolved flow or agent ID for this session."},"name":{"type":"string","description":"Flow name. Present only for a flow session; the agent branch returns `id` alone because the widget does not render either field."}},"required":["id"],"description":"Resolved flow or agent for this session. Present on every response except the data-only Runtype App branch, which returns `app` instead. Retained for compatibility: `id` always carries the same value as the canonical top-level `targetId`, which new clients should read instead.","title":"V1ClientInitPostResponsesContentApplicationJsonSchemaFlow"},"V1ClientInitPostResponsesContentApplicationJsonSchemaRealtime":{"type":"object","properties":{"protocol":{"type":"string","description":"The client session socket protocol, `runtype-client-session-v1`."},"url":{"type":"string","description":"The `wss://` URL to open. Add `protocol`, `sessionId` and `clientVersion` query parameters and offer `runtype.bearer`, the client token and the visitor credential as WebSocket subprotocols."}},"required":["protocol","url"],"description":"Present when this conversation can receive its turns on the client session socket. Send `delivery: \"socket\"` on chat and resume to use it. Without this field, stream over Server-Sent Events.","title":"V1ClientInitPostResponsesContentApplicationJsonSchemaRealtime"},"V1ClientInitPostResponsesContentApplicationJsonSchemaVisitorIdentityStatus":{"type":"string","enum":["not_provided","admitted","ignored"],"description":"What the server did with a supplied `identityProof` on THIS request. `not_provided`: none was sent. `admitted`: it was verified and produced the end-user scope. `ignored`: no longer emitted, because every token owner now evaluates a supplied proof; it stays in the enum for older clients. An invalid proof fails init with 401 `invalid_identity_proof`. Reporting only: it confers no authority and carries no identity value.","title":"V1ClientInitPostResponsesContentApplicationJsonSchemaVisitorIdentityStatus"},"V1ClientInitPostResponsesContentApplicationJsonSchemaVisitor":{"type":"object","properties":{"endUserId":{"type":["string","null"],"description":"The verified end user (`eu_…`) this browser is bound to, when an `identityProof` was admitted. Null while anonymous. Cross-device reads still require a fresh `identityProof` on that request; the stored binding alone remains exact-browser scoped."},"expiresAt":{"type":"string","description":"ISO-8601 sliding idle-expiry for this visitor."},"id":{"type":"string","description":"Durable anonymous visitor id (`cvis_…`)."},"identityStatus":{"$ref":"#/components/schemas/V1ClientInitPostResponsesContentApplicationJsonSchemaVisitorIdentityStatus","description":"What the server did with a supplied `identityProof` on THIS request. `not_provided`: none was sent. `admitted`: it was verified and produced the end-user scope. `ignored`: no longer emitted, because every token owner now evaluates a supplied proof; it stays in the enum for older clients. An invalid proof fails init with 401 `invalid_identity_proof`. Reporting only: it confers no authority and carries no identity value."},"token":{"type":"string","description":"The raw visitor secret (`cvt_…`). Returned ONLY when this init newly mints a visitor. Store it and send it back as `visitorToken` on the next init; it is unrecoverable afterwards. Reset itself returns no replacement; the next history-capable init mints one."}},"required":["endUserId","expiresAt","id","identityStatus"],"description":"The browser's anonymous visitor identity. Present when the request opts into visitor history (or supplies a visitor token, identity proof, or conversation id). Authenticates the `/client/conversations*` history routes, which the site-wide client token alone cannot reach.","title":"V1ClientInitPostResponsesContentApplicationJsonSchemaVisitor"},"Client_Runtime_initializeAClientSession_Response_200":{"type":"object","properties":{"app":{"$ref":"#/components/schemas/V1ClientInitPostResponsesContentApplicationJsonSchemaApp","description":"Present instead of `flow` for a Runtype App token whose manifest declares record namespaces but no flows or agents. Exactly one of `flow` and `app` is returned."},"config":{"$ref":"#/components/schemas/V1ClientInitPostResponsesContentApplicationJsonSchemaConfig","description":"Widget display config, read from the client token's stored config. Always returned, with null standing in for an unset welcome message or theme."},"conversationId":{"type":"string","description":"The durable conversation record this session reads and writes. Returned by every successful branch — a fresh mint, a legacy `sessionId` replay, and a `conversationId` resume all report the record they landed on. Persist THIS rather than the session id: a session is short-lived, the conversation is what a returning browser reopens. It is not a credential; history access is still scoped by the visitor secret."},"conversationRevision":{"type":"string","description":"Opaque change token for `conversationId` at the moment this session was created. Compare it for equality and nothing else — it is unordered and unparseable. It changes on every transcript mutation, including a display-projection finalization that deliberately leaves `updatedAt` untouched, so a second device or a reloaded tab can tell whether the transcript it holds is still current."},"durableRecovery":{"$ref":"#/components/schemas/V1ClientInitPostResponsesContentApplicationJsonSchemaDurableRecovery","description":"Returned when the request negotiates `durableRecovery`. Older servers omit it; clients must then keep ordinary streaming behavior."},"expiresAt":{"type":"string","description":"ISO-8601 session idle-expiry timestamp."},"flow":{"$ref":"#/components/schemas/V1ClientInitPostResponsesContentApplicationJsonSchemaFlow","description":"Resolved flow or agent for this session. Present on every response except the data-only Runtype App branch, which returns `app` instead. Retained for compatibility: `id` always carries the same value as the canonical top-level `targetId`, which new clients should read instead."},"realtime":{"$ref":"#/components/schemas/V1ClientInitPostResponsesContentApplicationJsonSchemaRealtime","description":"Present when this conversation can receive its turns on the client session socket. Send `delivery: \"socket\"` on chat and resume to use it. Without this field, stream over Server-Sent Events."},"sessionId":{"type":"string","description":"The created (or resumed) client session ID."},"targetId":{"type":"string","description":"The flow or agent this session executes against, resolved server-side. Canonical replacement for `flow.id`, and the exact key to pass as `targetId` when listing or deleting this conversation's history. Matches the value stored on the conversation record; an agent-only token resolves to its agent id. Absent only on the data-only Runtype App branch, which is not chat-capable."},"visitor":{"$ref":"#/components/schemas/V1ClientInitPostResponsesContentApplicationJsonSchemaVisitor","description":"The browser's anonymous visitor identity. Present when the request opts into visitor history (or supplies a visitor token, identity proof, or conversation id). Authenticates the `/client/conversations*` history routes, which the site-wide client token alone cannot reach."}},"required":["config","conversationId","conversationRevision","expiresAt","sessionId"],"title":"Client Runtime_initializeAClientSession_Response_200"},"V1ClientInitPostResponsesContentApplicationJsonSchemaDetailsItems":{"type":"object","properties":{"code":{"type":"string","description":"Stable Runtype validation code (e.g. MISSING_REQUIRED_FIELD, INVALID_ENUM)."},"message":{"type":"string"},"path":{"type":"string","description":"Dotted JSON path to the offending field."},"suggestion":{"type":"string","description":"Actionable hint (allowed values, accepted range, …)."}},"required":["message"],"title":"V1ClientInitPostResponsesContentApplicationJsonSchemaDetailsItems"},"InitializeAClientSessionRequestUnauthorizedError":{"type":"object","properties":{"code":{"type":"string","description":"Stable error code. `insufficient_scope` marks an API key that lacks a scope this request needs."},"details":{"type":"array","items":{"$ref":"#/components/schemas/V1ClientInitPostResponsesContentApplicationJsonSchemaDetailsItems"}},"error":{"type":"string"},"requiredScopes":{"type":"array","items":{"type":"string"},"description":"On `insufficient_scope`: every API key scope this request needs."},"errorDescription":{"type":"string","description":"Why the supplied `identityProof` was refused (for example an expired assertion, an unknown issuer, or a proof minted for another tenant). Diagnostic text for the embedding site, not a value to branch on."}},"required":["error"],"title":"InitializeAClientSessionRequestUnauthorizedError"},"V1ClientResumePostRequestBodyContentApplicationJsonSchemaClientToolsItemsAnnotations":{"type":"object","properties":{"consequentialHint":{"type":"boolean"},"debugging":{"type":"boolean"},"destructiveHint":{"type":"boolean"},"idempotentHint":{"type":"boolean"},"openWorldHint":{"type":"boolean"},"readOnlyHint":{"type":"boolean"},"untrustedContentHint":{"type":"boolean"}},"title":"V1ClientResumePostRequestBodyContentApplicationJsonSchemaClientToolsItemsAnnotations"},"V1ClientResumePostRequestBodyContentApplicationJsonSchemaClientToolsItemsOrigin":{"type":"string","enum":["webmcp","sdk"],"title":"V1ClientResumePostRequestBodyContentApplicationJsonSchemaClientToolsItemsOrigin"},"V1ClientResumePostRequestBodyContentApplicationJsonSchemaClientToolsItemsParametersSchemaType":{"type":"string","enum":["object"],"title":"V1ClientResumePostRequestBodyContentApplicationJsonSchemaClientToolsItemsParametersSchemaType"},"V1ClientResumePostRequestBodyContentApplicationJsonSchemaClientToolsItemsParametersSchema":{"type":"object","properties":{"type":{"$ref":"#/components/schemas/V1ClientResumePostRequestBodyContentApplicationJsonSchemaClientToolsItemsParametersSchemaType"}},"required":["type"],"title":"V1ClientResumePostRequestBodyContentApplicationJsonSchemaClientToolsItemsParametersSchema"},"V1ClientResumePostRequestBodyContentApplicationJsonSchemaClientToolsItems":{"type":"object","properties":{"annotations":{"$ref":"#/components/schemas/V1ClientResumePostRequestBodyContentApplicationJsonSchemaClientToolsItemsAnnotations"},"description":{"type":"string","minLength":1},"name":{"type":"string","minLength":1},"origin":{"$ref":"#/components/schemas/V1ClientResumePostRequestBodyContentApplicationJsonSchemaClientToolsItemsOrigin"},"pageOrigin":{"type":"string"},"parametersSchema":{"$ref":"#/components/schemas/V1ClientResumePostRequestBodyContentApplicationJsonSchemaClientToolsItemsParametersSchema"},"untrustedContentHint":{"type":"boolean"}},"required":["description","name","parametersSchema"],"title":"V1ClientResumePostRequestBodyContentApplicationJsonSchemaClientToolsItems"},"V1ClientResumePostRequestBodyContentApplicationJsonSchemaDelivery":{"type":"string","enum":["socket"],"description":"Set to `socket` to receive the resumed turn on the client session socket. When the server honors it, the response is `202 {executionId, conversationId, delivery: \"socket\"}`. Otherwise the resumed turn streams as usual.","title":"V1ClientResumePostRequestBodyContentApplicationJsonSchemaDelivery"},"V1ClientResumePostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1ItemsOneOf0Type":{"type":"string","enum":["text"],"title":"V1ClientResumePostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1ItemsOneOf0Type"},"V1ClientResumePostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1Items0":{"type":"object","properties":{"text":{"type":"string"},"type":{"$ref":"#/components/schemas/V1ClientResumePostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1ItemsOneOf0Type"}},"required":["text","type"],"title":"V1ClientResumePostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1Items0"},"V1ClientResumePostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1ItemsOneOf1Type":{"type":"string","enum":["image"],"title":"V1ClientResumePostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1ItemsOneOf1Type"},"V1ClientResumePostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1Items1":{"type":"object","properties":{"image":{"type":"string"},"mimeType":{"type":"string"},"type":{"$ref":"#/components/schemas/V1ClientResumePostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1ItemsOneOf1Type"}},"required":["image","type"],"title":"V1ClientResumePostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1Items1"},"V1ClientResumePostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1ItemsOneOf2Type":{"type":"string","enum":["file"],"title":"V1ClientResumePostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1ItemsOneOf2Type"},"V1ClientResumePostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1Items2":{"type":"object","properties":{"data":{"type":"string"},"filename":{"type":"string"},"mimeType":{"type":"string"},"type":{"$ref":"#/components/schemas/V1ClientResumePostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1ItemsOneOf2Type"}},"required":["data","filename","mimeType","type"],"title":"V1ClientResumePostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1Items2"},"V1ClientResumePostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1ItemsOneOf3Type":{"type":"string","enum":["reasoning"],"title":"V1ClientResumePostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1ItemsOneOf3Type"},"V1ClientResumePostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1Items3":{"type":"object","properties":{"providerOptions":{"type":"object","additionalProperties":{"description":"Any type"}},"text":{"type":"string"},"type":{"$ref":"#/components/schemas/V1ClientResumePostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1ItemsOneOf3Type"}},"required":["text","type"],"title":"V1ClientResumePostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1Items3"},"V1ClientResumePostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1Items":{"oneOf":[{"$ref":"#/components/schemas/V1ClientResumePostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1Items0"},{"$ref":"#/components/schemas/V1ClientResumePostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1Items1"},{"$ref":"#/components/schemas/V1ClientResumePostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1Items2"},{"$ref":"#/components/schemas/V1ClientResumePostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1Items3"}],"title":"V1ClientResumePostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1Items"},"V1ClientResumePostRequestBodyContentApplicationJsonSchemaMessagesItemsContent1":{"type":"array","items":{"$ref":"#/components/schemas/V1ClientResumePostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1Items"},"title":"V1ClientResumePostRequestBodyContentApplicationJsonSchemaMessagesItemsContent1"},"V1ClientResumePostRequestBodyContentApplicationJsonSchemaMessagesItemsContent":{"oneOf":[{"type":"string","minLength":1},{"$ref":"#/components/schemas/V1ClientResumePostRequestBodyContentApplicationJsonSchemaMessagesItemsContent1"}],"title":"V1ClientResumePostRequestBodyContentApplicationJsonSchemaMessagesItemsContent"},"V1ClientResumePostRequestBodyContentApplicationJsonSchemaMessagesItemsRole":{"type":"string","enum":["system","user","assistant"],"title":"V1ClientResumePostRequestBodyContentApplicationJsonSchemaMessagesItemsRole"},"V1ClientResumePostRequestBodyContentApplicationJsonSchemaMessagesItems":{"type":"object","properties":{"content":{"$ref":"#/components/schemas/V1ClientResumePostRequestBodyContentApplicationJsonSchemaMessagesItemsContent"},"role":{"$ref":"#/components/schemas/V1ClientResumePostRequestBodyContentApplicationJsonSchemaMessagesItemsRole"}},"required":["content","role"],"title":"V1ClientResumePostRequestBodyContentApplicationJsonSchemaMessagesItems"},"Client_Runtime_resetTheCurrentBrowserVisitor_Response_200":{"type":"object","properties":{"reset":{"type":"boolean","description":"Always true after the reset request is accepted, including when the supplied visitor was already expired or revoked."}},"required":["reset"],"title":"Client Runtime_resetTheCurrentBrowserVisitor_Response_200"},"V1CollectionsGetParametersView":{"type":"string","enum":["full","compact"],"description":"Response representation. `full` (default) preserves complete values; `compact` shortens every string value longer than 100 characters to a 100-character preview followed by `…`.","title":"V1CollectionsGetParametersView"},"V1CollectionsGetResponsesContentApplicationJsonSchemaDataItemsValidationMode":{"type":"string","enum":["off","warn","enforce"],"title":"V1CollectionsGetResponsesContentApplicationJsonSchemaDataItemsValidationMode"},"V1CollectionsGetResponsesContentApplicationJsonSchemaDataItems":{"type":"object","properties":{"createdAt":{"type":"string"},"description":{"type":["string","null"]},"displayName":{"type":"string"},"icon":{"type":["string","null"]},"id":{"type":"string"},"indexedFields":{"type":"array","items":{"type":"string"}},"lastModifiedSource":{"type":["string","null"],"description":"Who last wrote the definition (e.g. dashboard, api, sdk); sdk/terraform mean managed in code."},"recordCount":{"type":"integer"},"schema":{"type":["object","null"],"additionalProperties":{"description":"Any type"},"description":"Constrained JSON Schema dialect: root object with string/number/boolean/array/object properties, one nesting level, no $ref/oneOf/pattern"},"schemaVersion":{"type":"integer"},"slug":{"type":"string"},"updatedAt":{"type":"string"},"validationMode":{"$ref":"#/components/schemas/V1CollectionsGetResponsesContentApplicationJsonSchemaDataItemsValidationMode"}},"required":["createdAt","description","displayName","icon","id","indexedFields","lastModifiedSource","schema","schemaVersion","slug","updatedAt","validationMode"],"title":"V1CollectionsGetResponsesContentApplicationJsonSchemaDataItems"},"V1CollectionsGetResponsesContentApplicationJsonSchemaPagination":{"type":"object","properties":{"hasMore":{"type":"boolean"},"nextCursor":{"type":["string","null"]}},"required":["hasMore","nextCursor"],"title":"V1CollectionsGetResponsesContentApplicationJsonSchemaPagination"},"Collections_listCollections_Response_200":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1CollectionsGetResponsesContentApplicationJsonSchemaDataItems"}},"pagination":{"$ref":"#/components/schemas/V1CollectionsGetResponsesContentApplicationJsonSchemaPagination"}},"required":["data","pagination"],"title":"Collections_listCollections_Response_200"},"V1CollectionsPostRequestBodyContentApplicationJsonSchemaValidationMode":{"type":"string","enum":["off","warn","enforce"],"title":"V1CollectionsPostRequestBodyContentApplicationJsonSchemaValidationMode"},"V1CollectionsPostResponsesContentApplicationJsonSchemaValidationMode":{"type":"string","enum":["off","warn","enforce"],"title":"V1CollectionsPostResponsesContentApplicationJsonSchemaValidationMode"},"Collections_createACollection_Response_201":{"type":"object","properties":{"createdAt":{"type":"string"},"description":{"type":["string","null"]},"displayName":{"type":"string"},"icon":{"type":["string","null"]},"id":{"type":"string"},"indexedFields":{"type":"array","items":{"type":"string"}},"lastModifiedSource":{"type":["string","null"],"description":"Who last wrote the definition (e.g. dashboard, api, sdk); sdk/terraform mean managed in code."},"recordCount":{"type":"integer"},"schema":{"type":["object","null"],"additionalProperties":{"description":"Any type"},"description":"Constrained JSON Schema dialect: root object with string/number/boolean/array/object properties, one nesting level, no $ref/oneOf/pattern"},"schemaVersion":{"type":"integer"},"slug":{"type":"string"},"updatedAt":{"type":"string"},"validationMode":{"$ref":"#/components/schemas/V1CollectionsPostResponsesContentApplicationJsonSchemaValidationMode"}},"required":["createdAt","description","displayName","icon","id","indexedFields","lastModifiedSource","schema","schemaVersion","slug","updatedAt","validationMode"],"title":"Collections_createACollection_Response_201"},"V1CollectionsPostResponsesContentApplicationJsonSchemaDetailsItems":{"type":"object","properties":{"code":{"type":"string","description":"Stable Runtype validation code (e.g. MISSING_REQUIRED_FIELD, INVALID_ENUM)."},"message":{"type":"string"},"path":{"type":"string","description":"Dotted JSON path to the offending field."},"suggestion":{"type":"string","description":"Actionable hint (allowed values, accepted range, …)."}},"required":["message"],"title":"V1CollectionsPostResponsesContentApplicationJsonSchemaDetailsItems"},"CreateACollectionRequestBadRequestError":{"type":"object","properties":{"code":{"type":"string","description":"Stable error code. `insufficient_scope` marks an API key that lacks a scope this request needs."},"details":{"type":"array","items":{"$ref":"#/components/schemas/V1CollectionsPostResponsesContentApplicationJsonSchemaDetailsItems"}},"error":{"type":"string"},"requiredScopes":{"type":"array","items":{"type":"string"},"description":"On `insufficient_scope`: every API key scope this request needs."}},"required":["error"],"title":"CreateACollectionRequestBadRequestError"},"CreateACollectionRequestConflictError":{"type":"object","properties":{"code":{"type":"string","description":"Stable error code. `insufficient_scope` marks an API key that lacks a scope this request needs."},"details":{"type":"array","items":{"$ref":"#/components/schemas/V1CollectionsPostResponsesContentApplicationJsonSchemaDetailsItems"}},"error":{"type":"string"},"requiredScopes":{"type":"array","items":{"type":"string"},"description":"On `insufficient_scope`: every API key scope this request needs."}},"required":["error"],"title":"CreateACollectionRequestConflictError"},"V1CollectionsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionValidationMode":{"type":"string","enum":["off","warn","enforce"],"title":"V1CollectionsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionValidationMode"},"V1CollectionsEnsurePostRequestBodyContentApplicationJsonSchemaDefinition":{"type":"object","properties":{"description":{"type":["string","null"],"maxLength":4000},"displayName":{"type":"string","minLength":1,"maxLength":255},"icon":{"type":["string","null"],"maxLength":64},"schema":{"type":["object","null"],"additionalProperties":{"description":"Any type"},"description":"Constrained JSON Schema dialect: root object with string/number/boolean/array/object properties, one nesting level, no $ref/oneOf/pattern"},"slug":{"type":"string","minLength":1,"maxLength":255},"validationMode":{"$ref":"#/components/schemas/V1CollectionsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionValidationMode"}},"required":["displayName","slug"],"title":"V1CollectionsEnsurePostRequestBodyContentApplicationJsonSchemaDefinition"},"V1CollectionsEnsurePostRequestBodyContentApplicationJsonSchemaOnConflict":{"type":"string","enum":["error","overwrite"],"title":"V1CollectionsEnsurePostRequestBodyContentApplicationJsonSchemaOnConflict"},"CollectionEnsureResponseOneOf0EnforceCheck":{"type":"object","properties":{"checked":{"type":"integer"},"failed":{"type":"integer"},"truncated":{"type":"boolean"}},"required":["checked","failed","truncated"],"description":"Present when this ensure moved validationMode to enforce: a bounded dry-run of existing records against the schema, as PATCH reports.","title":"CollectionEnsureResponseOneOf0EnforceCheck"},"CollectionEnsureResponseOneOf0Result":{"type":"string","enum":["unchanged","created","updated"],"title":"CollectionEnsureResponseOneOf0Result"},"CollectionEnsureResponseOneOf0SchemaChangeKind":{"type":"string","enum":["additive","breaking"],"title":"CollectionEnsureResponseOneOf0SchemaChangeKind"},"CollectionEnsureResponseOneOf0SchemaChange":{"type":"object","properties":{"breakingChanges":{"type":"array","items":{"type":"string"}},"kind":{"$ref":"#/components/schemas/CollectionEnsureResponseOneOf0SchemaChangeKind"}},"required":["breakingChanges","kind"],"title":"CollectionEnsureResponseOneOf0SchemaChange"},"CollectionEnsureResponse0":{"type":"object","properties":{"collectionId":{"type":"string"},"contentHash":{"type":"string","description":"Server-computed canonical content hash. Clients should echo this hash in probes."},"enforceCheck":{"$ref":"#/components/schemas/CollectionEnsureResponseOneOf0EnforceCheck","description":"Present when this ensure moved validationMode to enforce: a bounded dry-run of existing records against the schema, as PATCH reports."},"result":{"$ref":"#/components/schemas/CollectionEnsureResponseOneOf0Result"},"schemaChange":{"$ref":"#/components/schemas/CollectionEnsureResponseOneOf0SchemaChange"}},"required":["collectionId","contentHash","result"],"title":"CollectionEnsureResponse0"},"CollectionEnsureResponseOneOf1Result":{"type":"string","enum":["definitionRequired"],"title":"CollectionEnsureResponseOneOf1Result"},"CollectionEnsureResponse1":{"type":"object","properties":{"result":{"$ref":"#/components/schemas/CollectionEnsureResponseOneOf1Result"}},"required":["result"],"title":"CollectionEnsureResponse1"},"CollectionEnsureResponseOneOf2Changes":{"type":"string","enum":["none","create","update"],"title":"CollectionEnsureResponseOneOf2Changes"},"CollectionEnsureResponseOneOf2Result":{"type":"string","enum":["plan"],"title":"CollectionEnsureResponseOneOf2Result"},"CollectionEnsureResponseOneOf2SchemaChangeKind":{"type":"string","enum":["additive","breaking"],"title":"CollectionEnsureResponseOneOf2SchemaChangeKind"},"CollectionEnsureResponseOneOf2SchemaChange":{"type":"object","properties":{"breakingChanges":{"type":"array","items":{"type":"string"}},"kind":{"$ref":"#/components/schemas/CollectionEnsureResponseOneOf2SchemaChangeKind"}},"required":["breakingChanges","kind"],"description":"How the schema would change. A breaking change is rejected when the resulting validationMode is enforce.","title":"CollectionEnsureResponseOneOf2SchemaChange"},"CollectionEnsureResponse2":{"type":"object","properties":{"changedKeys":{"type":"array","items":{"type":"string"}},"changes":{"$ref":"#/components/schemas/CollectionEnsureResponseOneOf2Changes"},"collectionId":{"type":"string"},"contentHash":{"type":"string"},"remoteHash":{"type":"string"},"result":{"$ref":"#/components/schemas/CollectionEnsureResponseOneOf2Result"},"schemaChange":{"$ref":"#/components/schemas/CollectionEnsureResponseOneOf2SchemaChange","description":"How the schema would change. A breaking change is rejected when the resulting validationMode is enforce."}},"required":["changedKeys","changes","contentHash","result"],"title":"CollectionEnsureResponse2"},"CollectionEnsureResponse":{"oneOf":[{"$ref":"#/components/schemas/CollectionEnsureResponse0"},{"$ref":"#/components/schemas/CollectionEnsureResponse1"},{"$ref":"#/components/schemas/CollectionEnsureResponse2"}],"title":"CollectionEnsureResponse"},"V1CollectionsEnsurePostResponsesContentApplicationJsonSchemaDetailsItems":{"type":"object","properties":{"code":{"type":"string","description":"Stable Runtype validation code (e.g. MISSING_REQUIRED_FIELD, INVALID_ENUM)."},"message":{"type":"string"},"path":{"type":"string","description":"Dotted JSON path to the offending field."},"suggestion":{"type":"string","description":"Actionable hint (allowed values, accepted range, …)."}},"required":["message"],"title":"V1CollectionsEnsurePostResponsesContentApplicationJsonSchemaDetailsItems"},"EnsureCollectionConfigAsCodeConvergeRequestBadRequestError":{"type":"object","properties":{"code":{"type":"string","description":"Stable error code. `insufficient_scope` marks an API key that lacks a scope this request needs."},"details":{"type":"array","items":{"$ref":"#/components/schemas/V1CollectionsEnsurePostResponsesContentApplicationJsonSchemaDetailsItems"}},"error":{"type":"string"},"requiredScopes":{"type":"array","items":{"type":"string"},"description":"On `insufficient_scope`: every API key scope this request needs."}},"required":["error"],"title":"EnsureCollectionConfigAsCodeConvergeRequestBadRequestError"},"CollectionEnsureConflictCode":{"type":"string","enum":["external_modification","remote_changed"],"title":"CollectionEnsureConflictCode"},"CollectionEnsureConflict":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/CollectionEnsureConflictCode"},"currentHash":{"type":["string","null"]},"error":{"type":"string"},"lastModifiedSource":{"type":"string"},"modifiedAt":{"type":["string","null"]}},"required":["code","error"],"title":"CollectionEnsureConflict"},"CollectionEnsureHashMismatchCode":{"type":"string","enum":["content_hash_mismatch"],"title":"CollectionEnsureHashMismatchCode"},"CollectionEnsureHashMismatch":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/CollectionEnsureHashMismatchCode"},"contentHash":{"type":"string","description":"The server-computed canonical hash of the submitted definition."},"error":{"type":"string"}},"required":["code","contentHash","error"],"title":"CollectionEnsureHashMismatch"},"V1CollectionsSlugGetResponsesContentApplicationJsonSchemaHistoryItemsChangeKind":{"type":"string","enum":["additive","breaking"],"title":"V1CollectionsSlugGetResponsesContentApplicationJsonSchemaHistoryItemsChangeKind"},"V1CollectionsSlugGetResponsesContentApplicationJsonSchemaHistoryItems":{"type":"object","properties":{"changeKind":{"$ref":"#/components/schemas/V1CollectionsSlugGetResponsesContentApplicationJsonSchemaHistoryItemsChangeKind"},"changedBy":{"type":["string","null"]},"createdAt":{"type":"string"},"schema":{"type":["object","null"],"additionalProperties":{"description":"Any type"},"description":"Constrained JSON Schema dialect: root object with string/number/boolean/array/object properties, one nesting level, no $ref/oneOf/pattern"},"version":{"type":"integer"}},"required":["changeKind","changedBy","createdAt","schema","version"],"title":"V1CollectionsSlugGetResponsesContentApplicationJsonSchemaHistoryItems"},"V1CollectionsSlugGetResponsesContentApplicationJsonSchemaValidationMode":{"type":"string","enum":["off","warn","enforce"],"title":"V1CollectionsSlugGetResponsesContentApplicationJsonSchemaValidationMode"},"Collections_getACollection_Response_200":{"type":"object","properties":{"createdAt":{"type":"string"},"description":{"type":["string","null"]},"displayName":{"type":"string"},"history":{"type":"array","items":{"$ref":"#/components/schemas/V1CollectionsSlugGetResponsesContentApplicationJsonSchemaHistoryItems"}},"icon":{"type":["string","null"]},"id":{"type":"string"},"indexedFields":{"type":"array","items":{"type":"string"}},"lastModifiedSource":{"type":["string","null"],"description":"Who last wrote the definition (e.g. dashboard, api, sdk); sdk/terraform mean managed in code."},"recordCount":{"type":"integer"},"schema":{"type":["object","null"],"additionalProperties":{"description":"Any type"},"description":"Constrained JSON Schema dialect: root object with string/number/boolean/array/object properties, one nesting level, no $ref/oneOf/pattern"},"schemaVersion":{"type":"integer"},"slug":{"type":"string"},"updatedAt":{"type":"string"},"validationMode":{"$ref":"#/components/schemas/V1CollectionsSlugGetResponsesContentApplicationJsonSchemaValidationMode"}},"required":["createdAt","description","displayName","icon","id","indexedFields","lastModifiedSource","schema","schemaVersion","slug","updatedAt","validationMode"],"title":"Collections_getACollection_Response_200"},"Collections_deleteACollection_Response_200":{"type":"object","properties":{"success":{"type":"boolean"}},"required":["success"],"title":"Collections_deleteACollection_Response_200"},"V1CollectionsSlugPatchRequestBodyContentApplicationJsonSchemaValidationMode":{"type":"string","enum":["off","warn","enforce"],"title":"V1CollectionsSlugPatchRequestBodyContentApplicationJsonSchemaValidationMode"},"V1CollectionsSlugPatchResponsesContentApplicationJsonSchemaCollectionValidationMode":{"type":"string","enum":["off","warn","enforce"],"title":"V1CollectionsSlugPatchResponsesContentApplicationJsonSchemaCollectionValidationMode"},"V1CollectionsSlugPatchResponsesContentApplicationJsonSchemaCollection":{"type":"object","properties":{"createdAt":{"type":"string"},"description":{"type":["string","null"]},"displayName":{"type":"string"},"icon":{"type":["string","null"]},"id":{"type":"string"},"indexedFields":{"type":"array","items":{"type":"string"}},"lastModifiedSource":{"type":["string","null"],"description":"Who last wrote the definition (e.g. dashboard, api, sdk); sdk/terraform mean managed in code."},"recordCount":{"type":"integer"},"schema":{"type":["object","null"],"additionalProperties":{"description":"Any type"},"description":"Constrained JSON Schema dialect: root object with string/number/boolean/array/object properties, one nesting level, no $ref/oneOf/pattern"},"schemaVersion":{"type":"integer"},"slug":{"type":"string"},"updatedAt":{"type":"string"},"validationMode":{"$ref":"#/components/schemas/V1CollectionsSlugPatchResponsesContentApplicationJsonSchemaCollectionValidationMode"}},"required":["createdAt","description","displayName","icon","id","indexedFields","lastModifiedSource","schema","schemaVersion","slug","updatedAt","validationMode"],"title":"V1CollectionsSlugPatchResponsesContentApplicationJsonSchemaCollection"},"V1CollectionsSlugPatchResponsesContentApplicationJsonSchemaEnforceCheck":{"type":"object","properties":{"checked":{"type":"integer"},"failed":{"type":"integer"},"truncated":{"type":"boolean"}},"required":["checked","failed","truncated"],"title":"V1CollectionsSlugPatchResponsesContentApplicationJsonSchemaEnforceCheck"},"V1CollectionsSlugPatchResponsesContentApplicationJsonSchemaSchemaChangeKind":{"type":"string","enum":["additive","breaking"],"title":"V1CollectionsSlugPatchResponsesContentApplicationJsonSchemaSchemaChangeKind"},"V1CollectionsSlugPatchResponsesContentApplicationJsonSchemaSchemaChange":{"type":"object","properties":{"breakingChanges":{"type":"array","items":{"type":"string"}},"kind":{"$ref":"#/components/schemas/V1CollectionsSlugPatchResponsesContentApplicationJsonSchemaSchemaChangeKind"}},"required":["breakingChanges","kind"],"title":"V1CollectionsSlugPatchResponsesContentApplicationJsonSchemaSchemaChange"},"Collections_updateACollection_Response_200":{"type":"object","properties":{"collection":{"$ref":"#/components/schemas/V1CollectionsSlugPatchResponsesContentApplicationJsonSchemaCollection"},"enforceCheck":{"$ref":"#/components/schemas/V1CollectionsSlugPatchResponsesContentApplicationJsonSchemaEnforceCheck"},"schemaChange":{"$ref":"#/components/schemas/V1CollectionsSlugPatchResponsesContentApplicationJsonSchemaSchemaChange"}},"required":["collection"],"title":"Collections_updateACollection_Response_200"},"V1CollectionsSlugPatchResponsesContentApplicationJsonSchemaDetailsItems":{"type":"object","properties":{"code":{"type":"string","description":"Stable Runtype validation code (e.g. MISSING_REQUIRED_FIELD, INVALID_ENUM)."},"message":{"type":"string"},"path":{"type":"string","description":"Dotted JSON path to the offending field."},"suggestion":{"type":"string","description":"Actionable hint (allowed values, accepted range, …)."}},"required":["message"],"title":"V1CollectionsSlugPatchResponsesContentApplicationJsonSchemaDetailsItems"},"UpdateACollectionRequestBadRequestError":{"type":"object","properties":{"code":{"type":"string","description":"Stable error code. `insufficient_scope` marks an API key that lacks a scope this request needs."},"details":{"type":"array","items":{"$ref":"#/components/schemas/V1CollectionsSlugPatchResponsesContentApplicationJsonSchemaDetailsItems"}},"error":{"type":"string"},"requiredScopes":{"type":"array","items":{"type":"string"},"description":"On `insufficient_scope`: every API key scope this request needs."}},"required":["error"],"title":"UpdateACollectionRequestBadRequestError"},"UpdateACollectionRequestNotFoundError":{"type":"object","properties":{"code":{"type":"string","description":"Stable error code. `insufficient_scope` marks an API key that lacks a scope this request needs."},"details":{"type":"array","items":{"$ref":"#/components/schemas/V1CollectionsSlugPatchResponsesContentApplicationJsonSchemaDetailsItems"}},"error":{"type":"string"},"requiredScopes":{"type":"array","items":{"type":"string"},"description":"On `insufficient_scope`: every API key scope this request needs."}},"required":["error"],"title":"UpdateACollectionRequestNotFoundError"},"V1CollectionsSlugInferSchemaPostResponsesContentApplicationJsonSchemaFieldsItems":{"type":"object","properties":{"confidence":{"type":"number","format":"double"},"enum":{"type":"array","items":{"type":"string"}},"format":{"type":"string"},"name":{"type":"string"},"presence":{"type":"number","format":"double"},"sampleValues":{"type":"array","items":{"description":"Any type"}},"type":{"type":"string"}},"required":["confidence","name","presence","sampleValues","type"],"title":"V1CollectionsSlugInferSchemaPostResponsesContentApplicationJsonSchemaFieldsItems"},"Collections_inferASchemaFromExistingRecords_Response_200":{"type":"object","properties":{"fields":{"type":"array","items":{"$ref":"#/components/schemas/V1CollectionsSlugInferSchemaPostResponsesContentApplicationJsonSchemaFieldsItems"}},"sampledRecords":{"type":"integer"},"schema":{"type":["object","null"],"additionalProperties":{"description":"Any type"},"description":"Constrained JSON Schema dialect: root object with string/number/boolean/array/object properties, one nesting level, no $ref/oneOf/pattern"},"skippedKeys":{"type":"array","items":{"type":"string"}},"slug":{"type":"string"},"totalRecords":{"type":"integer"}},"required":["fields","sampledRecords","schema","skippedKeys","slug","totalRecords"],"title":"Collections_inferASchemaFromExistingRecords_Response_200"},"CollectionPullResponseDefinitionValidationMode":{"type":"string","enum":["off","warn","enforce"],"title":"CollectionPullResponseDefinitionValidationMode"},"CollectionPullResponseDefinition":{"type":"object","properties":{"description":{"type":["string","null"]},"displayName":{"type":"string"},"icon":{"type":["string","null"]},"schema":{"type":["object","null"],"additionalProperties":{"description":"Any type"},"description":"Constrained JSON Schema dialect: root object with string/number/boolean/array/object properties, one nesting level, no $ref/oneOf/pattern"},"slug":{"type":"string"},"validationMode":{"$ref":"#/components/schemas/CollectionPullResponseDefinitionValidationMode"}},"required":["description","displayName","icon","schema","slug","validationMode"],"title":"CollectionPullResponseDefinition"},"CollectionPullResponse":{"type":"object","properties":{"collectionId":{"type":"string"},"contentHash":{"type":"string"},"definition":{"$ref":"#/components/schemas/CollectionPullResponseDefinition"},"lastModifiedSource":{"type":["string","null"]},"updatedAt":{"type":["string","null"]}},"required":["collectionId","contentHash","definition","lastModifiedSource","updatedAt"],"title":"CollectionPullResponse"},"V1CollectionsSlugValidateExistingPostResponsesContentApplicationJsonSchemaExamplesItemsErrorsItems":{"type":"object","properties":{"code":{"type":"string"},"field":{"type":"string"},"message":{"type":"string"}},"required":["code","field","message"],"title":"V1CollectionsSlugValidateExistingPostResponsesContentApplicationJsonSchemaExamplesItemsErrorsItems"},"V1CollectionsSlugValidateExistingPostResponsesContentApplicationJsonSchemaExamplesItems":{"type":"object","properties":{"errors":{"type":"array","items":{"$ref":"#/components/schemas/V1CollectionsSlugValidateExistingPostResponsesContentApplicationJsonSchemaExamplesItemsErrorsItems"}},"name":{"type":"string"},"recordId":{"type":"string"}},"required":["errors","name","recordId"],"title":"V1CollectionsSlugValidateExistingPostResponsesContentApplicationJsonSchemaExamplesItems"},"Collections_dryRunExistingRecordsAgainstASchema_Response_200":{"type":"object","properties":{"checked":{"type":"integer"},"examples":{"type":"array","items":{"$ref":"#/components/schemas/V1CollectionsSlugValidateExistingPostResponsesContentApplicationJsonSchemaExamplesItems"}},"failed":{"type":"integer"},"truncated":{"type":"boolean"}},"required":["checked","examples","failed","truncated"],"title":"Collections_dryRunExistingRecordsAgainstASchema_Response_200"},"V1CollectionsSlugValidateExistingPostResponsesContentApplicationJsonSchemaDetailsItems":{"type":"object","properties":{"code":{"type":"string","description":"Stable Runtype validation code (e.g. MISSING_REQUIRED_FIELD, INVALID_ENUM)."},"message":{"type":"string"},"path":{"type":"string","description":"Dotted JSON path to the offending field."},"suggestion":{"type":"string","description":"Actionable hint (allowed values, accepted range, …)."}},"required":["message"],"title":"V1CollectionsSlugValidateExistingPostResponsesContentApplicationJsonSchemaDetailsItems"},"DryRunExistingRecordsAgainstASchemaRequestBadRequestError":{"type":"object","properties":{"code":{"type":"string","description":"Stable error code. `insufficient_scope` marks an API key that lacks a scope this request needs."},"details":{"type":"array","items":{"$ref":"#/components/schemas/V1CollectionsSlugValidateExistingPostResponsesContentApplicationJsonSchemaDetailsItems"}},"error":{"type":"string"},"requiredScopes":{"type":"array","items":{"type":"string"},"description":"On `insufficient_scope`: every API key scope this request needs."}},"required":["error"],"title":"DryRunExistingRecordsAgainstASchemaRequestBadRequestError"},"V1ContextTemplatesGetParametersView":{"type":"string","enum":["full","compact"],"description":"Response representation. `full` (default) preserves complete values; `compact` shortens every string value longer than 100 characters to a 100-character preview followed by `…`.","title":"V1ContextTemplatesGetParametersView"},"V1ContextTemplatesGetResponsesContentApplicationJsonSchemaDataItems":{"type":"object","properties":{"config":{"type":"object","additionalProperties":{"description":"Any type"}},"createdAt":{"type":"string"},"id":{"type":"string"},"name":{"type":"string"},"organizationId":{"type":["string","null"]},"type":{"type":"string"},"updatedAt":{"type":"string"},"userId":{"type":"string"}},"required":["config","createdAt","id","name","organizationId","type","updatedAt","userId"],"title":"V1ContextTemplatesGetResponsesContentApplicationJsonSchemaDataItems"},"Context_Templates_listContextTemplates_Response_200":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1ContextTemplatesGetResponsesContentApplicationJsonSchemaDataItems"}},"pagination":{"type":"object","additionalProperties":{"description":"Any type"}}},"required":["data","pagination"],"title":"Context Templates_listContextTemplates_Response_200"},"Context_Templates_createContextTemplate_Response_201":{"type":"object","properties":{"config":{"type":"object","additionalProperties":{"description":"Any type"}},"createdAt":{"type":"string"},"id":{"type":"string"},"name":{"type":"string"},"organizationId":{"type":["string","null"]},"type":{"type":"string"},"updatedAt":{"type":"string"},"userId":{"type":"string"}},"required":["config","createdAt","id","name","organizationId","type","updatedAt","userId"],"title":"Context Templates_createContextTemplate_Response_201"},"Context_Templates_getContextTemplate_Response_200":{"type":"object","properties":{"config":{"type":"object","additionalProperties":{"description":"Any type"}},"createdAt":{"type":"string"},"id":{"type":"string"},"name":{"type":"string"},"organizationId":{"type":["string","null"]},"type":{"type":"string"},"updatedAt":{"type":"string"},"userId":{"type":"string"}},"required":["config","createdAt","id","name","organizationId","type","updatedAt","userId"],"title":"Context Templates_getContextTemplate_Response_200"},"Context_Templates_updateContextTemplate_Response_200":{"type":"object","properties":{"config":{"type":"object","additionalProperties":{"description":"Any type"}},"createdAt":{"type":"string"},"id":{"type":"string"},"name":{"type":"string"},"organizationId":{"type":["string","null"]},"type":{"type":"string"},"updatedAt":{"type":"string"},"userId":{"type":"string"}},"required":["config","createdAt","id","name","organizationId","type","updatedAt","userId"],"title":"Context Templates_updateContextTemplate_Response_200"},"V1ConversationsGetParametersSource":{"type":"string","enum":["all","app","client_token"],"title":"V1ConversationsGetParametersSource"},"V1ConversationsGetResponsesContentApplicationJsonSchemaConversationsItemsSource":{"type":"string","enum":["app","client_token"],"title":"V1ConversationsGetResponsesContentApplicationJsonSchemaConversationsItemsSource"},"V1ConversationsGetResponsesContentApplicationJsonSchemaConversationsItems":{"type":"object","properties":{"createdAt":{"type":"string"},"id":{"type":"string"},"messageCount":{"type":"integer","description":"Stored messages. For `source: client_token` this counts chat messages before tool results are split into their own `tool` messages, so it can be lower than the detail `messages` length."},"modelId":{"type":["string","null"]},"ownerId":{"type":["string","null"]},"source":{"$ref":"#/components/schemas/V1ConversationsGetResponsesContentApplicationJsonSchemaConversationsItemsSource"},"title":{"type":"string"},"updatedAt":{"type":"string"}},"required":["createdAt","id","messageCount","modelId","ownerId","source","title","updatedAt"],"title":"V1ConversationsGetResponsesContentApplicationJsonSchemaConversationsItems"},"V1ConversationsGetResponsesContentApplicationJsonSchemaPagination":{"type":"object","properties":{"hasMore":{"type":"boolean"},"limit":{"type":"integer"},"nextCursor":{"type":["string","null"]}},"required":["hasMore","limit","nextCursor"],"title":"V1ConversationsGetResponsesContentApplicationJsonSchemaPagination"},"Conversations_listConversations_Response_200":{"type":"object","properties":{"conversations":{"type":"array","items":{"$ref":"#/components/schemas/V1ConversationsGetResponsesContentApplicationJsonSchemaConversationsItems"}},"pagination":{"$ref":"#/components/schemas/V1ConversationsGetResponsesContentApplicationJsonSchemaPagination"}},"required":["conversations","pagination"],"title":"Conversations_listConversations_Response_200"},"ConversationMessageAuthorType":{"type":"string","enum":["end_user","operator","agent","system"],"title":"ConversationMessageAuthorType"},"ConversationMessageAuthor":{"type":"object","properties":{"externalId":{"type":"string","minLength":1,"maxLength":500,"description":"The author id in the source system."},"id":{"type":"string","minLength":1,"maxLength":255,"description":"The author id in Runtype, when there is one."},"name":{"type":"string","minLength":1,"maxLength":255},"type":{"$ref":"#/components/schemas/ConversationMessageAuthorType"}},"required":["type"],"description":"Who wrote this message in the source system. Stored and returned, never replayed.","title":"ConversationMessageAuthor"},"ConversationTranscriptMessageContentOneOf1ItemsOneOf0Type":{"type":"string","enum":["text"],"title":"ConversationTranscriptMessageContentOneOf1ItemsOneOf0Type"},"ConversationTranscriptMessageContentOneOf1Items0":{"type":"object","properties":{"text":{"type":"string"},"type":{"$ref":"#/components/schemas/ConversationTranscriptMessageContentOneOf1ItemsOneOf0Type"}},"required":["text","type"],"title":"ConversationTranscriptMessageContentOneOf1Items0"},"ConversationTranscriptMessageContentOneOf1ItemsOneOf1Type":{"type":"string","enum":["image"],"title":"ConversationTranscriptMessageContentOneOf1ItemsOneOf1Type"},"ConversationTranscriptMessageContentOneOf1Items1":{"type":"object","properties":{"image":{"type":"string"},"mimeType":{"type":"string"},"type":{"$ref":"#/components/schemas/ConversationTranscriptMessageContentOneOf1ItemsOneOf1Type"}},"required":["image","type"],"title":"ConversationTranscriptMessageContentOneOf1Items1"},"ConversationTranscriptMessageContentOneOf1ItemsOneOf2Type":{"type":"string","enum":["file"],"title":"ConversationTranscriptMessageContentOneOf1ItemsOneOf2Type"},"ConversationTranscriptMessageContentOneOf1Items2":{"type":"object","properties":{"data":{"type":"string"},"filename":{"type":"string"},"mimeType":{"type":"string"},"type":{"$ref":"#/components/schemas/ConversationTranscriptMessageContentOneOf1ItemsOneOf2Type"}},"required":["data","filename","mimeType","type"],"title":"ConversationTranscriptMessageContentOneOf1Items2"},"ConversationTranscriptMessageContentOneOf1ItemsOneOf3Type":{"type":"string","enum":["reasoning"],"title":"ConversationTranscriptMessageContentOneOf1ItemsOneOf3Type"},"ConversationTranscriptMessageContentOneOf1Items3":{"type":"object","properties":{"providerOptions":{"type":"object","additionalProperties":{"description":"Any type"}},"text":{"type":"string"},"type":{"$ref":"#/components/schemas/ConversationTranscriptMessageContentOneOf1ItemsOneOf3Type"}},"required":["text","type"],"title":"ConversationTranscriptMessageContentOneOf1Items3"},"ConversationTranscriptMessageContentOneOf1ItemsOneOf4RefKind":{"type":"string","enum":["image","file"],"title":"ConversationTranscriptMessageContentOneOf1ItemsOneOf4RefKind"},"ConversationTranscriptMessageContentOneOf1ItemsOneOf4Type":{"type":"string","enum":["asset_ref"],"title":"ConversationTranscriptMessageContentOneOf1ItemsOneOf4Type"},"ConversationTranscriptMessageContentOneOf1Items4":{"type":"object","properties":{"assetId":{"type":"string"},"filename":{"type":"string"},"mimeType":{"type":"string"},"orgKey":{"type":"string"},"refKind":{"$ref":"#/components/schemas/ConversationTranscriptMessageContentOneOf1ItemsOneOf4RefKind"},"sizeBytes":{"type":"number","format":"double"},"type":{"$ref":"#/components/schemas/ConversationTranscriptMessageContentOneOf1ItemsOneOf4Type"}},"required":["assetId","mimeType","orgKey","refKind","sizeBytes","type"],"title":"ConversationTranscriptMessageContentOneOf1Items4"},"ConversationTranscriptMessageContentOneOf1Items":{"oneOf":[{"$ref":"#/components/schemas/ConversationTranscriptMessageContentOneOf1Items0"},{"$ref":"#/components/schemas/ConversationTranscriptMessageContentOneOf1Items1"},{"$ref":"#/components/schemas/ConversationTranscriptMessageContentOneOf1Items2"},{"$ref":"#/components/schemas/ConversationTranscriptMessageContentOneOf1Items3"},{"$ref":"#/components/schemas/ConversationTranscriptMessageContentOneOf1Items4"}],"title":"ConversationTranscriptMessageContentOneOf1Items"},"ConversationTranscriptMessageContent1":{"type":"array","items":{"$ref":"#/components/schemas/ConversationTranscriptMessageContentOneOf1Items"},"title":"ConversationTranscriptMessageContent1"},"ConversationTranscriptMessageContent":{"oneOf":[{"type":"string"},{"$ref":"#/components/schemas/ConversationTranscriptMessageContent1"}],"description":"Plain string, or an array of {type:\"text\"|\"image\"|\"file\"|\"reasoning\"|\"asset_ref\"} parts.","title":"ConversationTranscriptMessageContent"},"ConversationTranscriptMessageRole":{"type":"string","enum":["system","user","assistant","tool"],"title":"ConversationTranscriptMessageRole"},"ConversationTranscriptMessageToolCallsItems":{"type":"object","properties":{"args":{"type":"object","additionalProperties":{"description":"Any type"},"default":{}},"providerOptions":{"type":"object","additionalProperties":{"description":"Any type"}},"toolCallId":{"type":"string","minLength":1},"toolName":{"type":"string","minLength":1}},"required":["toolCallId","toolName"],"title":"ConversationTranscriptMessageToolCallsItems"},"ConversationTranscriptMessageToolResultsItems":{"type":"object","properties":{"providerOptions":{"type":"object","additionalProperties":{"description":"Any type"}},"result":{"description":"Whatever the tool returned."},"toolCallId":{"type":"string","minLength":1,"description":"Must answer a toolCalls entry issued earlier."},"toolName":{"type":"string","minLength":1}},"required":["toolCallId","toolName"],"title":"ConversationTranscriptMessageToolResultsItems"},"ConversationTranscriptMessage":{"type":"object","properties":{"author":{"$ref":"#/components/schemas/ConversationMessageAuthor"},"content":{"$ref":"#/components/schemas/ConversationTranscriptMessageContent","description":"Plain string, or an array of {type:\"text\"|\"image\"|\"file\"|\"reasoning\"|\"asset_ref\"} parts."},"createdAt":{"type":"string","description":"ISO 8601 when Runtype mints it; any string is accepted on import."},"id":{"type":"string","minLength":1,"description":"Minted when omitted. Use the source system id to make an import resumable."},"metadata":{"type":"object","additionalProperties":{"description":"Any type"},"description":"Open key/value bag. Runtype stamps `executionId` on a turn an agent wrote; treat it as optional."},"model":{"type":"string","minLength":1,"maxLength":255,"description":"The model that wrote this assistant message. Informational on import: only a message the agent engine stored itself (marked server-side) replays its reasoning parts and provider options, and only to this same model."},"role":{"$ref":"#/components/schemas/ConversationTranscriptMessageRole"},"toolCalls":{"type":"array","items":{"$ref":"#/components/schemas/ConversationTranscriptMessageToolCallsItems"},"description":"Assistant messages only. Every entry must be answered by the next tool message. An agent turn stores one assistant and tool message pair per model round, in order."},"toolResults":{"type":"array","items":{"$ref":"#/components/schemas/ConversationTranscriptMessageToolResultsItems"},"description":"Tool messages only, and required on them."}},"required":["content","role"],"title":"ConversationTranscriptMessage"},"ConversationSource":{"type":"object","properties":{"externalId":{"type":"string","minLength":1,"maxLength":500,"description":"The conversation id in the source system. Re-creating with the same system and externalId returns the existing conversation with imported: false instead of a duplicate."},"importedAt":{"type":"string","format":"date-time"},"system":{"type":"string","minLength":1,"maxLength":100,"description":"The system the transcript came from, for example \"intercom\" or \"custom\"."}},"required":["system"],"description":"Import provenance, stored as metadata.importSource.","title":"ConversationSource"},"V1ConversationsPostResponsesContentApplicationJsonSchemaSchemaWarningsItems":{"type":"object","properties":{"code":{"type":"string"},"field":{"type":"string"},"message":{"type":"string"}},"required":["code","field","message"],"title":"V1ConversationsPostResponsesContentApplicationJsonSchemaSchemaWarningsItems"},"V1ConversationsPostResponsesContentApplicationJsonSchemaSource":{"type":"string","enum":["app","client_token"],"title":"V1ConversationsPostResponsesContentApplicationJsonSchemaSource"},"Conversations_createAConversation_Response_200":{"type":"object","properties":{"createdAt":{"type":"string"},"id":{"type":"string"},"imported":{"type":"boolean","description":"Set by POST /v1/conversations only. True when this call created the conversation (201); false when a conversation with the same source.system and source.externalId already existed and is returned unchanged (200)."},"messages":{"type":"array","items":{"$ref":"#/components/schemas/ConversationTranscriptMessage"},"description":"The full ordered transcript, never paginated or capped. For `source: client_token` (Persona web chat) it is read from the chat transcript the widget wrote (also kept in `metadata.messages`): `timestamp` is returned as `createdAt`, `displayContent` as `metadata.displayContent`, and an assistant message that called tools carries `toolCalls` followed by a `tool` message (id `<assistant id>_tool_results`) holding each settled result; a call still awaiting approval or a client answer has no result."},"metadata":{"type":"object","additionalProperties":{"description":"Any type"}},"modelId":{"type":["string","null"]},"ownerId":{"type":["string","null"]},"schemaWarnings":{"type":"array","items":{"$ref":"#/components/schemas/V1ConversationsPostResponsesContentApplicationJsonSchemaSchemaWarningsItems"}},"source":{"$ref":"#/components/schemas/V1ConversationsPostResponsesContentApplicationJsonSchemaSource"},"systemPrompt":{"type":["string","null"]},"title":{"type":"string"},"updatedAt":{"type":"string"}},"required":["createdAt","id","messages","metadata","modelId","ownerId","source","systemPrompt","title","updatedAt"],"title":"Conversations_createAConversation_Response_200"},"V1ConversationsPostResponsesContentApplicationJsonSchemaDetailsItems":{"type":"object","properties":{"code":{"type":"string","description":"Stable Runtype validation code (e.g. MISSING_REQUIRED_FIELD, INVALID_ENUM)."},"message":{"type":"string"},"path":{"type":"string","description":"Dotted JSON path to the offending field."},"suggestion":{"type":"string","description":"Actionable hint (allowed values, accepted range, …)."}},"required":["message"],"title":"V1ConversationsPostResponsesContentApplicationJsonSchemaDetailsItems"},"CreateAConversationRequestBadRequestError":{"type":"object","properties":{"code":{"type":"string","description":"Stable error code. `insufficient_scope` marks an API key that lacks a scope this request needs."},"details":{"type":"array","items":{"$ref":"#/components/schemas/V1ConversationsPostResponsesContentApplicationJsonSchemaDetailsItems"}},"error":{"type":"string"},"requiredScopes":{"type":"array","items":{"type":"string"},"description":"On `insufficient_scope`: every API key scope this request needs."},"message":{"type":"string"}},"required":["error"],"title":"CreateAConversationRequestBadRequestError"},"RecordSchemaValidationErrorDetailsItems":{"type":"object","properties":{"code":{"type":"string"},"field":{"type":"string"},"message":{"type":"string"},"path":{"type":"string"}},"required":["code","field","message","path"],"title":"RecordSchemaValidationErrorDetailsItems"},"RecordSchemaValidationErrorError":{"type":"string","enum":["schema_validation_failed"],"title":"RecordSchemaValidationErrorError"},"RecordSchemaValidationError":{"type":"object","properties":{"collection":{"type":"string"},"details":{"type":"array","items":{"$ref":"#/components/schemas/RecordSchemaValidationErrorDetailsItems"}},"error":{"$ref":"#/components/schemas/RecordSchemaValidationErrorError"},"recordId":{"type":"string"},"recordName":{"type":"string"},"schemaVersion":{"type":"integer"}},"required":["collection","details","error","schemaVersion"],"title":"RecordSchemaValidationError"},"CollectionLookupFailedErrorCode":{"type":"string","enum":["COLLECTION_LOOKUP_FAILED"],"title":"CollectionLookupFailedErrorCode"},"CollectionLookupFailedError":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/CollectionLookupFailedErrorCode"},"collection":{"type":"string","description":"The record type whose collection schema could not be loaded."},"error":{"type":"string","description":"Human-readable refusal; retry the request."},"recordId":{"type":"string"},"recordName":{"type":"string"}},"required":["code","collection","error"],"title":"CollectionLookupFailedError"},"V1ConversationsIdGetResponsesContentApplicationJsonSchemaSchemaWarningsItems":{"type":"object","properties":{"code":{"type":"string"},"field":{"type":"string"},"message":{"type":"string"}},"required":["code","field","message"],"title":"V1ConversationsIdGetResponsesContentApplicationJsonSchemaSchemaWarningsItems"},"V1ConversationsIdGetResponsesContentApplicationJsonSchemaSource":{"type":"string","enum":["app","client_token"],"title":"V1ConversationsIdGetResponsesContentApplicationJsonSchemaSource"},"Conversations_getConversationWithMessages_Response_200":{"type":"object","properties":{"createdAt":{"type":"string"},"id":{"type":"string"},"imported":{"type":"boolean","description":"Set by POST /v1/conversations only. True when this call created the conversation (201); false when a conversation with the same source.system and source.externalId already existed and is returned unchanged (200)."},"messages":{"type":"array","items":{"$ref":"#/components/schemas/ConversationTranscriptMessage"},"description":"The full ordered transcript, never paginated or capped. For `source: client_token` (Persona web chat) it is read from the chat transcript the widget wrote (also kept in `metadata.messages`): `timestamp` is returned as `createdAt`, `displayContent` as `metadata.displayContent`, and an assistant message that called tools carries `toolCalls` followed by a `tool` message (id `<assistant id>_tool_results`) holding each settled result; a call still awaiting approval or a client answer has no result."},"metadata":{"type":"object","additionalProperties":{"description":"Any type"}},"modelId":{"type":["string","null"]},"ownerId":{"type":["string","null"]},"schemaWarnings":{"type":"array","items":{"$ref":"#/components/schemas/V1ConversationsIdGetResponsesContentApplicationJsonSchemaSchemaWarningsItems"}},"source":{"$ref":"#/components/schemas/V1ConversationsIdGetResponsesContentApplicationJsonSchemaSource"},"systemPrompt":{"type":["string","null"]},"title":{"type":"string"},"updatedAt":{"type":"string"}},"required":["createdAt","id","messages","metadata","modelId","ownerId","source","systemPrompt","title","updatedAt"],"title":"Conversations_getConversationWithMessages_Response_200"},"V1ConversationsIdPutRequestBodyContentApplicationJsonSchemaMessagesMode":{"type":"string","enum":["replace","append"],"default":"replace","description":"How to apply `messages`. `replace` (the default) swaps the whole transcript. `append` adds them to the end, skipping any message whose id is already stored, so a chunked import can retry a chunk safely; the combined transcript is validated and must satisfy the same tool-pairing discipline.","title":"V1ConversationsIdPutRequestBodyContentApplicationJsonSchemaMessagesMode"},"V1ConversationsIdPutResponsesContentApplicationJsonSchemaSchemaWarningsItems":{"type":"object","properties":{"code":{"type":"string"},"field":{"type":"string"},"message":{"type":"string"}},"required":["code","field","message"],"title":"V1ConversationsIdPutResponsesContentApplicationJsonSchemaSchemaWarningsItems"},"V1ConversationsIdPutResponsesContentApplicationJsonSchemaSource":{"type":"string","enum":["app","client_token"],"title":"V1ConversationsIdPutResponsesContentApplicationJsonSchemaSource"},"Conversations_updateAConversation_Response_200":{"type":"object","properties":{"createdAt":{"type":"string"},"id":{"type":"string"},"imported":{"type":"boolean","description":"Set by POST /v1/conversations only. True when this call created the conversation (201); false when a conversation with the same source.system and source.externalId already existed and is returned unchanged (200)."},"messages":{"type":"array","items":{"$ref":"#/components/schemas/ConversationTranscriptMessage"},"description":"The full ordered transcript, never paginated or capped. For `source: client_token` (Persona web chat) it is read from the chat transcript the widget wrote (also kept in `metadata.messages`): `timestamp` is returned as `createdAt`, `displayContent` as `metadata.displayContent`, and an assistant message that called tools carries `toolCalls` followed by a `tool` message (id `<assistant id>_tool_results`) holding each settled result; a call still awaiting approval or a client answer has no result."},"metadata":{"type":"object","additionalProperties":{"description":"Any type"}},"modelId":{"type":["string","null"]},"ownerId":{"type":["string","null"]},"schemaWarnings":{"type":"array","items":{"$ref":"#/components/schemas/V1ConversationsIdPutResponsesContentApplicationJsonSchemaSchemaWarningsItems"}},"source":{"$ref":"#/components/schemas/V1ConversationsIdPutResponsesContentApplicationJsonSchemaSource"},"systemPrompt":{"type":["string","null"]},"title":{"type":"string"},"updatedAt":{"type":"string"}},"required":["createdAt","id","messages","metadata","modelId","ownerId","source","systemPrompt","title","updatedAt"],"title":"Conversations_updateAConversation_Response_200"},"V1ConversationsIdPutResponsesContentApplicationJsonSchemaDetailsItems":{"type":"object","properties":{"code":{"type":"string","description":"Stable Runtype validation code (e.g. MISSING_REQUIRED_FIELD, INVALID_ENUM)."},"message":{"type":"string"},"path":{"type":"string","description":"Dotted JSON path to the offending field."},"suggestion":{"type":"string","description":"Actionable hint (allowed values, accepted range, …)."}},"required":["message"],"title":"V1ConversationsIdPutResponsesContentApplicationJsonSchemaDetailsItems"},"UpdateAConversationRequestBadRequestError":{"type":"object","properties":{"code":{"type":"string","description":"Stable error code. `insufficient_scope` marks an API key that lacks a scope this request needs."},"details":{"type":"array","items":{"$ref":"#/components/schemas/V1ConversationsIdPutResponsesContentApplicationJsonSchemaDetailsItems"}},"error":{"type":"string"},"requiredScopes":{"type":"array","items":{"type":"string"},"description":"On `insufficient_scope`: every API key scope this request needs."},"message":{"type":"string"}},"required":["error"],"title":"UpdateAConversationRequestBadRequestError"},"V1DataConnectionsGetResponsesContentApplicationJsonSchemaDataItems":{"type":"object","properties":{},"title":"V1DataConnectionsGetResponsesContentApplicationJsonSchemaDataItems"},"Data_Connections_listDataConnections_Response_200":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1DataConnectionsGetResponsesContentApplicationJsonSchemaDataItems"}}},"required":["data"],"title":"Data Connections_listDataConnections_Response_200"},"V1DataConnectionsConnectSessionPostResponsesContentApplicationJsonSchemaData":{"type":"object","properties":{"connectLink":{"type":"string"},"sessionId":{"type":"string"},"token":{"type":"string"}},"required":["connectLink","sessionId","token"],"title":"V1DataConnectionsConnectSessionPostResponsesContentApplicationJsonSchemaData"},"Data_Connections_createConnectSession_Response_200":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/V1DataConnectionsConnectSessionPostResponsesContentApplicationJsonSchemaData"}},"required":["data"],"title":"Data Connections_createConnectSession_Response_200"},"V1DataConnectionsSyncPostResponsesContentApplicationJsonSchemaData":{"type":"object","properties":{},"title":"V1DataConnectionsSyncPostResponsesContentApplicationJsonSchemaData"},"Data_Connections_syncConnections_Response_200":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/V1DataConnectionsSyncPostResponsesContentApplicationJsonSchemaData"}},"required":["data"],"title":"Data Connections_syncConnections_Response_200"},"V1DataConnectionsIdGetResponsesContentApplicationJsonSchemaData":{"type":"object","properties":{},"title":"V1DataConnectionsIdGetResponsesContentApplicationJsonSchemaData"},"Data_Connections_getDataConnection_Response_200":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/V1DataConnectionsIdGetResponsesContentApplicationJsonSchemaData"}},"required":["data"],"title":"Data Connections_getDataConnection_Response_200"},"Data_Connections_deleteDataConnection_Response_200":{"type":"object","properties":{"success":{"type":"boolean"}},"required":["success"],"title":"Data Connections_deleteDataConnection_Response_200"},"V1DataConnectionsIdPatchRequestBodyContentApplicationJsonSchemaStatus":{"type":"string","enum":["active","disconnected","error"],"title":"V1DataConnectionsIdPatchRequestBodyContentApplicationJsonSchemaStatus"},"V1DataConnectionsIdPatchResponsesContentApplicationJsonSchemaData":{"type":"object","properties":{},"title":"V1DataConnectionsIdPatchResponsesContentApplicationJsonSchemaData"},"Data_Connections_updateConnectionStatus_Response_200":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/V1DataConnectionsIdPatchResponsesContentApplicationJsonSchemaData"}},"required":["data"],"title":"Data Connections_updateConnectionStatus_Response_200"},"V1DataConnectionsIdToolsGetResponsesContentApplicationJsonSchemaData":{"type":"object","properties":{"category":{"type":"string"},"connectionId":{"type":"string"},"providerName":{"type":"string"},"tools":{"type":"array","items":{"description":"Any type"}}},"required":["category","connectionId","providerName","tools"],"title":"V1DataConnectionsIdToolsGetResponsesContentApplicationJsonSchemaData"},"Data_Connections_listConnectionTools_Response_200":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/V1DataConnectionsIdToolsGetResponsesContentApplicationJsonSchemaData"}},"required":["data"],"title":"Data Connections_listConnectionTools_Response_200"},"DecisionModelCredentialRequirementsProvider":{"type":"string","enum":["vercel","openai","platform"],"title":"DecisionModelCredentialRequirementsProvider"},"DecisionModelCredentialRequirements":{"type":"object","properties":{"organizationCredentialSupported":{"type":"boolean"},"platformFundingSupported":{"type":"boolean"},"provider":{"$ref":"#/components/schemas/DecisionModelCredentialRequirementsProvider"}},"required":["organizationCredentialSupported","platformFundingSupported","provider"],"title":"DecisionModelCredentialRequirements"},"DecisionModelInputKindsItems":{"type":"string","enum":["text","json"],"title":"DecisionModelInputKindsItems"},"DecisionModelPricing":{"type":"object","properties":{"inputPer1MTokens":{"type":"number","format":"double"},"inputPerToken":{"type":"string"},"outputPer1MTokens":{"type":"number","format":"double"},"outputPerToken":{"type":"string"}},"required":["inputPer1MTokens","inputPerToken","outputPer1MTokens","outputPerToken"],"title":"DecisionModelPricing"},"DecisionModelProvider":{"type":"string","enum":["vercel","openai","cloudflare"],"title":"DecisionModelProvider"},"DecisionModelRoute":{"type":"string","enum":["vercel-ai-gateway","openai-decisions","cloudflare-workers-ai"],"title":"DecisionModelRoute"},"DecisionModel":{"type":"object","properties":{"contextWindow":{"type":["integer","null"]},"credentialRequirements":{"$ref":"#/components/schemas/DecisionModelCredentialRequirements"},"description":{"type":"string"},"docsUrl":{"type":"string"},"id":{"type":"string"},"inputKinds":{"type":"array","items":{"$ref":"#/components/schemas/DecisionModelInputKindsItems"}},"maxChoiceOptions":{"type":"integer"},"maxQuestions":{"type":["integer","null"]},"maxScoreLevels":{"type":"integer"},"minChoiceOptions":{"type":"integer"},"name":{"type":"string"},"platformFunding":{"type":"boolean"},"pricing":{"oneOf":[{"$ref":"#/components/schemas/DecisionModelPricing"},{"type":"null"}]},"provider":{"$ref":"#/components/schemas/DecisionModelProvider"},"providerModelId":{"type":"string"},"route":{"$ref":"#/components/schemas/DecisionModelRoute"}},"required":["contextWindow","credentialRequirements","description","docsUrl","id","inputKinds","maxChoiceOptions","maxQuestions","maxScoreLevels","minChoiceOptions","name","platformFunding","pricing","provider","providerModelId","route"],"title":"DecisionModel"},"Decision_Models_listDecisionModels_Response_200":{"type":"object","properties":{"models":{"type":"array","items":{"$ref":"#/components/schemas/DecisionModel"}}},"required":["models"],"title":"Decision Models_listDecisionModels_Response_200"},"RuntimeJudgmentRequestState":{"oneOf":[{"type":"string"},{"type":"object","additionalProperties":{"description":"Any type"}},{"type":"array","items":{"description":"Any type"}}],"description":"The text, JSON object or JSON array to judge. Never echoed in errors or logs.","title":"RuntimeJudgmentRequestState"},"RuntimeJudgmentRequest":{"type":"object","properties":{"executionId":{"type":"string","minLength":1,"description":"The self-hosted execution asking, recorded on the judgment telemetry."},"model":{"type":"string","minLength":1,"description":"Decision model id. In configured mode it outranks the question set version model."},"questionSetId":{"type":"string","minLength":1,"description":"A question set owned by the caller; its published version supplies the questions."},"questions":{"type":"object","additionalProperties":{"description":"Any type"},"description":"Ad hoc questions keyed by question id, each `{ type: \"boolean\" | \"choice\" | \"score\", instructions, criteria }`. Refused with `JUDGMENT_CONFIGURED_QUESTIONS_REJECTED` when `questionSetId` is set."},"state":{"$ref":"#/components/schemas/RuntimeJudgmentRequestState","description":"The text, JSON object or JSON array to judge. Never echoed in errors or logs."},"version":{"type":"integer","minimum":1,"description":"Published question set version to use; omit for the current version. Without `questionSetId` the call is refused with 400 `JUDGMENT_VERSION_WITHOUT_QUESTION_SET`."}},"required":["state"],"title":"RuntimeJudgmentRequest"},"RuntimeJudgmentMetadataKeySource":{"type":"string","enum":["user","platform"],"title":"RuntimeJudgmentMetadataKeySource"},"RuntimeJudgmentMetadataUsage":{"type":"object","properties":{"inputTokens":{"type":"number","format":"double"},"outputTokens":{"type":"number","format":"double"},"reported":{"type":"boolean"}},"required":["inputTokens","outputTokens","reported"],"title":"RuntimeJudgmentMetadataUsage"},"RuntimeJudgmentMetadata":{"type":"object","properties":{"calibrationId":{"type":["string","null"]},"estimatedCostUsd":{"type":"number","format":"double","description":"Provider rates, before margin."},"keySource":{"$ref":"#/components/schemas/RuntimeJudgmentMetadataKeySource"},"provider":{"type":"string"},"questionSetId":{"type":"string"},"questionSetVersion":{"type":"integer"},"requestedModel":{"type":"string"},"resolvedModelId":{"type":["string","null"]},"route":{"type":"string"},"usage":{"$ref":"#/components/schemas/RuntimeJudgmentMetadataUsage"}},"required":["calibrationId","keySource","provider","requestedModel","resolvedModelId","route","usage"],"title":"RuntimeJudgmentMetadata"},"RuntimeJudgmentResponse":{"type":"object","properties":{"answers":{"type":"object","additionalProperties":{"description":"Any type"},"description":"One answer per question id, exactly as the decision model returned it."},"judgment":{"$ref":"#/components/schemas/RuntimeJudgmentMetadata"}},"required":["answers","judgment"],"title":"RuntimeJudgmentResponse"},"AskForAJudgmentHostedDecisionProviderRequestBadRequestError":{"type":"object","properties":{"code":{"type":"string","description":"Stable code for a caller-fixable failure, e.g. JUDGMENT_QUESTIONS_INVALID, JUDGMENT_CONFIGURED_QUESTIONS_REJECTED or QUESTION_SET_UNRESOLVED."},"details":{"type":"object","additionalProperties":{"description":"Any type"}},"error":{"type":"string"},"requiredScopes":{"type":"array","items":{"type":"string"},"description":"On `insufficient_scope`: every API key scope this request needs."}},"required":["error"],"title":"AskForAJudgmentHostedDecisionProviderRequestBadRequestError"},"AskForAJudgmentHostedDecisionProviderRequestNotFoundError":{"type":"object","properties":{"code":{"type":"string","description":"Stable code for a caller-fixable failure, e.g. JUDGMENT_QUESTIONS_INVALID, JUDGMENT_CONFIGURED_QUESTIONS_REJECTED or QUESTION_SET_UNRESOLVED."},"details":{"type":"object","additionalProperties":{"description":"Any type"}},"error":{"type":"string"},"requiredScopes":{"type":"array","items":{"type":"string"},"description":"On `insufficient_scope`: every API key scope this request needs."}},"required":["error"],"title":"AskForAJudgmentHostedDecisionProviderRequestNotFoundError"},"AskForAJudgmentHostedDecisionProviderRequestUnprocessableEntityError":{"type":"object","properties":{"code":{"type":"string","description":"Stable code for a caller-fixable failure, e.g. JUDGMENT_QUESTIONS_INVALID, JUDGMENT_CONFIGURED_QUESTIONS_REJECTED or QUESTION_SET_UNRESOLVED."},"details":{"type":"object","additionalProperties":{"description":"Any type"}},"error":{"type":"string"},"requiredScopes":{"type":"array","items":{"type":"string"},"description":"On `insufficient_scope`: every API key scope this request needs."}},"required":["error"],"title":"AskForAJudgmentHostedDecisionProviderRequestUnprocessableEntityError"},"V1DelegateTasksGetParametersStatus":{"type":"string","enum":["queued","running","input_required","completed","failed","cancelled"],"title":"V1DelegateTasksGetParametersStatus"},"V1DelegateTasksGetResponsesContentApplicationJsonSchemaDataItemsPriority":{"type":"string","enum":["standard","fast"],"title":"V1DelegateTasksGetResponsesContentApplicationJsonSchemaDataItemsPriority"},"V1DelegateTasksGetResponsesContentApplicationJsonSchemaDataItemsResultLinksItems":{"type":"object","properties":{"label":{"type":"string","minLength":1,"maxLength":200},"url":{"type":"string","format":"uri","maxLength":2048}},"required":["label","url"],"title":"V1DelegateTasksGetResponsesContentApplicationJsonSchemaDataItemsResultLinksItems"},"V1DelegateTasksGetResponsesContentApplicationJsonSchemaDataItemsResultTouchedEntitiesItemsAction":{"type":"string","enum":["created","updated","deleted","executed","read"],"title":"V1DelegateTasksGetResponsesContentApplicationJsonSchemaDataItemsResultTouchedEntitiesItemsAction"},"V1DelegateTasksGetResponsesContentApplicationJsonSchemaDataItemsResultTouchedEntitiesItems":{"type":"object","properties":{"action":{"$ref":"#/components/schemas/V1DelegateTasksGetResponsesContentApplicationJsonSchemaDataItemsResultTouchedEntitiesItemsAction"},"id":{"type":"string","minLength":1,"maxLength":255},"kind":{"type":"string","minLength":1,"maxLength":64},"name":{"type":"string","maxLength":255},"runIds":{"type":"array","items":{"type":"string","minLength":1,"maxLength":255}}},"required":["action","id","kind"],"title":"V1DelegateTasksGetResponsesContentApplicationJsonSchemaDataItemsResultTouchedEntitiesItems"},"V1DelegateTasksGetResponsesContentApplicationJsonSchemaDataItemsResult":{"type":"object","properties":{"links":{"type":"array","items":{"$ref":"#/components/schemas/V1DelegateTasksGetResponsesContentApplicationJsonSchemaDataItemsResultLinksItems"}},"modelRoundCount":{"type":"integer","minimum":0},"summary":{"type":"string","maxLength":4000},"toolCallCount":{"type":"integer","minimum":0},"totalCost":{"type":"number","format":"double","minimum":0},"touchedEntities":{"type":"array","items":{"$ref":"#/components/schemas/V1DelegateTasksGetResponsesContentApplicationJsonSchemaDataItemsResultTouchedEntitiesItems"}},"warnings":{"type":"array","items":{"type":"string","maxLength":1000}}},"required":["links","modelRoundCount","summary","toolCallCount","touchedEntities"],"title":"V1DelegateTasksGetResponsesContentApplicationJsonSchemaDataItemsResult"},"V1DelegateTasksGetResponsesContentApplicationJsonSchemaDataItemsStatus":{"type":"string","enum":["queued","running","input_required","completed","failed","cancelled"],"title":"V1DelegateTasksGetResponsesContentApplicationJsonSchemaDataItemsStatus"},"V1DelegateTasksGetResponsesContentApplicationJsonSchemaDataItemsTarget":{"type":"string","enum":["operator","otto"],"description":"Who works the task; `operator` when absent.","title":"V1DelegateTasksGetResponsesContentApplicationJsonSchemaDataItemsTarget"},"V1DelegateTasksGetResponsesContentApplicationJsonSchemaDataItemsTouchedEntitiesItemsAction":{"type":"string","enum":["created","updated","deleted","executed","read"],"title":"V1DelegateTasksGetResponsesContentApplicationJsonSchemaDataItemsTouchedEntitiesItemsAction"},"V1DelegateTasksGetResponsesContentApplicationJsonSchemaDataItemsTouchedEntitiesItems":{"type":"object","properties":{"action":{"$ref":"#/components/schemas/V1DelegateTasksGetResponsesContentApplicationJsonSchemaDataItemsTouchedEntitiesItemsAction"},"id":{"type":"string","minLength":1,"maxLength":255},"kind":{"type":"string","minLength":1,"maxLength":64},"name":{"type":"string","maxLength":255},"runIds":{"type":"array","items":{"type":"string","minLength":1,"maxLength":255}}},"required":["action","id","kind"],"title":"V1DelegateTasksGetResponsesContentApplicationJsonSchemaDataItemsTouchedEntitiesItems"},"V1DelegateTasksGetResponsesContentApplicationJsonSchemaDataItems":{"type":"object","properties":{"allowDestructive":{"type":"boolean","description":"Whether the caller allowed destructive and consequential operations."},"allowSimulationRun":{"type":"boolean","description":"Whether the caller allowed starting simulation runs, and no other gated operation."},"apiKeyId":{"type":["string","null"]},"attachmentCount":{"type":"integer","minimum":0,"description":"Images the task started with; read each from its attachment route."},"clientName":{"type":["string","null"]},"clientVersion":{"type":["string","null"]},"completedAt":{"type":["string","null"]},"context":{"description":"Any type"},"createdAt":{"type":"string"},"error":{"type":["string","null"]},"id":{"type":"string"},"instruction":{"type":"string"},"lastEventSeq":{"type":"integer","minimum":0},"modelRoundCount":{"type":"integer","minimum":0},"organizationId":{"type":"string"},"priority":{"$ref":"#/components/schemas/V1DelegateTasksGetResponsesContentApplicationJsonSchemaDataItemsPriority"},"question":{"type":["string","null"]},"result":{"oneOf":[{"$ref":"#/components/schemas/V1DelegateTasksGetResponsesContentApplicationJsonSchemaDataItemsResult"},{"type":"null"}]},"startedAt":{"type":["string","null"]},"status":{"$ref":"#/components/schemas/V1DelegateTasksGetResponsesContentApplicationJsonSchemaDataItemsStatus"},"summary":{"type":["string","null"]},"target":{"$ref":"#/components/schemas/V1DelegateTasksGetResponsesContentApplicationJsonSchemaDataItemsTarget","description":"Who works the task; `operator` when absent."},"targetExecutionId":{"type":["string","null"],"description":"The worker's execution for the latest turn, when it has its own: an Otto run."},"toolCallCount":{"type":"integer","minimum":0},"totalCost":{"type":["number","null"],"format":"double"},"touchedEntities":{"type":"array","items":{"$ref":"#/components/schemas/V1DelegateTasksGetResponsesContentApplicationJsonSchemaDataItemsTouchedEntitiesItems"}},"updatedAt":{"type":"string"},"userId":{"type":"string"}},"required":["apiKeyId","clientName","clientVersion","completedAt","createdAt","error","id","instruction","lastEventSeq","modelRoundCount","organizationId","question","result","startedAt","status","summary","toolCallCount","totalCost","touchedEntities","updatedAt","userId"],"title":"V1DelegateTasksGetResponsesContentApplicationJsonSchemaDataItems"},"Delegate_tasks_listDelegateTasks_Response_200":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1DelegateTasksGetResponsesContentApplicationJsonSchemaDataItems"}},"pagination":{"$ref":"#/components/schemas/Pagination"}},"required":["data","pagination"],"title":"Delegate tasks_listDelegateTasks_Response_200"},"V1DelegateTasksPostRequestBodyContentApplicationJsonSchemaAttachmentsItemsType":{"type":"string","enum":["image"],"title":"V1DelegateTasksPostRequestBodyContentApplicationJsonSchemaAttachmentsItemsType"},"V1DelegateTasksPostRequestBodyContentApplicationJsonSchemaAttachmentsItems":{"type":"object","properties":{"image":{"type":"string","maxLength":2097152,"description":"The image as a data URL, up to 2 MB of text."},"mimeType":{"type":"string","maxLength":64},"type":{"$ref":"#/components/schemas/V1DelegateTasksPostRequestBodyContentApplicationJsonSchemaAttachmentsItemsType"}},"required":["image","type"],"title":"V1DelegateTasksPostRequestBodyContentApplicationJsonSchemaAttachmentsItems"},"V1DelegateTasksPostRequestBodyContentApplicationJsonSchemaPriority":{"type":"string","enum":["standard","fast"],"description":"Execution speed. `standard` (the default) runs at normal speed; `fast` runs at a higher speed for tasks that need it. Applies when creating a task.","title":"V1DelegateTasksPostRequestBodyContentApplicationJsonSchemaPriority"},"V1DelegateTasksPostRequestBodyContentApplicationJsonSchemaTarget":{"type":"string","enum":["operator","otto"],"description":"Who works the task. Defaults to `operator`; `otto` hands it to Otto, the account's saved product-engineer agent, and needs the `delegate-to-otto` account flag.","title":"V1DelegateTasksPostRequestBodyContentApplicationJsonSchemaTarget"},"V1DelegateTasksPostResponsesContentApplicationJsonSchemaPriority":{"type":"string","enum":["standard","fast"],"title":"V1DelegateTasksPostResponsesContentApplicationJsonSchemaPriority"},"V1DelegateTasksPostResponsesContentApplicationJsonSchemaResultLinksItems":{"type":"object","properties":{"label":{"type":"string","minLength":1,"maxLength":200},"url":{"type":"string","format":"uri","maxLength":2048}},"required":["label","url"],"title":"V1DelegateTasksPostResponsesContentApplicationJsonSchemaResultLinksItems"},"V1DelegateTasksPostResponsesContentApplicationJsonSchemaResultTouchedEntitiesItemsAction":{"type":"string","enum":["created","updated","deleted","executed","read"],"title":"V1DelegateTasksPostResponsesContentApplicationJsonSchemaResultTouchedEntitiesItemsAction"},"V1DelegateTasksPostResponsesContentApplicationJsonSchemaResultTouchedEntitiesItems":{"type":"object","properties":{"action":{"$ref":"#/components/schemas/V1DelegateTasksPostResponsesContentApplicationJsonSchemaResultTouchedEntitiesItemsAction"},"id":{"type":"string","minLength":1,"maxLength":255},"kind":{"type":"string","minLength":1,"maxLength":64},"name":{"type":"string","maxLength":255},"runIds":{"type":"array","items":{"type":"string","minLength":1,"maxLength":255}}},"required":["action","id","kind"],"title":"V1DelegateTasksPostResponsesContentApplicationJsonSchemaResultTouchedEntitiesItems"},"V1DelegateTasksPostResponsesContentApplicationJsonSchemaResult":{"type":"object","properties":{"links":{"type":"array","items":{"$ref":"#/components/schemas/V1DelegateTasksPostResponsesContentApplicationJsonSchemaResultLinksItems"}},"modelRoundCount":{"type":"integer","minimum":0},"summary":{"type":"string","maxLength":4000},"toolCallCount":{"type":"integer","minimum":0},"totalCost":{"type":"number","format":"double","minimum":0},"touchedEntities":{"type":"array","items":{"$ref":"#/components/schemas/V1DelegateTasksPostResponsesContentApplicationJsonSchemaResultTouchedEntitiesItems"}},"warnings":{"type":"array","items":{"type":"string","maxLength":1000}}},"required":["links","modelRoundCount","summary","toolCallCount","touchedEntities"],"title":"V1DelegateTasksPostResponsesContentApplicationJsonSchemaResult"},"V1DelegateTasksPostResponsesContentApplicationJsonSchemaStatus":{"type":"string","enum":["queued","running","input_required","completed","failed","cancelled"],"title":"V1DelegateTasksPostResponsesContentApplicationJsonSchemaStatus"},"V1DelegateTasksPostResponsesContentApplicationJsonSchemaTarget":{"type":"string","enum":["operator","otto"],"description":"Who works the task; `operator` when absent.","title":"V1DelegateTasksPostResponsesContentApplicationJsonSchemaTarget"},"V1DelegateTasksPostResponsesContentApplicationJsonSchemaTouchedEntitiesItemsAction":{"type":"string","enum":["created","updated","deleted","executed","read"],"title":"V1DelegateTasksPostResponsesContentApplicationJsonSchemaTouchedEntitiesItemsAction"},"V1DelegateTasksPostResponsesContentApplicationJsonSchemaTouchedEntitiesItems":{"type":"object","properties":{"action":{"$ref":"#/components/schemas/V1DelegateTasksPostResponsesContentApplicationJsonSchemaTouchedEntitiesItemsAction"},"id":{"type":"string","minLength":1,"maxLength":255},"kind":{"type":"string","minLength":1,"maxLength":64},"name":{"type":"string","maxLength":255},"runIds":{"type":"array","items":{"type":"string","minLength":1,"maxLength":255}}},"required":["action","id","kind"],"title":"V1DelegateTasksPostResponsesContentApplicationJsonSchemaTouchedEntitiesItems"},"Delegate_tasks_delegateATaskToTheRuntypeOperatorAgent_Response_200":{"type":"object","properties":{"allowDestructive":{"type":"boolean","description":"Whether the caller allowed destructive and consequential operations."},"allowSimulationRun":{"type":"boolean","description":"Whether the caller allowed starting simulation runs, and no other gated operation."},"apiKeyId":{"type":["string","null"]},"attachmentCount":{"type":"integer","minimum":0,"description":"Images the task started with; read each from its attachment route."},"clientName":{"type":["string","null"]},"clientVersion":{"type":["string","null"]},"completedAt":{"type":["string","null"]},"context":{"description":"Any type"},"createdAt":{"type":"string"},"deduplicated":{"type":"boolean","description":"True when an identical delegation from the same caller was still running, so that task was returned instead of starting another."},"error":{"type":["string","null"]},"id":{"type":"string"},"instruction":{"type":"string"},"lastEventSeq":{"type":"integer","minimum":0},"modelRoundCount":{"type":"integer","minimum":0},"organizationId":{"type":"string"},"priority":{"$ref":"#/components/schemas/V1DelegateTasksPostResponsesContentApplicationJsonSchemaPriority"},"question":{"type":["string","null"]},"result":{"oneOf":[{"$ref":"#/components/schemas/V1DelegateTasksPostResponsesContentApplicationJsonSchemaResult"},{"type":"null"}]},"startedAt":{"type":["string","null"]},"status":{"$ref":"#/components/schemas/V1DelegateTasksPostResponsesContentApplicationJsonSchemaStatus"},"summary":{"type":["string","null"]},"target":{"$ref":"#/components/schemas/V1DelegateTasksPostResponsesContentApplicationJsonSchemaTarget","description":"Who works the task; `operator` when absent."},"targetExecutionId":{"type":["string","null"],"description":"The worker's execution for the latest turn, when it has its own: an Otto run."},"toolCallCount":{"type":"integer","minimum":0},"totalCost":{"type":["number","null"],"format":"double"},"touchedEntities":{"type":"array","items":{"$ref":"#/components/schemas/V1DelegateTasksPostResponsesContentApplicationJsonSchemaTouchedEntitiesItems"}},"updatedAt":{"type":"string"},"userId":{"type":"string"}},"required":["apiKeyId","clientName","clientVersion","completedAt","createdAt","error","id","instruction","lastEventSeq","modelRoundCount","organizationId","question","result","startedAt","status","summary","toolCallCount","totalCost","touchedEntities","updatedAt","userId"],"title":"Delegate tasks_delegateATaskToTheRuntypeOperatorAgent_Response_200"},"V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaEventsItemsOneOf0Type":{"type":"string","enum":["task_started"],"title":"V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaEventsItemsOneOf0Type"},"V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaEventsItems0":{"type":"object","properties":{"at":{"type":"string"},"instruction":{"type":"string"},"seq":{"type":"integer","minimum":0},"taskId":{"type":"string"},"type":{"$ref":"#/components/schemas/V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaEventsItemsOneOf0Type"}},"required":["at","instruction","seq","taskId","type"],"title":"V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaEventsItems0"},"V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaEventsItemsOneOf1Type":{"type":"string","enum":["model_round"],"title":"V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaEventsItemsOneOf1Type"},"V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaEventsItems1":{"type":"object","properties":{"at":{"type":"string"},"round":{"type":"integer","minimum":0},"seq":{"type":"integer","minimum":0},"text":{"type":"string","maxLength":2000},"thinking":{"type":"boolean"},"type":{"$ref":"#/components/schemas/V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaEventsItemsOneOf1Type"}},"required":["at","round","seq","type"],"title":"V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaEventsItems1"},"V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaEventsItemsOneOf2Type":{"type":"string","enum":["tool_call"],"title":"V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaEventsItemsOneOf2Type"},"V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaEventsItems2":{"type":"object","properties":{"args":{"description":"Any type"},"at":{"type":"string"},"callId":{"type":"string"},"scriptRead":{"type":"boolean"},"seq":{"type":"integer","minimum":0},"tool":{"type":"string"},"type":{"$ref":"#/components/schemas/V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaEventsItemsOneOf2Type"}},"required":["at","callId","seq","tool","type"],"title":"V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaEventsItems2"},"V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaEventsItemsOneOf3EntityAction":{"type":"string","enum":["created","updated","deleted","executed","read"],"title":"V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaEventsItemsOneOf3EntityAction"},"V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaEventsItemsOneOf3Entity":{"type":"object","properties":{"action":{"$ref":"#/components/schemas/V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaEventsItemsOneOf3EntityAction"},"id":{"type":"string","minLength":1,"maxLength":255},"kind":{"type":"string","minLength":1,"maxLength":64},"name":{"type":"string","maxLength":255},"runIds":{"type":"array","items":{"type":"string","minLength":1,"maxLength":255}}},"required":["action","id","kind"],"title":"V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaEventsItemsOneOf3Entity"},"V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaEventsItemsOneOf3Type":{"type":"string","enum":["tool_result"],"title":"V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaEventsItemsOneOf3Type"},"V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaEventsItems3":{"type":"object","properties":{"at":{"type":"string"},"callId":{"type":"string"},"durationMs":{"type":"integer","minimum":0},"entity":{"$ref":"#/components/schemas/V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaEventsItemsOneOf3Entity"},"ok":{"type":"boolean"},"scriptRead":{"type":"boolean"},"seq":{"type":"integer","minimum":0},"summary":{"type":"string","maxLength":1024},"tool":{"type":"string"},"type":{"$ref":"#/components/schemas/V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaEventsItemsOneOf3Type"}},"required":["at","callId","durationMs","ok","seq","summary","tool","type"],"title":"V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaEventsItems3"},"V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaEventsItemsOneOf4Type":{"type":"string","enum":["milestone"],"title":"V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaEventsItemsOneOf4Type"},"V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaEventsItems4":{"type":"object","properties":{"at":{"type":"string"},"message":{"type":"string","maxLength":500},"seq":{"type":"integer","minimum":0},"type":{"$ref":"#/components/schemas/V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaEventsItemsOneOf4Type"}},"required":["at","message","seq","type"],"title":"V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaEventsItems4"},"V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaEventsItemsOneOf5Type":{"type":"string","enum":["question"],"title":"V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaEventsItemsOneOf5Type"},"V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaEventsItems5":{"type":"object","properties":{"at":{"type":"string"},"question":{"type":"string","maxLength":4000},"seq":{"type":"integer","minimum":0},"type":{"$ref":"#/components/schemas/V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaEventsItemsOneOf5Type"}},"required":["at","question","seq","type"],"title":"V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaEventsItems5"},"V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaEventsItemsOneOf6Type":{"type":"string","enum":["message_received"],"title":"V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaEventsItemsOneOf6Type"},"V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaEventsItems6":{"type":"object","properties":{"at":{"type":"string"},"message":{"type":"string","maxLength":20000},"seq":{"type":"integer","minimum":0},"type":{"$ref":"#/components/schemas/V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaEventsItemsOneOf6Type"}},"required":["at","message","seq","type"],"title":"V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaEventsItems6"},"V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaEventsItemsOneOf7ResultLinksItems":{"type":"object","properties":{"label":{"type":"string","minLength":1,"maxLength":200},"url":{"type":"string","format":"uri","maxLength":2048}},"required":["label","url"],"title":"V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaEventsItemsOneOf7ResultLinksItems"},"V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaEventsItemsOneOf7ResultTouchedEntitiesItemsAction":{"type":"string","enum":["created","updated","deleted","executed","read"],"title":"V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaEventsItemsOneOf7ResultTouchedEntitiesItemsAction"},"V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaEventsItemsOneOf7ResultTouchedEntitiesItems":{"type":"object","properties":{"action":{"$ref":"#/components/schemas/V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaEventsItemsOneOf7ResultTouchedEntitiesItemsAction"},"id":{"type":"string","minLength":1,"maxLength":255},"kind":{"type":"string","minLength":1,"maxLength":64},"name":{"type":"string","maxLength":255},"runIds":{"type":"array","items":{"type":"string","minLength":1,"maxLength":255}}},"required":["action","id","kind"],"title":"V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaEventsItemsOneOf7ResultTouchedEntitiesItems"},"V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaEventsItemsOneOf7Result":{"type":"object","properties":{"links":{"type":"array","items":{"$ref":"#/components/schemas/V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaEventsItemsOneOf7ResultLinksItems"}},"modelRoundCount":{"type":"integer","minimum":0},"summary":{"type":"string","maxLength":4000},"toolCallCount":{"type":"integer","minimum":0},"totalCost":{"type":"number","format":"double","minimum":0},"touchedEntities":{"type":"array","items":{"$ref":"#/components/schemas/V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaEventsItemsOneOf7ResultTouchedEntitiesItems"}},"warnings":{"type":"array","items":{"type":"string","maxLength":1000}}},"required":["links","modelRoundCount","summary","toolCallCount","touchedEntities"],"title":"V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaEventsItemsOneOf7Result"},"V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaEventsItemsOneOf7Type":{"type":"string","enum":["task_completed"],"title":"V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaEventsItemsOneOf7Type"},"V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaEventsItems7":{"type":"object","properties":{"at":{"type":"string"},"result":{"$ref":"#/components/schemas/V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaEventsItemsOneOf7Result"},"seq":{"type":"integer","minimum":0},"type":{"$ref":"#/components/schemas/V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaEventsItemsOneOf7Type"}},"required":["at","result","seq","type"],"title":"V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaEventsItems7"},"V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaEventsItemsOneOf8Type":{"type":"string","enum":["task_failed"],"title":"V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaEventsItemsOneOf8Type"},"V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaEventsItems8":{"type":"object","properties":{"at":{"type":"string"},"error":{"type":"string","maxLength":4000},"seq":{"type":"integer","minimum":0},"type":{"$ref":"#/components/schemas/V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaEventsItemsOneOf8Type"}},"required":["at","error","seq","type"],"title":"V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaEventsItems8"},"V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaEventsItemsOneOf9Type":{"type":"string","enum":["task_cancelled"],"title":"V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaEventsItemsOneOf9Type"},"V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaEventsItems9":{"type":"object","properties":{"at":{"type":"string"},"seq":{"type":"integer","minimum":0},"type":{"$ref":"#/components/schemas/V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaEventsItemsOneOf9Type"}},"required":["at","seq","type"],"title":"V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaEventsItems9"},"V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaEventsItems":{"oneOf":[{"$ref":"#/components/schemas/V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaEventsItems0"},{"$ref":"#/components/schemas/V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaEventsItems1"},{"$ref":"#/components/schemas/V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaEventsItems2"},{"$ref":"#/components/schemas/V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaEventsItems3"},{"$ref":"#/components/schemas/V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaEventsItems4"},{"$ref":"#/components/schemas/V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaEventsItems5"},{"$ref":"#/components/schemas/V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaEventsItems6"},{"$ref":"#/components/schemas/V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaEventsItems7"},{"$ref":"#/components/schemas/V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaEventsItems8"},{"$ref":"#/components/schemas/V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaEventsItems9"}],"title":"V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaEventsItems"},"V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaTaskPriority":{"type":"string","enum":["standard","fast"],"title":"V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaTaskPriority"},"V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaTaskResultLinksItems":{"type":"object","properties":{"label":{"type":"string","minLength":1,"maxLength":200},"url":{"type":"string","format":"uri","maxLength":2048}},"required":["label","url"],"title":"V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaTaskResultLinksItems"},"V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaTaskResultTouchedEntitiesItemsAction":{"type":"string","enum":["created","updated","deleted","executed","read"],"title":"V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaTaskResultTouchedEntitiesItemsAction"},"V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaTaskResultTouchedEntitiesItems":{"type":"object","properties":{"action":{"$ref":"#/components/schemas/V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaTaskResultTouchedEntitiesItemsAction"},"id":{"type":"string","minLength":1,"maxLength":255},"kind":{"type":"string","minLength":1,"maxLength":64},"name":{"type":"string","maxLength":255},"runIds":{"type":"array","items":{"type":"string","minLength":1,"maxLength":255}}},"required":["action","id","kind"],"title":"V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaTaskResultTouchedEntitiesItems"},"V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaTaskResult":{"type":"object","properties":{"links":{"type":"array","items":{"$ref":"#/components/schemas/V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaTaskResultLinksItems"}},"modelRoundCount":{"type":"integer","minimum":0},"summary":{"type":"string","maxLength":4000},"toolCallCount":{"type":"integer","minimum":0},"totalCost":{"type":"number","format":"double","minimum":0},"touchedEntities":{"type":"array","items":{"$ref":"#/components/schemas/V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaTaskResultTouchedEntitiesItems"}},"warnings":{"type":"array","items":{"type":"string","maxLength":1000}}},"required":["links","modelRoundCount","summary","toolCallCount","touchedEntities"],"title":"V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaTaskResult"},"V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaTaskStatus":{"type":"string","enum":["queued","running","input_required","completed","failed","cancelled"],"title":"V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaTaskStatus"},"V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaTaskTarget":{"type":"string","enum":["operator","otto"],"description":"Who works the task; `operator` when absent.","title":"V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaTaskTarget"},"V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaTaskTouchedEntitiesItemsAction":{"type":"string","enum":["created","updated","deleted","executed","read"],"title":"V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaTaskTouchedEntitiesItemsAction"},"V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaTaskTouchedEntitiesItems":{"type":"object","properties":{"action":{"$ref":"#/components/schemas/V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaTaskTouchedEntitiesItemsAction"},"id":{"type":"string","minLength":1,"maxLength":255},"kind":{"type":"string","minLength":1,"maxLength":64},"name":{"type":"string","maxLength":255},"runIds":{"type":"array","items":{"type":"string","minLength":1,"maxLength":255}}},"required":["action","id","kind"],"title":"V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaTaskTouchedEntitiesItems"},"V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaTask":{"type":"object","properties":{"allowDestructive":{"type":"boolean","description":"Whether the caller allowed destructive and consequential operations."},"allowSimulationRun":{"type":"boolean","description":"Whether the caller allowed starting simulation runs, and no other gated operation."},"apiKeyId":{"type":["string","null"]},"attachmentCount":{"type":"integer","minimum":0,"description":"Images the task started with; read each from its attachment route."},"clientName":{"type":["string","null"]},"clientVersion":{"type":["string","null"]},"completedAt":{"type":["string","null"]},"context":{"description":"Any type"},"createdAt":{"type":"string"},"error":{"type":["string","null"]},"id":{"type":"string"},"instruction":{"type":"string"},"lastEventSeq":{"type":"integer","minimum":0},"modelRoundCount":{"type":"integer","minimum":0},"organizationId":{"type":"string"},"priority":{"$ref":"#/components/schemas/V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaTaskPriority"},"question":{"type":["string","null"]},"result":{"oneOf":[{"$ref":"#/components/schemas/V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaTaskResult"},{"type":"null"}]},"startedAt":{"type":["string","null"]},"status":{"$ref":"#/components/schemas/V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaTaskStatus"},"summary":{"type":["string","null"]},"target":{"$ref":"#/components/schemas/V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaTaskTarget","description":"Who works the task; `operator` when absent."},"targetExecutionId":{"type":["string","null"],"description":"The worker's execution for the latest turn, when it has its own: an Otto run."},"toolCallCount":{"type":"integer","minimum":0},"totalCost":{"type":["number","null"],"format":"double"},"touchedEntities":{"type":"array","items":{"$ref":"#/components/schemas/V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaTaskTouchedEntitiesItems"}},"updatedAt":{"type":"string"},"userId":{"type":"string"}},"required":["apiKeyId","clientName","clientVersion","completedAt","createdAt","error","id","instruction","lastEventSeq","modelRoundCount","organizationId","question","result","startedAt","status","summary","toolCallCount","totalCost","touchedEntities","updatedAt","userId"],"title":"V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaTask"},"Delegate_tasks_getADelegateTask_Response_200":{"type":"object","properties":{"events":{"type":"array","items":{"$ref":"#/components/schemas/V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaEventsItems"}},"task":{"$ref":"#/components/schemas/V1DelegateTasksIdGetResponsesContentApplicationJsonSchemaTask"}},"required":["events","task"],"title":"Delegate tasks_getADelegateTask_Response_200"},"V1DelegateTasksIdAttachmentsIndexGetResponsesContentApplicationJsonSchemaType":{"type":"string","enum":["image"],"title":"V1DelegateTasksIdAttachmentsIndexGetResponsesContentApplicationJsonSchemaType"},"Delegate_tasks_readAnImageADelegateTaskStartedWith_Response_200":{"type":"object","properties":{"image":{"type":"string","maxLength":2097152,"description":"The image as a data URL, up to 2 MB of text."},"mimeType":{"type":"string","maxLength":64},"type":{"$ref":"#/components/schemas/V1DelegateTasksIdAttachmentsIndexGetResponsesContentApplicationJsonSchemaType"}},"required":["image","type"],"title":"Delegate tasks_readAnImageADelegateTaskStartedWith_Response_200"},"V1DelegateTasksIdCancelPostResponsesContentApplicationJsonSchemaTaskPriority":{"type":"string","enum":["standard","fast"],"title":"V1DelegateTasksIdCancelPostResponsesContentApplicationJsonSchemaTaskPriority"},"V1DelegateTasksIdCancelPostResponsesContentApplicationJsonSchemaTaskResultLinksItems":{"type":"object","properties":{"label":{"type":"string","minLength":1,"maxLength":200},"url":{"type":"string","format":"uri","maxLength":2048}},"required":["label","url"],"title":"V1DelegateTasksIdCancelPostResponsesContentApplicationJsonSchemaTaskResultLinksItems"},"V1DelegateTasksIdCancelPostResponsesContentApplicationJsonSchemaTaskResultTouchedEntitiesItemsAction":{"type":"string","enum":["created","updated","deleted","executed","read"],"title":"V1DelegateTasksIdCancelPostResponsesContentApplicationJsonSchemaTaskResultTouchedEntitiesItemsAction"},"V1DelegateTasksIdCancelPostResponsesContentApplicationJsonSchemaTaskResultTouchedEntitiesItems":{"type":"object","properties":{"action":{"$ref":"#/components/schemas/V1DelegateTasksIdCancelPostResponsesContentApplicationJsonSchemaTaskResultTouchedEntitiesItemsAction"},"id":{"type":"string","minLength":1,"maxLength":255},"kind":{"type":"string","minLength":1,"maxLength":64},"name":{"type":"string","maxLength":255},"runIds":{"type":"array","items":{"type":"string","minLength":1,"maxLength":255}}},"required":["action","id","kind"],"title":"V1DelegateTasksIdCancelPostResponsesContentApplicationJsonSchemaTaskResultTouchedEntitiesItems"},"V1DelegateTasksIdCancelPostResponsesContentApplicationJsonSchemaTaskResult":{"type":"object","properties":{"links":{"type":"array","items":{"$ref":"#/components/schemas/V1DelegateTasksIdCancelPostResponsesContentApplicationJsonSchemaTaskResultLinksItems"}},"modelRoundCount":{"type":"integer","minimum":0},"summary":{"type":"string","maxLength":4000},"toolCallCount":{"type":"integer","minimum":0},"totalCost":{"type":"number","format":"double","minimum":0},"touchedEntities":{"type":"array","items":{"$ref":"#/components/schemas/V1DelegateTasksIdCancelPostResponsesContentApplicationJsonSchemaTaskResultTouchedEntitiesItems"}},"warnings":{"type":"array","items":{"type":"string","maxLength":1000}}},"required":["links","modelRoundCount","summary","toolCallCount","touchedEntities"],"title":"V1DelegateTasksIdCancelPostResponsesContentApplicationJsonSchemaTaskResult"},"V1DelegateTasksIdCancelPostResponsesContentApplicationJsonSchemaTaskStatus":{"type":"string","enum":["queued","running","input_required","completed","failed","cancelled"],"title":"V1DelegateTasksIdCancelPostResponsesContentApplicationJsonSchemaTaskStatus"},"V1DelegateTasksIdCancelPostResponsesContentApplicationJsonSchemaTaskTarget":{"type":"string","enum":["operator","otto"],"description":"Who works the task; `operator` when absent.","title":"V1DelegateTasksIdCancelPostResponsesContentApplicationJsonSchemaTaskTarget"},"V1DelegateTasksIdCancelPostResponsesContentApplicationJsonSchemaTaskTouchedEntitiesItemsAction":{"type":"string","enum":["created","updated","deleted","executed","read"],"title":"V1DelegateTasksIdCancelPostResponsesContentApplicationJsonSchemaTaskTouchedEntitiesItemsAction"},"V1DelegateTasksIdCancelPostResponsesContentApplicationJsonSchemaTaskTouchedEntitiesItems":{"type":"object","properties":{"action":{"$ref":"#/components/schemas/V1DelegateTasksIdCancelPostResponsesContentApplicationJsonSchemaTaskTouchedEntitiesItemsAction"},"id":{"type":"string","minLength":1,"maxLength":255},"kind":{"type":"string","minLength":1,"maxLength":64},"name":{"type":"string","maxLength":255},"runIds":{"type":"array","items":{"type":"string","minLength":1,"maxLength":255}}},"required":["action","id","kind"],"title":"V1DelegateTasksIdCancelPostResponsesContentApplicationJsonSchemaTaskTouchedEntitiesItems"},"V1DelegateTasksIdCancelPostResponsesContentApplicationJsonSchemaTask":{"type":"object","properties":{"allowDestructive":{"type":"boolean","description":"Whether the caller allowed destructive and consequential operations."},"allowSimulationRun":{"type":"boolean","description":"Whether the caller allowed starting simulation runs, and no other gated operation."},"apiKeyId":{"type":["string","null"]},"attachmentCount":{"type":"integer","minimum":0,"description":"Images the task started with; read each from its attachment route."},"clientName":{"type":["string","null"]},"clientVersion":{"type":["string","null"]},"completedAt":{"type":["string","null"]},"context":{"description":"Any type"},"createdAt":{"type":"string"},"error":{"type":["string","null"]},"id":{"type":"string"},"instruction":{"type":"string"},"lastEventSeq":{"type":"integer","minimum":0},"modelRoundCount":{"type":"integer","minimum":0},"organizationId":{"type":"string"},"priority":{"$ref":"#/components/schemas/V1DelegateTasksIdCancelPostResponsesContentApplicationJsonSchemaTaskPriority"},"question":{"type":["string","null"]},"result":{"oneOf":[{"$ref":"#/components/schemas/V1DelegateTasksIdCancelPostResponsesContentApplicationJsonSchemaTaskResult"},{"type":"null"}]},"startedAt":{"type":["string","null"]},"status":{"$ref":"#/components/schemas/V1DelegateTasksIdCancelPostResponsesContentApplicationJsonSchemaTaskStatus"},"summary":{"type":["string","null"]},"target":{"$ref":"#/components/schemas/V1DelegateTasksIdCancelPostResponsesContentApplicationJsonSchemaTaskTarget","description":"Who works the task; `operator` when absent."},"targetExecutionId":{"type":["string","null"],"description":"The worker's execution for the latest turn, when it has its own: an Otto run."},"toolCallCount":{"type":"integer","minimum":0},"totalCost":{"type":["number","null"],"format":"double"},"touchedEntities":{"type":"array","items":{"$ref":"#/components/schemas/V1DelegateTasksIdCancelPostResponsesContentApplicationJsonSchemaTaskTouchedEntitiesItems"}},"updatedAt":{"type":"string"},"userId":{"type":"string"}},"required":["apiKeyId","clientName","clientVersion","completedAt","createdAt","error","id","instruction","lastEventSeq","modelRoundCount","organizationId","question","result","startedAt","status","summary","toolCallCount","totalCost","touchedEntities","updatedAt","userId"],"title":"V1DelegateTasksIdCancelPostResponsesContentApplicationJsonSchemaTask"},"Delegate_tasks_cancelADelegateTask_Response_202":{"type":"object","properties":{"accepted":{"type":"boolean"},"task":{"$ref":"#/components/schemas/V1DelegateTasksIdCancelPostResponsesContentApplicationJsonSchemaTask"}},"required":["accepted","task"],"title":"Delegate tasks_cancelADelegateTask_Response_202"},"V1DelegateTasksIdMessagesPostResponsesContentApplicationJsonSchemaTaskPriority":{"type":"string","enum":["standard","fast"],"title":"V1DelegateTasksIdMessagesPostResponsesContentApplicationJsonSchemaTaskPriority"},"V1DelegateTasksIdMessagesPostResponsesContentApplicationJsonSchemaTaskResultLinksItems":{"type":"object","properties":{"label":{"type":"string","minLength":1,"maxLength":200},"url":{"type":"string","format":"uri","maxLength":2048}},"required":["label","url"],"title":"V1DelegateTasksIdMessagesPostResponsesContentApplicationJsonSchemaTaskResultLinksItems"},"V1DelegateTasksIdMessagesPostResponsesContentApplicationJsonSchemaTaskResultTouchedEntitiesItemsAction":{"type":"string","enum":["created","updated","deleted","executed","read"],"title":"V1DelegateTasksIdMessagesPostResponsesContentApplicationJsonSchemaTaskResultTouchedEntitiesItemsAction"},"V1DelegateTasksIdMessagesPostResponsesContentApplicationJsonSchemaTaskResultTouchedEntitiesItems":{"type":"object","properties":{"action":{"$ref":"#/components/schemas/V1DelegateTasksIdMessagesPostResponsesContentApplicationJsonSchemaTaskResultTouchedEntitiesItemsAction"},"id":{"type":"string","minLength":1,"maxLength":255},"kind":{"type":"string","minLength":1,"maxLength":64},"name":{"type":"string","maxLength":255},"runIds":{"type":"array","items":{"type":"string","minLength":1,"maxLength":255}}},"required":["action","id","kind"],"title":"V1DelegateTasksIdMessagesPostResponsesContentApplicationJsonSchemaTaskResultTouchedEntitiesItems"},"V1DelegateTasksIdMessagesPostResponsesContentApplicationJsonSchemaTaskResult":{"type":"object","properties":{"links":{"type":"array","items":{"$ref":"#/components/schemas/V1DelegateTasksIdMessagesPostResponsesContentApplicationJsonSchemaTaskResultLinksItems"}},"modelRoundCount":{"type":"integer","minimum":0},"summary":{"type":"string","maxLength":4000},"toolCallCount":{"type":"integer","minimum":0},"totalCost":{"type":"number","format":"double","minimum":0},"touchedEntities":{"type":"array","items":{"$ref":"#/components/schemas/V1DelegateTasksIdMessagesPostResponsesContentApplicationJsonSchemaTaskResultTouchedEntitiesItems"}},"warnings":{"type":"array","items":{"type":"string","maxLength":1000}}},"required":["links","modelRoundCount","summary","toolCallCount","touchedEntities"],"title":"V1DelegateTasksIdMessagesPostResponsesContentApplicationJsonSchemaTaskResult"},"V1DelegateTasksIdMessagesPostResponsesContentApplicationJsonSchemaTaskStatus":{"type":"string","enum":["queued","running","input_required","completed","failed","cancelled"],"title":"V1DelegateTasksIdMessagesPostResponsesContentApplicationJsonSchemaTaskStatus"},"V1DelegateTasksIdMessagesPostResponsesContentApplicationJsonSchemaTaskTarget":{"type":"string","enum":["operator","otto"],"description":"Who works the task; `operator` when absent.","title":"V1DelegateTasksIdMessagesPostResponsesContentApplicationJsonSchemaTaskTarget"},"V1DelegateTasksIdMessagesPostResponsesContentApplicationJsonSchemaTaskTouchedEntitiesItemsAction":{"type":"string","enum":["created","updated","deleted","executed","read"],"title":"V1DelegateTasksIdMessagesPostResponsesContentApplicationJsonSchemaTaskTouchedEntitiesItemsAction"},"V1DelegateTasksIdMessagesPostResponsesContentApplicationJsonSchemaTaskTouchedEntitiesItems":{"type":"object","properties":{"action":{"$ref":"#/components/schemas/V1DelegateTasksIdMessagesPostResponsesContentApplicationJsonSchemaTaskTouchedEntitiesItemsAction"},"id":{"type":"string","minLength":1,"maxLength":255},"kind":{"type":"string","minLength":1,"maxLength":64},"name":{"type":"string","maxLength":255},"runIds":{"type":"array","items":{"type":"string","minLength":1,"maxLength":255}}},"required":["action","id","kind"],"title":"V1DelegateTasksIdMessagesPostResponsesContentApplicationJsonSchemaTaskTouchedEntitiesItems"},"V1DelegateTasksIdMessagesPostResponsesContentApplicationJsonSchemaTask":{"type":"object","properties":{"allowDestructive":{"type":"boolean","description":"Whether the caller allowed destructive and consequential operations."},"allowSimulationRun":{"type":"boolean","description":"Whether the caller allowed starting simulation runs, and no other gated operation."},"apiKeyId":{"type":["string","null"]},"attachmentCount":{"type":"integer","minimum":0,"description":"Images the task started with; read each from its attachment route."},"clientName":{"type":["string","null"]},"clientVersion":{"type":["string","null"]},"completedAt":{"type":["string","null"]},"context":{"description":"Any type"},"createdAt":{"type":"string"},"error":{"type":["string","null"]},"id":{"type":"string"},"instruction":{"type":"string"},"lastEventSeq":{"type":"integer","minimum":0},"modelRoundCount":{"type":"integer","minimum":0},"organizationId":{"type":"string"},"priority":{"$ref":"#/components/schemas/V1DelegateTasksIdMessagesPostResponsesContentApplicationJsonSchemaTaskPriority"},"question":{"type":["string","null"]},"result":{"oneOf":[{"$ref":"#/components/schemas/V1DelegateTasksIdMessagesPostResponsesContentApplicationJsonSchemaTaskResult"},{"type":"null"}]},"startedAt":{"type":["string","null"]},"status":{"$ref":"#/components/schemas/V1DelegateTasksIdMessagesPostResponsesContentApplicationJsonSchemaTaskStatus"},"summary":{"type":["string","null"]},"target":{"$ref":"#/components/schemas/V1DelegateTasksIdMessagesPostResponsesContentApplicationJsonSchemaTaskTarget","description":"Who works the task; `operator` when absent."},"targetExecutionId":{"type":["string","null"],"description":"The worker's execution for the latest turn, when it has its own: an Otto run."},"toolCallCount":{"type":"integer","minimum":0},"totalCost":{"type":["number","null"],"format":"double"},"touchedEntities":{"type":"array","items":{"$ref":"#/components/schemas/V1DelegateTasksIdMessagesPostResponsesContentApplicationJsonSchemaTaskTouchedEntitiesItems"}},"updatedAt":{"type":"string"},"userId":{"type":"string"}},"required":["apiKeyId","clientName","clientVersion","completedAt","createdAt","error","id","instruction","lastEventSeq","modelRoundCount","organizationId","question","result","startedAt","status","summary","toolCallCount","totalCost","touchedEntities","updatedAt","userId"],"title":"V1DelegateTasksIdMessagesPostResponsesContentApplicationJsonSchemaTask"},"Delegate_tasks_sendAMessageToADelegateTask_Response_202":{"type":"object","properties":{"accepted":{"type":"boolean"},"messageSeq":{"type":"integer","minimum":0,"description":"Journal seq of the `message_received` event this message became."},"task":{"$ref":"#/components/schemas/V1DelegateTasksIdMessagesPostResponsesContentApplicationJsonSchemaTask"}},"required":["accepted","task"],"title":"Delegate tasks_sendAMessageToADelegateTask_Response_202"},"V1DevicesGetResponsesContentApplicationJsonSchemaDataItemsPlatform":{"type":"string","enum":["macos","cli"],"title":"V1DevicesGetResponsesContentApplicationJsonSchemaDataItemsPlatform"},"V1DevicesGetResponsesContentApplicationJsonSchemaDataItemsStatus":{"type":"object","properties":{"appVersion":{"type":"string"},"availableTools":{"type":"array","items":{"type":"string"}},"deviceId":{"type":"string"},"lastSeenAt":{"type":"string"},"online":{"type":"boolean"},"protocolVersion":{"type":"number","format":"double"}},"required":["availableTools","deviceId","online"],"title":"V1DevicesGetResponsesContentApplicationJsonSchemaDataItemsStatus"},"V1DevicesGetResponsesContentApplicationJsonSchemaDataItems":{"type":"object","properties":{"appVersion":{"type":["string","null"]},"createdAt":{"type":"string"},"id":{"type":"string"},"lastAuthenticatedAt":{"type":["string","null"]},"mcpUrl":{"type":"string","format":"uri"},"name":{"type":"string"},"platform":{"$ref":"#/components/schemas/V1DevicesGetResponsesContentApplicationJsonSchemaDataItemsPlatform"},"publicKeyFingerprint":{"type":"string"},"revokedAt":{"type":["string","null"]},"status":{"$ref":"#/components/schemas/V1DevicesGetResponsesContentApplicationJsonSchemaDataItemsStatus"},"updatedAt":{"type":"string"}},"required":["appVersion","createdAt","id","lastAuthenticatedAt","mcpUrl","name","platform","publicKeyFingerprint","revokedAt","status","updatedAt"],"title":"V1DevicesGetResponsesContentApplicationJsonSchemaDataItems"},"Devices_listPairedDevices_Response_200":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1DevicesGetResponsesContentApplicationJsonSchemaDataItems"}}},"required":["data"],"title":"Devices_listPairedDevices_Response_200"},"V1DevicesLoopbackPostResponsesContentApplicationJsonSchemaDataPlatform":{"type":"string","enum":["macos","cli"],"title":"V1DevicesLoopbackPostResponsesContentApplicationJsonSchemaDataPlatform"},"V1DevicesLoopbackPostResponsesContentApplicationJsonSchemaDataStatus":{"type":"object","properties":{"appVersion":{"type":"string"},"availableTools":{"type":"array","items":{"type":"string"}},"deviceId":{"type":"string"},"lastSeenAt":{"type":"string"},"online":{"type":"boolean"},"protocolVersion":{"type":"number","format":"double"}},"required":["availableTools","deviceId","online"],"title":"V1DevicesLoopbackPostResponsesContentApplicationJsonSchemaDataStatus"},"V1DevicesLoopbackPostResponsesContentApplicationJsonSchemaData":{"type":"object","properties":{"appVersion":{"type":["string","null"]},"createdAt":{"type":"string"},"id":{"type":"string"},"lastAuthenticatedAt":{"type":["string","null"]},"mcpUrl":{"type":"string","format":"uri"},"name":{"type":"string"},"platform":{"$ref":"#/components/schemas/V1DevicesLoopbackPostResponsesContentApplicationJsonSchemaDataPlatform"},"publicKeyFingerprint":{"type":"string"},"revokedAt":{"type":["string","null"]},"status":{"$ref":"#/components/schemas/V1DevicesLoopbackPostResponsesContentApplicationJsonSchemaDataStatus"},"updatedAt":{"type":"string"}},"required":["appVersion","createdAt","id","lastAuthenticatedAt","mcpUrl","name","platform","publicKeyFingerprint","revokedAt","status","updatedAt"],"title":"V1DevicesLoopbackPostResponsesContentApplicationJsonSchemaData"},"Devices_registerThisComputerAsALocalLoopbackDeviceDevelopmentOnly_Response_201":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/V1DevicesLoopbackPostResponsesContentApplicationJsonSchemaData"}},"required":["data"],"title":"Devices_registerThisComputerAsALocalLoopbackDeviceDevelopmentOnly_Response_201"},"V1DevicesPairPostRequestBodyContentApplicationJsonSchemaPlatform":{"type":"string","enum":["macos","cli"],"title":"V1DevicesPairPostRequestBodyContentApplicationJsonSchemaPlatform"},"V1DevicesPairPostResponsesContentApplicationJsonSchemaDataPlatform":{"type":"string","enum":["macos","cli"],"title":"V1DevicesPairPostResponsesContentApplicationJsonSchemaDataPlatform"},"V1DevicesPairPostResponsesContentApplicationJsonSchemaData":{"type":"object","properties":{"appVersion":{"type":["string","null"]},"createdAt":{"type":"string"},"id":{"type":"string"},"lastAuthenticatedAt":{"type":["string","null"]},"name":{"type":"string"},"platform":{"$ref":"#/components/schemas/V1DevicesPairPostResponsesContentApplicationJsonSchemaDataPlatform"},"publicKeyFingerprint":{"type":"string"},"revokedAt":{"type":["string","null"]},"updatedAt":{"type":"string"}},"required":["appVersion","createdAt","id","lastAuthenticatedAt","name","platform","publicKeyFingerprint","revokedAt","updatedAt"],"title":"V1DevicesPairPostResponsesContentApplicationJsonSchemaData"},"Devices_claimAOneTimePairingCodeFromAMac_Response_201":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/V1DevicesPairPostResponsesContentApplicationJsonSchemaData"}},"required":["data"],"title":"Devices_claimAOneTimePairingCodeFromAMac_Response_201"},"V1DevicesPairingSessionsPostResponsesContentApplicationJsonSchemaData":{"type":"object","properties":{"code":{"type":"string"},"expiresAt":{"type":"string"},"id":{"type":"string"},"pairingUri":{"type":"string"}},"required":["code","expiresAt","id","pairingUri"],"title":"V1DevicesPairingSessionsPostResponsesContentApplicationJsonSchemaData"},"Devices_createAOneTimeDevicePairingSession_Response_201":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/V1DevicesPairingSessionsPostResponsesContentApplicationJsonSchemaData"}},"required":["data"],"title":"Devices_createAOneTimeDevicePairingSession_Response_201"},"V1DevicesIdGetResponsesContentApplicationJsonSchemaDataPlatform":{"type":"string","enum":["macos","cli"],"title":"V1DevicesIdGetResponsesContentApplicationJsonSchemaDataPlatform"},"V1DevicesIdGetResponsesContentApplicationJsonSchemaDataStatus":{"type":"object","properties":{"appVersion":{"type":"string"},"availableTools":{"type":"array","items":{"type":"string"}},"deviceId":{"type":"string"},"lastSeenAt":{"type":"string"},"online":{"type":"boolean"},"protocolVersion":{"type":"number","format":"double"}},"required":["availableTools","deviceId","online"],"title":"V1DevicesIdGetResponsesContentApplicationJsonSchemaDataStatus"},"V1DevicesIdGetResponsesContentApplicationJsonSchemaData":{"type":"object","properties":{"appVersion":{"type":["string","null"]},"createdAt":{"type":"string"},"id":{"type":"string"},"lastAuthenticatedAt":{"type":["string","null"]},"mcpUrl":{"type":"string","format":"uri"},"name":{"type":"string"},"platform":{"$ref":"#/components/schemas/V1DevicesIdGetResponsesContentApplicationJsonSchemaDataPlatform"},"publicKeyFingerprint":{"type":"string"},"revokedAt":{"type":["string","null"]},"status":{"$ref":"#/components/schemas/V1DevicesIdGetResponsesContentApplicationJsonSchemaDataStatus"},"updatedAt":{"type":"string"}},"required":["appVersion","createdAt","id","lastAuthenticatedAt","mcpUrl","name","platform","publicKeyFingerprint","revokedAt","status","updatedAt"],"title":"V1DevicesIdGetResponsesContentApplicationJsonSchemaData"},"Devices_getAPairedDevice_Response_200":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/V1DevicesIdGetResponsesContentApplicationJsonSchemaData"}},"required":["data"],"title":"Devices_getAPairedDevice_Response_200"},"V1DevicesIdConnectionTokenPostResponsesContentApplicationJsonSchemaData":{"type":"object","properties":{"connectionId":{"type":"string"},"expiresAt":{"type":"string"},"relayUrl":{"type":"string"},"token":{"type":"string"}},"required":["connectionId","expiresAt","relayUrl","token"],"title":"V1DevicesIdConnectionTokenPostResponsesContentApplicationJsonSchemaData"},"Devices_exchangeASignedDeviceChallengeForAShortLivedRelayToken_Response_200":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/V1DevicesIdConnectionTokenPostResponsesContentApplicationJsonSchemaData"}},"required":["data"],"title":"Devices_exchangeASignedDeviceChallengeForAShortLivedRelayToken_Response_200"},"V1DevicesIdRevokePostResponsesContentApplicationJsonSchemaDataPlatform":{"type":"string","enum":["macos","cli"],"title":"V1DevicesIdRevokePostResponsesContentApplicationJsonSchemaDataPlatform"},"V1DevicesIdRevokePostResponsesContentApplicationJsonSchemaData":{"type":"object","properties":{"appVersion":{"type":["string","null"]},"createdAt":{"type":"string"},"id":{"type":"string"},"lastAuthenticatedAt":{"type":["string","null"]},"name":{"type":"string"},"platform":{"$ref":"#/components/schemas/V1DevicesIdRevokePostResponsesContentApplicationJsonSchemaDataPlatform"},"publicKeyFingerprint":{"type":"string"},"revokedAt":{"type":["string","null"]},"updatedAt":{"type":"string"}},"required":["appVersion","createdAt","id","lastAuthenticatedAt","name","platform","publicKeyFingerprint","revokedAt","updatedAt"],"title":"V1DevicesIdRevokePostResponsesContentApplicationJsonSchemaData"},"Devices_revokeAPairedDevice_Response_200":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/V1DevicesIdRevokePostResponsesContentApplicationJsonSchemaData"}},"required":["data"],"title":"Devices_revokeAPairedDevice_Response_200"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentAdvisor":{"type":"object","properties":{"model":{"type":"string"},"systemPrompt":{"type":"string"}},"required":["model"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentAdvisor"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentAgentType":{"type":"string","enum":["runtype","claude_managed"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentAgentType"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentArtifactsTypesItems":{"type":"string","enum":["markdown","component"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentArtifactsTypesItems"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentArtifacts":{"type":"object","properties":{"enabled":{"type":"boolean"},"types":{"type":"array","items":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentArtifactsTypesItems"}}},"required":["enabled","types"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentArtifacts"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentBusyMessageRoutingMode":{"type":"string","enum":["enforced","off"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentBusyMessageRoutingMode"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentBusyMessageRouting":{"type":"object","properties":{"classifierModel":{"type":"string","minLength":1,"maxLength":200},"mode":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentBusyMessageRoutingMode"}},"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentBusyMessageRouting"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentClaudeManagedConfigSetupMode":{"type":"string","enum":["create","connect"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentClaudeManagedConfigSetupMode"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentClaudeManagedConfig":{"type":"object","properties":{"anthropicAgentId":{"type":"string"},"anthropicAgentVersion":{"type":"integer"},"anthropicEnvironmentId":{"type":"string"},"autoDelete":{"type":"boolean"},"model":{"type":"string"},"setupMode":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentClaudeManagedConfigSetupMode"},"systemPrompt":{"type":"string"}},"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentClaudeManagedConfig"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentDurabilityForced":{"type":"string","enum":["durable","in_process"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentDurabilityForced"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentDurability":{"type":"object","properties":{"forced":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentDurabilityForced"},"maxBudgetMs":{"type":["integer","null"],"minimum":1000,"maximum":86400000},"watchLeaseMs":{"type":["integer","null"],"minimum":10000,"maximum":1800000}},"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentDurability"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentErrorHandlingFallbacksItemsOneOf0Type":{"type":"string","enum":["retry"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentErrorHandlingFallbacksItemsOneOf0Type"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentErrorHandlingFallbacksItems0":{"type":"object","properties":{"delay":{"type":"integer","minimum":0,"maximum":60000},"type":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentErrorHandlingFallbacksItemsOneOf0Type"}},"required":["type"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentErrorHandlingFallbacksItems0"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentErrorHandlingFallbacksItemsOneOf1Type":{"type":"string","enum":["model"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentErrorHandlingFallbacksItemsOneOf1Type"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentErrorHandlingFallbacksItems1":{"type":"object","properties":{"delay":{"type":"integer","minimum":0,"maximum":60000},"maxTokens":{"type":"integer","minimum":1},"model":{"type":"string"},"temperature":{"type":"number","format":"double","minimum":0,"maximum":2},"type":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentErrorHandlingFallbacksItemsOneOf1Type"}},"required":["model","type"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentErrorHandlingFallbacksItems1"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentErrorHandlingFallbacksItemsOneOf2Type":{"type":"string","enum":["message"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentErrorHandlingFallbacksItemsOneOf2Type"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentErrorHandlingFallbacksItems2":{"type":"object","properties":{"delay":{"type":"integer","minimum":0,"maximum":60000},"message":{"type":"string"},"type":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentErrorHandlingFallbacksItemsOneOf2Type"}},"required":["message","type"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentErrorHandlingFallbacksItems2"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentErrorHandlingFallbacksItems":{"oneOf":[{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentErrorHandlingFallbacksItems0"},{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentErrorHandlingFallbacksItems1"},{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentErrorHandlingFallbacksItems2"}],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentErrorHandlingFallbacksItems"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentErrorHandlingOnError":{"type":"string","enum":["fail","continue","fallback"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentErrorHandlingOnError"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentErrorHandlingTriggersItemsType":{"type":"string","enum":["error","empty-output"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentErrorHandlingTriggersItemsType"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentErrorHandlingTriggersItems":{"type":"object","properties":{"type":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentErrorHandlingTriggersItemsType"}},"required":["type"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentErrorHandlingTriggersItems"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentErrorHandling":{"type":"object","properties":{"fallbacks":{"type":"array","items":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentErrorHandlingFallbacksItems"}},"onError":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentErrorHandlingOnError"},"triggers":{"type":"array","items":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentErrorHandlingTriggersItems"}}},"required":["onError"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentErrorHandling"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentLoggingPolicy":{"type":"string","enum":["default","on","off"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentLoggingPolicy"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentLoopConfig":{"type":"object","properties":{"enableReflection":{"type":"boolean"},"maxCost":{"type":"number","format":"double","minimum":0},"maxTurns":{"type":"integer","minimum":1,"maximum":100},"reflectionInterval":{"type":"integer","minimum":1,"maximum":50},"treatLengthCutoffAsFailure":{"type":"boolean"}},"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentLoopConfig"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentMemoryPointerScope":{"type":"string","enum":["shared","alias","version"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentMemoryPointerScope"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentMemory":{"type":"object","properties":{"enabled":{"type":"boolean"},"injectSummary":{"type":"boolean"},"pointerScope":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentMemoryPointerScope"},"profileTemplate":{"type":"string"}},"required":["enabled"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentMemory"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentPiiRedaction":{"type":"string","enum":["default","off","redact"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentPiiRedaction"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentReasoningOneOf1ReasoningEffort":{"type":"string","enum":["minimal","low","medium","high","xhigh","max"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentReasoningOneOf1ReasoningEffort"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentReasoningOneOf1ReasoningSummary":{"type":"string","enum":["auto","detailed"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentReasoningOneOf1ReasoningSummary"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentReasoning1":{"type":"object","properties":{"budgetTokens":{"type":"integer","minimum":1000,"maximum":100000},"effort":{"type":"string","minLength":1,"maxLength":32},"enabled":{"type":"boolean"},"includeThoughts":{"type":"boolean"},"reasoningEffort":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentReasoningOneOf1ReasoningEffort"},"reasoningSummary":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentReasoningOneOf1ReasoningSummary"},"thinkingBudget":{"type":"integer","minimum":1024,"maximum":65536},"thinkingLevel":{"type":"string","minLength":1,"maxLength":32}},"required":["enabled"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentReasoning1"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentReasoning":{"oneOf":[{"type":"boolean"},{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentReasoning1"}],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentReasoning"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentSandboxCodingAgentsItems":{"type":"string","enum":["opencode"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentSandboxCodingAgentsItems"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentSandboxInstanceType":{"type":"string","enum":["standard-1","standard-2","standard-3","standard-4"],"description":"Only standard-4 is supported on the hosted Agent Sandbox path; other sizes cannot be enabled.","title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentSandboxInstanceType"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentSandboxNetworkAccess0":{"type":"string","enum":["none","essentials","open"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentSandboxNetworkAccess0"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentSandboxNetworkAccessOneOf1Profile":{"type":"string","enum":["none","essentials","open"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentSandboxNetworkAccessOneOf1Profile"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentSandboxNetworkAccess1":{"type":"object","properties":{"allow":{"type":"array","items":{"type":"string"}},"profile":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentSandboxNetworkAccessOneOf1Profile"}},"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentSandboxNetworkAccess1"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentSandboxNetworkAccess":{"oneOf":[{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentSandboxNetworkAccess0"},{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentSandboxNetworkAccess1"}],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentSandboxNetworkAccess"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentSandboxPersistence":{"type":"string","enum":["ephemeral","conversation","named"],"description":"Supported: ephemeral or conversation. Named remains parseable for stored configs but cannot be enabled.","title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentSandboxPersistence"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentSandboxProvider":{"type":"string","enum":["runtype-sandbox","daytona"],"description":"Only runtype-sandbox is currently supported. Daytona is retained for stored-config parsing but rejected at authoring/execution.","title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentSandboxProvider"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentSandboxSleepAfter":{"type":"string","enum":["5m","15m","30m","1h"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentSandboxSleepAfter"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentSandboxTtl":{"type":"string","enum":["5m","1h","24h","unlimited"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentSandboxTtl"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentSandbox":{"type":"object","properties":{"codingAgents":{"type":"array","items":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentSandboxCodingAgentsItems"},"description":"Coding agents the Sandbox can run as typed sessions. Non-empty adds the agent_session_* tools; empty or absent adds none."},"enabled":{"type":"boolean"},"instanceType":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentSandboxInstanceType","description":"Only standard-4 is supported on the hosted Agent Sandbox path; other sizes cannot be enabled."},"networkAccess":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentSandboxNetworkAccess"},"persistence":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentSandboxPersistence","description":"Supported: ephemeral or conversation. Named remains parseable for stored configs but cannot be enabled."},"provider":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentSandboxProvider","description":"Only runtype-sandbox is currently supported. Daytona is retained for stored-config parsing but rejected at authoring/execution."},"secretEnv":{"type":"object","additionalProperties":{"type":"string","minLength":1}},"setupCommands":{"type":"array","items":{"type":"string","minLength":1}},"sleepAfter":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentSandboxSleepAfter"},"ttl":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentSandboxTtl"}},"required":["enabled"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentSandbox"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentTemporal":{"type":"object","properties":{"elapsedThresholdSeconds":{"type":"integer","minimum":0},"groundNow":{"type":"boolean"},"injectElapsed":{"type":"boolean"},"timezone":{"type":"string"}},"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentTemporal"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentTenancyStrategyAssuranceFloorEndUser":{"type":"string","enum":["asserted","verified"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentTenancyStrategyAssuranceFloorEndUser"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentTenancyStrategyAssuranceFloorTenant":{"type":"string","enum":["asserted","verified"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentTenancyStrategyAssuranceFloorTenant"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentTenancyStrategyAssuranceFloor":{"type":"object","properties":{"endUser":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentTenancyStrategyAssuranceFloorEndUser"},"tenant":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentTenancyStrategyAssuranceFloorTenant"}},"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentTenancyStrategyAssuranceFloor"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentTenancyStrategyPreset":{"type":"string","enum":["internal","tenant-isolated","end-user-isolated"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentTenancyStrategyPreset"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentTenancyStrategy":{"type":"object","properties":{"assuranceFloor":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentTenancyStrategyAssuranceFloor"},"preset":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentTenancyStrategyPreset"}},"required":["preset"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentTenancyStrategy"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentToolsApprovalChoices":{"type":"object","properties":{"alwaysAllow":{"type":"boolean"},"alwaysDeny":{"type":"boolean"}},"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentToolsApprovalChoices"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentToolsApprovalRequire":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"boolean"}],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentToolsApprovalRequire"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentToolsApproval":{"type":"object","properties":{"choices":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentToolsApprovalChoices"},"requestReason":{"type":"boolean"},"require":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentToolsApprovalRequire"},"timeout":{"type":"number","format":"double"}},"required":["require"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentToolsApproval"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentToolsCodeModeConfig":{"type":"object","properties":{"description":{"type":"string"},"timeoutMs":{"type":"integer","minimum":1000,"maximum":600000},"toolPool":{"type":"array","items":{"type":"string"}}},"required":["toolPool"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentToolsCodeModeConfig"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentToolsIntent":{"type":"string","enum":["mandatory","best-effort"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentToolsIntent"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentToolsPerToolLimits":{"type":"object","properties":{"maxCalls":{"type":"number","format":"double"},"required":{"type":"boolean"}},"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentToolsPerToolLimits"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentToolsSubagentConfigDefaultExecutionMode":{"type":"string","enum":["attached","detached"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentToolsSubagentConfigDefaultExecutionMode"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentToolsSubagentConfigDefaultNotify":{"type":"string","enum":["none","narrate","react"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentToolsSubagentConfigDefaultNotify"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentToolsSubagentConfigExecutionModesItems":{"type":"string","enum":["attached","detached"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentToolsSubagentConfigExecutionModesItems"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentToolsSubagentConfig":{"type":"object","properties":{"allowNesting":{"type":"boolean"},"defaultExecutionMode":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentToolsSubagentConfigDefaultExecutionMode"},"defaultMaxTurns":{"type":"integer","minimum":1,"maximum":100},"defaultModel":{"type":"string"},"defaultNotify":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentToolsSubagentConfigDefaultNotify"},"defaultTimeoutMs":{"type":"integer","minimum":1000,"maximum":600000},"detachedMaxBudgetMs":{"type":"integer","minimum":1000,"maximum":86400000},"detachedNoProgressBudgetMs":{"type":"integer","minimum":1000,"maximum":86400000},"executionModes":{"type":"array","items":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentToolsSubagentConfigExecutionModesItems"}},"maxSpawnsPerRun":{"type":"integer","minimum":1,"maximum":50},"maxTurnsLimit":{"type":"integer","minimum":1,"maximum":100},"toolPool":{"type":"array","items":{"type":"string"}}},"required":["toolPool"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentToolsSubagentConfig"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentToolsToolCallStrategy":{"type":"string","enum":["auto","required","none"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentToolsToolCallStrategy"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentToolsToolSearch":{"type":"object","properties":{"alwaysLoaded":{"type":"array","items":{"type":"string"}},"enabled":{"type":"boolean"},"threshold":{"type":"number","format":"double"}},"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentToolsToolSearch"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentTools":{"type":"object","properties":{"approval":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentToolsApproval"},"codeModeConfig":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentToolsCodeModeConfig"},"intent":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentToolsIntent"},"maxToolCalls":{"type":"number","format":"double"},"mcpServers":{"type":"array","items":{"description":"Any type"}},"perToolLimits":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentToolsPerToolLimits"}},"runtimeTools":{"type":"array","items":{"description":"Any type"}},"subagentConfig":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentToolsSubagentConfig"},"toolCallStrategy":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentToolsToolCallStrategy"},"toolConfigs":{"type":"object","additionalProperties":{"type":"object","additionalProperties":{"description":"Any type"}}},"toolIds":{"type":"array","items":{"type":"string"}},"toolSearch":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentToolsToolSearch"}},"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentTools"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentVoiceDirectTools":{"type":"object","properties":{"enabled":{"type":"boolean"},"model":{"type":"string","minLength":1}},"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentVoiceDirectTools"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentVoiceElevenLabs":{"type":"object","properties":{"modelId":{"type":"string","minLength":1},"similarity":{"type":"number","format":"double","minimum":0,"maximum":1},"stability":{"type":"number","format":"double","minimum":0,"maximum":1},"voiceId":{"type":"string","minLength":1}},"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentVoiceElevenLabs"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentVoiceEndpointingStrategy":{"type":"string","enum":["provider_vad","server_vad","client_commit","manual"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentVoiceEndpointingStrategy"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentVoiceEndpointing":{"type":"object","properties":{"silenceMs":{"type":"integer","minimum":0,"maximum":30000},"strategy":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentVoiceEndpointingStrategy"}},"required":["strategy"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentVoiceEndpointing"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentVoiceInterruptionMode":{"type":"string","enum":["none","cancel","barge-in"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentVoiceInterruptionMode"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentVoiceSpeechMode":{"type":"string","enum":["pipeline","speech_to_speech","provider_managed"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentVoiceSpeechMode"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentVoiceSpeechSynthesizerSettings":{"type":"object","properties":{"similarity":{"type":"number","format":"double","minimum":0,"maximum":1},"stability":{"type":"number","format":"double","minimum":0,"maximum":1}},"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentVoiceSpeechSynthesizerSettings"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentVoiceSpeechSynthesizer":{"type":"object","properties":{"model":{"type":"string","minLength":1},"provider":{"type":"string","minLength":1},"settings":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentVoiceSpeechSynthesizerSettings"},"voiceId":{"type":"string","minLength":1}},"required":["provider"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentVoiceSpeechSynthesizer"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentVoiceSpeechTranscriber":{"type":"object","properties":{"model":{"type":"string","minLength":1},"provider":{"type":"string","minLength":1}},"required":["provider"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentVoiceSpeechTranscriber"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentVoiceSpeech":{"type":"object","properties":{"mode":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentVoiceSpeechMode"},"synthesizer":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentVoiceSpeechSynthesizer"},"transcriber":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentVoiceSpeechTranscriber"}},"required":["mode","synthesizer","transcriber"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentVoiceSpeech"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentVoice":{"type":"object","properties":{"directTools":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentVoiceDirectTools"},"disclosure":{"type":"boolean"},"elevenLabs":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentVoiceElevenLabs"},"enabled":{"type":"boolean"},"endpointing":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentVoiceEndpointing"},"greeting":{"type":"string","maxLength":2000},"interruptionMode":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentVoiceInterruptionMode"},"language":{"type":"string","minLength":1,"maxLength":64},"provider":{"type":"string","minLength":1},"speech":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentVoiceSpeech"}},"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentVoice"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0Agent":{"type":"object","properties":{"advisor":{"oneOf":[{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentAdvisor"},{"type":"null"}]},"agentId":{"type":"string"},"agentType":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentAgentType"},"alias":{"type":"string","minLength":1,"maxLength":63},"artifacts":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentArtifacts"},"busyMessageRouting":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentBusyMessageRouting"},"claudeManagedConfig":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentClaudeManagedConfig"},"durability":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentDurability"},"errorHandling":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentErrorHandling"},"frequencyPenalty":{"type":"number","format":"double","minimum":-2,"maximum":2},"loggingPolicy":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentLoggingPolicy"},"loopConfig":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentLoopConfig"},"maxTokens":{"type":"integer","minimum":1},"memory":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentMemory"},"model":{"type":"string","minLength":1},"name":{"type":"string","minLength":1},"piiRedaction":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentPiiRedaction"},"presencePenalty":{"type":"number","format":"double","minimum":-2,"maximum":2},"reasoning":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentReasoning"},"sandbox":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentSandbox"},"seed":{"type":"integer"},"systemPrompt":{"type":"string"},"temperature":{"type":"number","format":"double","minimum":0,"maximum":2},"temporal":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentTemporal"},"tenancyStrategy":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentTenancyStrategy"},"tools":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentTools"},"topK":{"type":"integer","minimum":1,"maximum":500},"topP":{"type":"number","format":"double","minimum":0,"maximum":1},"versionId":{"type":"string","minLength":1},"voice":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0AgentVoice"}},"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0Agent"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0ClientToolsItemsOneOf0Annotations":{"type":"object","properties":{"consequentialHint":{"type":"boolean"},"debugging":{"type":"boolean"},"destructiveHint":{"type":"boolean"},"idempotentHint":{"type":"boolean"},"openWorldHint":{"type":"boolean"},"readOnlyHint":{"type":"boolean"},"untrustedContentHint":{"type":"boolean"}},"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0ClientToolsItemsOneOf0Annotations"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0ClientToolsItemsOneOf0Origin":{"type":"string","enum":["webmcp","sdk"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0ClientToolsItemsOneOf0Origin"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0ClientToolsItemsOneOf0ParametersSchemaType":{"type":"string","enum":["object"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0ClientToolsItemsOneOf0ParametersSchemaType"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0ClientToolsItemsOneOf0ParametersSchema":{"type":"object","properties":{"type":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0ClientToolsItemsOneOf0ParametersSchemaType"}},"required":["type"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0ClientToolsItemsOneOf0ParametersSchema"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0ClientToolsItems0":{"type":"object","properties":{"annotations":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0ClientToolsItemsOneOf0Annotations"},"description":{"type":"string","minLength":1},"name":{"type":"string","minLength":1},"origin":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0ClientToolsItemsOneOf0Origin"},"pageOrigin":{"type":"string"},"parametersSchema":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0ClientToolsItemsOneOf0ParametersSchema"},"untrustedContentHint":{"type":"boolean"}},"required":["description","name","parametersSchema"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0ClientToolsItems0"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0ClientToolsItemsOneOf1Catalog":{"type":"string","enum":["runtype-mcp"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0ClientToolsItemsOneOf1Catalog"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0ClientToolsItemsOneOf1Origin":{"type":"string","enum":["webmcp"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0ClientToolsItemsOneOf1Origin"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0ClientToolsItems1":{"type":"object","properties":{"catalog":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0ClientToolsItemsOneOf1Catalog"},"name":{"type":"string","minLength":1},"origin":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0ClientToolsItemsOneOf1Origin"}},"required":["catalog","name"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0ClientToolsItems1"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0ClientToolsItems":{"oneOf":[{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0ClientToolsItems0"},{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0ClientToolsItems1"}],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0ClientToolsItems"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0ClientToolsPolicy":{"type":"object","properties":{"allowlist":{"type":"array","items":{"type":"string"}}},"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0ClientToolsPolicy"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0CredentialProxiesItemsInjectionMode":{"type":"string","enum":["bearer_header","api_key_header","query_param","basic_auth"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0CredentialProxiesItemsInjectionMode"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0CredentialProxiesItems":{"type":"object","properties":{"envVarName":{"type":"string"},"hostnamePattern":{"type":"string","minLength":1},"injectionConfig":{"type":"object","additionalProperties":{"description":"Any type"},"default":{}},"injectionMode":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0CredentialProxiesItemsInjectionMode"},"pathPattern":{"type":"string","default":"/*"},"secretKey":{"type":"string","minLength":1}},"required":["hostnamePattern","injectionMode","secretKey"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0CredentialProxiesItems"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0EndUser":{"type":"object","properties":{"email":{"type":"string"},"id":{"type":"string","minLength":1}},"required":["id"],"description":"The end user (the person) the turn runs as. Exposed to tools as _endUser.*, drives memory-profile sharding, and satisfies an end-user-isolated tenancyStrategy. Distinct from _user (the Builder User).","title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0EndUser"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0Flow":{"type":"object","properties":{"agents":{"type":"object","additionalProperties":{"description":"Any type"}},"contentHash":{"type":"string","minLength":64,"maxLength":64},"description":{"type":"string"},"id":{"type":"string","minLength":1},"name":{"type":"string","minLength":1},"steps":{"type":"array","items":{"description":"Any type"}}},"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0Flow"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0History":{"type":"string","enum":["inline","stored"],"description":"Where this turn's prior history comes from. \"inline\" (the default, and today's behavior) replays exactly the `messages` sent here. \"stored\" replays the transcript saved on the `conversationId` conversation, treats `messages` as the new delta, and appends both the delta and the settled assistant turn back onto it; it requires a saved `agent.agentId` and a `conversationId`, and is refused for a flow dispatch, an inline or `claude_managed` agent, `Prefer: respond-async`, a steer (`x-runtype-concurrency: steer`), or a resume.","title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0History"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0IdentityProof":{"type":"object","properties":{"provider":{"type":"string","minLength":1,"maxLength":64},"token":{"type":"string","minLength":1,"maxLength":8192}},"required":["provider","token"],"description":"Customer-native auth proof for the Identity Exchange. When present and the surface has a matching integration, the verified tenant/end-user replace any body-asserted tenant/endUser (which are never trusted for web-embedded callers). A proof that fails verification is rejected with 401 `invalid_identity_proof`.","title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0IdentityProof"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0MessagesItemsContentOneOf1ItemsOneOf0Type":{"type":"string","enum":["text"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0MessagesItemsContentOneOf1ItemsOneOf0Type"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0MessagesItemsContentOneOf1Items0":{"type":"object","properties":{"text":{"type":"string"},"type":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0MessagesItemsContentOneOf1ItemsOneOf0Type"}},"required":["text","type"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0MessagesItemsContentOneOf1Items0"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0MessagesItemsContentOneOf1ItemsOneOf1Type":{"type":"string","enum":["image"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0MessagesItemsContentOneOf1ItemsOneOf1Type"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0MessagesItemsContentOneOf1Items1":{"type":"object","properties":{"image":{"type":"string"},"mimeType":{"type":"string"},"type":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0MessagesItemsContentOneOf1ItemsOneOf1Type"}},"required":["image","type"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0MessagesItemsContentOneOf1Items1"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0MessagesItemsContentOneOf1ItemsOneOf2Type":{"type":"string","enum":["file"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0MessagesItemsContentOneOf1ItemsOneOf2Type"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0MessagesItemsContentOneOf1Items2":{"type":"object","properties":{"data":{"type":"string"},"filename":{"type":"string"},"mimeType":{"type":"string"},"type":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0MessagesItemsContentOneOf1ItemsOneOf2Type"}},"required":["data","filename","mimeType","type"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0MessagesItemsContentOneOf1Items2"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0MessagesItemsContentOneOf1ItemsOneOf3Type":{"type":"string","enum":["reasoning"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0MessagesItemsContentOneOf1ItemsOneOf3Type"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0MessagesItemsContentOneOf1Items3":{"type":"object","properties":{"providerOptions":{"type":"object","additionalProperties":{"description":"Any type"}},"text":{"type":"string"},"type":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0MessagesItemsContentOneOf1ItemsOneOf3Type"}},"required":["text","type"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0MessagesItemsContentOneOf1Items3"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0MessagesItemsContentOneOf1Items":{"oneOf":[{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0MessagesItemsContentOneOf1Items0"},{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0MessagesItemsContentOneOf1Items1"},{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0MessagesItemsContentOneOf1Items2"},{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0MessagesItemsContentOneOf1Items3"}],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0MessagesItemsContentOneOf1Items"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0MessagesItemsContent1":{"type":"array","items":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0MessagesItemsContentOneOf1Items"},"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0MessagesItemsContent1"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0MessagesItemsContent":{"oneOf":[{"type":"string"},{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0MessagesItemsContent1"}],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0MessagesItemsContent"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0MessagesItemsRole":{"type":"string","enum":["system","user","assistant","tool"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0MessagesItemsRole"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0MessagesItemsToolCallsItems":{"type":"object","properties":{"args":{"type":"object","additionalProperties":{"description":"Any type"},"default":{}},"providerOptions":{"type":"object","additionalProperties":{"description":"Any type"}},"toolCallId":{"type":"string","minLength":1},"toolName":{"type":"string","minLength":1}},"required":["toolCallId","toolName"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0MessagesItemsToolCallsItems"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0MessagesItemsToolResultsItems":{"type":"object","properties":{"providerOptions":{"type":"object","additionalProperties":{"description":"Any type"}},"result":{"description":"Whatever the tool returned."},"toolCallId":{"type":"string","minLength":1,"description":"Must answer a toolCalls entry issued earlier."},"toolName":{"type":"string","minLength":1}},"required":["toolCallId","toolName"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0MessagesItemsToolResultsItems"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0MessagesItems":{"type":"object","properties":{"content":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0MessagesItemsContent"},"role":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0MessagesItemsRole"},"toolCalls":{"type":"array","items":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0MessagesItemsToolCallsItems"},"description":"Assistant messages only. Every entry must be answered by the next tool message."},"toolResults":{"type":"array","items":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0MessagesItemsToolResultsItems"},"description":"Tool messages only, and required on them."}},"required":["content","role"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0MessagesItems"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0OptionsEnvironment":{"type":"string","enum":["development","production"],"default":"development","title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0OptionsEnvironment"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0OptionsFlowMode":{"type":"string","enum":["existing","create","virtual","upsert"],"default":"existing","title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0OptionsFlowMode"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0OptionsLocalInferenceBackend":{"type":"string","enum":["ollama"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0OptionsLocalInferenceBackend"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0OptionsLocalInferenceSurface":{"type":"string","enum":["playground","flows","agents"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0OptionsLocalInferenceSurface"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0OptionsLocalInference":{"type":"object","properties":{"backend":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0OptionsLocalInferenceBackend"},"capabilityRevision":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"model":{"type":"string","minLength":1,"maxLength":256},"sessionId":{"type":"string","format":"uuid"},"surface":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0OptionsLocalInferenceSurface"}},"required":["backend","model","sessionId"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0OptionsLocalInference"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0OptionsLoggingPolicy":{"type":"string","enum":["default","on","off"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0OptionsLoggingPolicy"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0OptionsRecordMode":{"type":"string","enum":["existing","create","virtual"],"default":"existing","title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0OptionsRecordMode"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0OptionsResumeFrom":{"type":"object","properties":{"executionId":{"type":"string","minLength":1,"maxLength":128},"iteration":{"type":"integer","minimum":0}},"required":["executionId"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0OptionsResumeFrom"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0OptionsUpsertOptions":{"type":"object","properties":{"allowOverwriteExternalChanges":{"type":"boolean","default":false},"createVersionOnChange":{"type":"boolean","default":true}},"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0OptionsUpsertOptions"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0OptionsVersionType":{"type":"string","enum":["published","draft","test","virtual"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0OptionsVersionType"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0Options":{"type":"object","properties":{"autoAppendMetadata":{"type":"boolean","default":false},"cache":{"type":"boolean","description":"Set false to disable prompt caching for this request (no cache markers, no cache routing keys). Use for workloads where deterministic byte-identical requests must never share provider cache state, or to A/B against cached behavior. Default: caching follows the account rollout."},"clientToolOutputs":{"type":"object","additionalProperties":{"description":"Any type"}},"createVersion":{"type":"boolean","default":false},"debugMode":{"type":"boolean","default":false},"environment":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0OptionsEnvironment","default":"development"},"flowMode":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0OptionsFlowMode","default":"existing"},"flowTimeoutMs":{"type":"integer","minimum":1000,"maximum":1800000,"description":"Continuous Flow timeout. Values above 900000 ms require a Flow request detached with Prefer: respond-async; the asynchronous maximum is 1800000 ms."},"flowVersionId":{"type":"string"},"localInference":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0OptionsLocalInference"},"loggingPolicy":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0OptionsLoggingPolicy"},"modelOverride":{"type":"string"},"recordMode":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0OptionsRecordMode","default":"existing"},"resumeFrom":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0OptionsResumeFrom"},"stepTimeoutMs":{"type":"integer","minimum":1000,"maximum":1800000,"description":"Per-step timeout. Values above 600000 ms require a Flow request detached with Prefer: respond-async; the asynchronous maximum is 1800000 ms."},"storeResults":{"type":"boolean","default":true},"streamResponse":{"type":"boolean","default":true},"upsertOptions":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0OptionsUpsertOptions"},"useRuntimePackage":{"type":"boolean","description":"Execution-lane selector. `false` is RETIRED on AGENT dispatches: the legacy agent engine it selected has been deleted, so it is rejected with 400 LEGACY_AGENT_LANE_RETIRED (still carrying the RFC 9745 `Deprecation` + `X-API-Deprecation-Warning` response headers). Omitted and `true` are now IDENTICAL for agents: both run an eligible agent on the @runtypelabs/runtime lane, and both answer a definition the lane cannot execute faithfully with 400 RUNTIME_AGENT_PARITY_FOLD_UNSUPPORTED rather than degrading it. For FLOW dispatches the field is accepted but ignored: eligible flows always use the runtime lane, while ineligible flows still fold to legacy silently."},"versionLabel":{"type":"string"},"versionNotes":{"type":"string"},"versionType":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0OptionsVersionType"}},"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0Options"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0Record":{"type":"object","properties":{"id":{"type":"string","minLength":1},"metadata":{"type":"object","additionalProperties":{"description":"Any type"}},"name":{"type":"string","minLength":1},"ownerId":{"type":"string","minLength":1},"type":{"type":"string","minLength":1}},"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0Record"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0Tenant":{"type":"object","properties":{"id":{"type":"string","minLength":1}},"required":["id"],"description":"The product tenant (a customer of your product, under your Builder Org) the turn runs within. Exposed to tools as _tenant.*.","title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0Tenant"},"DispatchExecuteAFlowOrAgentRequest0":{"type":"object","properties":{"agent":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0Agent"},"clientTools":{"type":"array","items":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0ClientToolsItems"}},"clientToolsPolicy":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0ClientToolsPolicy"},"conversationId":{"type":"string","minLength":1},"credentialProxies":{"type":"array","items":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0CredentialProxiesItems"}},"endUser":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0EndUser","description":"The end user (the person) the turn runs as. Exposed to tools as _endUser.*, drives memory-profile sharding, and satisfies an end-user-isolated tenancyStrategy. Distinct from _user (the Builder User)."},"flow":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0Flow"},"history":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0History","description":"Where this turn's prior history comes from. \"inline\" (the default, and today's behavior) replays exactly the `messages` sent here. \"stored\" replays the transcript saved on the `conversationId` conversation, treats `messages` as the new delta, and appends both the delta and the settled assistant turn back onto it; it requires a saved `agent.agentId` and a `conversationId`, and is refused for a flow dispatch, an inline or `claude_managed` agent, `Prefer: respond-async`, a steer (`x-runtype-concurrency: steer`), or a resume."},"identityProof":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0IdentityProof","description":"Customer-native auth proof for the Identity Exchange. When present and the surface has a matching integration, the verified tenant/end-user replace any body-asserted tenant/endUser (which are never trusted for web-embedded callers). A proof that fails verification is rejected with 401 `invalid_identity_proof`."},"inputs":{"type":"object","additionalProperties":{"description":"Any type"}},"messages":{"type":"array","items":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0MessagesItems"},"description":"Conversation history for this turn, or with `history: \"stored\"` only the new delta. A `system` message that is not the first message keeps its position on OpenAI-family models (so a per-turn system message sent last leaves the cached leading prompt untouched) and is folded into the leading system prompt on providers that require a single leading system turn. A `tool` message must carry `toolResults` answering an assistant `toolCalls` entry issued earlier in the array."},"options":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0Options","default":{"autoAppendMetadata":false,"createVersion":false,"debugMode":false,"environment":"development","flowMode":"existing","recordMode":"existing","storeResults":true,"streamResponse":true}},"record":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0Record"},"secrets":{"type":"object","additionalProperties":{"type":"string"},"description":"Retired on BOTH dispatch targets. A NON-EMPTY map is rejected with 400: RUNTIME_AGENT_TRANSIENT_SECRETS_UNSUPPORTED on an agent dispatch, RUNTIME_FLOW_TRANSIENT_SECRETS_UNSUPPORTED on a flow dispatch (the flow target used to drop the map silently). An empty map is accepted and does nothing. Store credentials as managed secrets and reference them as {{secret:NAME}}. The field is kept on the wire for compatibility only."},"tenant":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf0Tenant","description":"The product tenant (a customer of your product, under your Builder Org) the turn runs within. Exposed to tools as _tenant.*."}},"required":["flow"],"title":"DispatchExecuteAFlowOrAgentRequest0"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentAdvisor":{"type":"object","properties":{"model":{"type":"string"},"systemPrompt":{"type":"string"}},"required":["model"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentAdvisor"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentAgentType":{"type":"string","enum":["runtype","claude_managed"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentAgentType"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentArtifactsTypesItems":{"type":"string","enum":["markdown","component"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentArtifactsTypesItems"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentArtifacts":{"type":"object","properties":{"enabled":{"type":"boolean"},"types":{"type":"array","items":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentArtifactsTypesItems"}}},"required":["enabled","types"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentArtifacts"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentBusyMessageRoutingMode":{"type":"string","enum":["enforced","off"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentBusyMessageRoutingMode"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentBusyMessageRouting":{"type":"object","properties":{"classifierModel":{"type":"string","minLength":1,"maxLength":200},"mode":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentBusyMessageRoutingMode"}},"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentBusyMessageRouting"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentClaudeManagedConfigSetupMode":{"type":"string","enum":["create","connect"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentClaudeManagedConfigSetupMode"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentClaudeManagedConfig":{"type":"object","properties":{"anthropicAgentId":{"type":"string"},"anthropicAgentVersion":{"type":"integer"},"anthropicEnvironmentId":{"type":"string"},"autoDelete":{"type":"boolean"},"model":{"type":"string"},"setupMode":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentClaudeManagedConfigSetupMode"},"systemPrompt":{"type":"string"}},"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentClaudeManagedConfig"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentDurabilityForced":{"type":"string","enum":["durable","in_process"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentDurabilityForced"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentDurability":{"type":"object","properties":{"forced":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentDurabilityForced"},"maxBudgetMs":{"type":["integer","null"],"minimum":1000,"maximum":86400000},"watchLeaseMs":{"type":["integer","null"],"minimum":10000,"maximum":1800000}},"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentDurability"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentErrorHandlingFallbacksItemsOneOf0Type":{"type":"string","enum":["retry"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentErrorHandlingFallbacksItemsOneOf0Type"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentErrorHandlingFallbacksItems0":{"type":"object","properties":{"delay":{"type":"integer","minimum":0,"maximum":60000},"type":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentErrorHandlingFallbacksItemsOneOf0Type"}},"required":["type"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentErrorHandlingFallbacksItems0"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentErrorHandlingFallbacksItemsOneOf1Type":{"type":"string","enum":["model"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentErrorHandlingFallbacksItemsOneOf1Type"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentErrorHandlingFallbacksItems1":{"type":"object","properties":{"delay":{"type":"integer","minimum":0,"maximum":60000},"maxTokens":{"type":"integer","minimum":1},"model":{"type":"string"},"temperature":{"type":"number","format":"double","minimum":0,"maximum":2},"type":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentErrorHandlingFallbacksItemsOneOf1Type"}},"required":["model","type"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentErrorHandlingFallbacksItems1"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentErrorHandlingFallbacksItemsOneOf2Type":{"type":"string","enum":["message"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentErrorHandlingFallbacksItemsOneOf2Type"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentErrorHandlingFallbacksItems2":{"type":"object","properties":{"delay":{"type":"integer","minimum":0,"maximum":60000},"message":{"type":"string"},"type":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentErrorHandlingFallbacksItemsOneOf2Type"}},"required":["message","type"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentErrorHandlingFallbacksItems2"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentErrorHandlingFallbacksItems":{"oneOf":[{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentErrorHandlingFallbacksItems0"},{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentErrorHandlingFallbacksItems1"},{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentErrorHandlingFallbacksItems2"}],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentErrorHandlingFallbacksItems"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentErrorHandlingOnError":{"type":"string","enum":["fail","continue","fallback"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentErrorHandlingOnError"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentErrorHandlingTriggersItemsType":{"type":"string","enum":["error","empty-output"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentErrorHandlingTriggersItemsType"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentErrorHandlingTriggersItems":{"type":"object","properties":{"type":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentErrorHandlingTriggersItemsType"}},"required":["type"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentErrorHandlingTriggersItems"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentErrorHandling":{"type":"object","properties":{"fallbacks":{"type":"array","items":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentErrorHandlingFallbacksItems"}},"onError":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentErrorHandlingOnError"},"triggers":{"type":"array","items":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentErrorHandlingTriggersItems"}}},"required":["onError"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentErrorHandling"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentLoggingPolicy":{"type":"string","enum":["default","on","off"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentLoggingPolicy"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentLoopConfig":{"type":"object","properties":{"enableReflection":{"type":"boolean"},"maxCost":{"type":"number","format":"double","minimum":0},"maxTurns":{"type":"integer","minimum":1,"maximum":100},"reflectionInterval":{"type":"integer","minimum":1,"maximum":50},"treatLengthCutoffAsFailure":{"type":"boolean"}},"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentLoopConfig"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentMemoryPointerScope":{"type":"string","enum":["shared","alias","version"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentMemoryPointerScope"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentMemory":{"type":"object","properties":{"enabled":{"type":"boolean"},"injectSummary":{"type":"boolean"},"pointerScope":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentMemoryPointerScope"},"profileTemplate":{"type":"string"}},"required":["enabled"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentMemory"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentPiiRedaction":{"type":"string","enum":["default","off","redact"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentPiiRedaction"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentReasoningOneOf1ReasoningEffort":{"type":"string","enum":["minimal","low","medium","high","xhigh","max"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentReasoningOneOf1ReasoningEffort"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentReasoningOneOf1ReasoningSummary":{"type":"string","enum":["auto","detailed"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentReasoningOneOf1ReasoningSummary"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentReasoning1":{"type":"object","properties":{"budgetTokens":{"type":"integer","minimum":1000,"maximum":100000},"effort":{"type":"string","minLength":1,"maxLength":32},"enabled":{"type":"boolean"},"includeThoughts":{"type":"boolean"},"reasoningEffort":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentReasoningOneOf1ReasoningEffort"},"reasoningSummary":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentReasoningOneOf1ReasoningSummary"},"thinkingBudget":{"type":"integer","minimum":1024,"maximum":65536},"thinkingLevel":{"type":"string","minLength":1,"maxLength":32}},"required":["enabled"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentReasoning1"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentReasoning":{"oneOf":[{"type":"boolean"},{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentReasoning1"}],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentReasoning"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentSandboxCodingAgentsItems":{"type":"string","enum":["opencode"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentSandboxCodingAgentsItems"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentSandboxInstanceType":{"type":"string","enum":["standard-1","standard-2","standard-3","standard-4"],"description":"Only standard-4 is supported on the hosted Agent Sandbox path; other sizes cannot be enabled.","title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentSandboxInstanceType"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentSandboxNetworkAccess0":{"type":"string","enum":["none","essentials","open"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentSandboxNetworkAccess0"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentSandboxNetworkAccessOneOf1Profile":{"type":"string","enum":["none","essentials","open"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentSandboxNetworkAccessOneOf1Profile"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentSandboxNetworkAccess1":{"type":"object","properties":{"allow":{"type":"array","items":{"type":"string"}},"profile":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentSandboxNetworkAccessOneOf1Profile"}},"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentSandboxNetworkAccess1"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentSandboxNetworkAccess":{"oneOf":[{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentSandboxNetworkAccess0"},{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentSandboxNetworkAccess1"}],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentSandboxNetworkAccess"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentSandboxPersistence":{"type":"string","enum":["ephemeral","conversation","named"],"description":"Supported: ephemeral or conversation. Named remains parseable for stored configs but cannot be enabled.","title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentSandboxPersistence"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentSandboxProvider":{"type":"string","enum":["runtype-sandbox","daytona"],"description":"Only runtype-sandbox is currently supported. Daytona is retained for stored-config parsing but rejected at authoring/execution.","title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentSandboxProvider"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentSandboxSleepAfter":{"type":"string","enum":["5m","15m","30m","1h"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentSandboxSleepAfter"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentSandboxTtl":{"type":"string","enum":["5m","1h","24h","unlimited"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentSandboxTtl"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentSandbox":{"type":"object","properties":{"codingAgents":{"type":"array","items":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentSandboxCodingAgentsItems"},"description":"Coding agents the Sandbox can run as typed sessions. Non-empty adds the agent_session_* tools; empty or absent adds none."},"enabled":{"type":"boolean"},"instanceType":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentSandboxInstanceType","description":"Only standard-4 is supported on the hosted Agent Sandbox path; other sizes cannot be enabled."},"networkAccess":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentSandboxNetworkAccess"},"persistence":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentSandboxPersistence","description":"Supported: ephemeral or conversation. Named remains parseable for stored configs but cannot be enabled."},"provider":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentSandboxProvider","description":"Only runtype-sandbox is currently supported. Daytona is retained for stored-config parsing but rejected at authoring/execution."},"secretEnv":{"type":"object","additionalProperties":{"type":"string","minLength":1}},"setupCommands":{"type":"array","items":{"type":"string","minLength":1}},"sleepAfter":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentSandboxSleepAfter"},"ttl":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentSandboxTtl"}},"required":["enabled"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentSandbox"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentTemporal":{"type":"object","properties":{"elapsedThresholdSeconds":{"type":"integer","minimum":0},"groundNow":{"type":"boolean"},"injectElapsed":{"type":"boolean"},"timezone":{"type":"string"}},"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentTemporal"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentTenancyStrategyAssuranceFloorEndUser":{"type":"string","enum":["asserted","verified"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentTenancyStrategyAssuranceFloorEndUser"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentTenancyStrategyAssuranceFloorTenant":{"type":"string","enum":["asserted","verified"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentTenancyStrategyAssuranceFloorTenant"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentTenancyStrategyAssuranceFloor":{"type":"object","properties":{"endUser":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentTenancyStrategyAssuranceFloorEndUser"},"tenant":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentTenancyStrategyAssuranceFloorTenant"}},"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentTenancyStrategyAssuranceFloor"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentTenancyStrategyPreset":{"type":"string","enum":["internal","tenant-isolated","end-user-isolated"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentTenancyStrategyPreset"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentTenancyStrategy":{"type":"object","properties":{"assuranceFloor":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentTenancyStrategyAssuranceFloor"},"preset":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentTenancyStrategyPreset"}},"required":["preset"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentTenancyStrategy"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentToolsApprovalChoices":{"type":"object","properties":{"alwaysAllow":{"type":"boolean"},"alwaysDeny":{"type":"boolean"}},"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentToolsApprovalChoices"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentToolsApprovalRequire":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"boolean"}],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentToolsApprovalRequire"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentToolsApproval":{"type":"object","properties":{"choices":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentToolsApprovalChoices"},"requestReason":{"type":"boolean"},"require":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentToolsApprovalRequire"},"timeout":{"type":"number","format":"double"}},"required":["require"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentToolsApproval"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentToolsCodeModeConfig":{"type":"object","properties":{"description":{"type":"string"},"timeoutMs":{"type":"integer","minimum":1000,"maximum":600000},"toolPool":{"type":"array","items":{"type":"string"}}},"required":["toolPool"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentToolsCodeModeConfig"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentToolsIntent":{"type":"string","enum":["mandatory","best-effort"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentToolsIntent"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentToolsPerToolLimits":{"type":"object","properties":{"maxCalls":{"type":"number","format":"double"},"required":{"type":"boolean"}},"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentToolsPerToolLimits"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentToolsSubagentConfigDefaultExecutionMode":{"type":"string","enum":["attached","detached"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentToolsSubagentConfigDefaultExecutionMode"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentToolsSubagentConfigDefaultNotify":{"type":"string","enum":["none","narrate","react"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentToolsSubagentConfigDefaultNotify"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentToolsSubagentConfigExecutionModesItems":{"type":"string","enum":["attached","detached"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentToolsSubagentConfigExecutionModesItems"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentToolsSubagentConfig":{"type":"object","properties":{"allowNesting":{"type":"boolean"},"defaultExecutionMode":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentToolsSubagentConfigDefaultExecutionMode"},"defaultMaxTurns":{"type":"integer","minimum":1,"maximum":100},"defaultModel":{"type":"string"},"defaultNotify":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentToolsSubagentConfigDefaultNotify"},"defaultTimeoutMs":{"type":"integer","minimum":1000,"maximum":600000},"detachedMaxBudgetMs":{"type":"integer","minimum":1000,"maximum":86400000},"detachedNoProgressBudgetMs":{"type":"integer","minimum":1000,"maximum":86400000},"executionModes":{"type":"array","items":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentToolsSubagentConfigExecutionModesItems"}},"maxSpawnsPerRun":{"type":"integer","minimum":1,"maximum":50},"maxTurnsLimit":{"type":"integer","minimum":1,"maximum":100},"toolPool":{"type":"array","items":{"type":"string"}}},"required":["toolPool"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentToolsSubagentConfig"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentToolsToolCallStrategy":{"type":"string","enum":["auto","required","none"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentToolsToolCallStrategy"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentToolsToolSearch":{"type":"object","properties":{"alwaysLoaded":{"type":"array","items":{"type":"string"}},"enabled":{"type":"boolean"},"threshold":{"type":"number","format":"double"}},"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentToolsToolSearch"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentTools":{"type":"object","properties":{"approval":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentToolsApproval"},"codeModeConfig":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentToolsCodeModeConfig"},"intent":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentToolsIntent"},"maxToolCalls":{"type":"number","format":"double"},"mcpServers":{"type":"array","items":{"description":"Any type"}},"perToolLimits":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentToolsPerToolLimits"}},"runtimeTools":{"type":"array","items":{"description":"Any type"}},"subagentConfig":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentToolsSubagentConfig"},"toolCallStrategy":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentToolsToolCallStrategy"},"toolConfigs":{"type":"object","additionalProperties":{"type":"object","additionalProperties":{"description":"Any type"}}},"toolIds":{"type":"array","items":{"type":"string"}},"toolSearch":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentToolsToolSearch"}},"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentTools"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentVoiceDirectTools":{"type":"object","properties":{"enabled":{"type":"boolean"},"model":{"type":"string","minLength":1}},"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentVoiceDirectTools"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentVoiceElevenLabs":{"type":"object","properties":{"modelId":{"type":"string","minLength":1},"similarity":{"type":"number","format":"double","minimum":0,"maximum":1},"stability":{"type":"number","format":"double","minimum":0,"maximum":1},"voiceId":{"type":"string","minLength":1}},"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentVoiceElevenLabs"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentVoiceEndpointingStrategy":{"type":"string","enum":["provider_vad","server_vad","client_commit","manual"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentVoiceEndpointingStrategy"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentVoiceEndpointing":{"type":"object","properties":{"silenceMs":{"type":"integer","minimum":0,"maximum":30000},"strategy":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentVoiceEndpointingStrategy"}},"required":["strategy"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentVoiceEndpointing"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentVoiceInterruptionMode":{"type":"string","enum":["none","cancel","barge-in"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentVoiceInterruptionMode"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentVoiceSpeechMode":{"type":"string","enum":["pipeline","speech_to_speech","provider_managed"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentVoiceSpeechMode"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentVoiceSpeechSynthesizerSettings":{"type":"object","properties":{"similarity":{"type":"number","format":"double","minimum":0,"maximum":1},"stability":{"type":"number","format":"double","minimum":0,"maximum":1}},"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentVoiceSpeechSynthesizerSettings"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentVoiceSpeechSynthesizer":{"type":"object","properties":{"model":{"type":"string","minLength":1},"provider":{"type":"string","minLength":1},"settings":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentVoiceSpeechSynthesizerSettings"},"voiceId":{"type":"string","minLength":1}},"required":["provider"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentVoiceSpeechSynthesizer"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentVoiceSpeechTranscriber":{"type":"object","properties":{"model":{"type":"string","minLength":1},"provider":{"type":"string","minLength":1}},"required":["provider"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentVoiceSpeechTranscriber"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentVoiceSpeech":{"type":"object","properties":{"mode":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentVoiceSpeechMode"},"synthesizer":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentVoiceSpeechSynthesizer"},"transcriber":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentVoiceSpeechTranscriber"}},"required":["mode","synthesizer","transcriber"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentVoiceSpeech"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentVoice":{"type":"object","properties":{"directTools":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentVoiceDirectTools"},"disclosure":{"type":"boolean"},"elevenLabs":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentVoiceElevenLabs"},"enabled":{"type":"boolean"},"endpointing":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentVoiceEndpointing"},"greeting":{"type":"string","maxLength":2000},"interruptionMode":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentVoiceInterruptionMode"},"language":{"type":"string","minLength":1,"maxLength":64},"provider":{"type":"string","minLength":1},"speech":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentVoiceSpeech"}},"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentVoice"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1Agent":{"type":"object","properties":{"advisor":{"oneOf":[{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentAdvisor"},{"type":"null"}]},"agentId":{"type":"string"},"agentType":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentAgentType"},"alias":{"type":"string","minLength":1,"maxLength":63},"artifacts":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentArtifacts"},"busyMessageRouting":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentBusyMessageRouting"},"claudeManagedConfig":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentClaudeManagedConfig"},"durability":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentDurability"},"errorHandling":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentErrorHandling"},"frequencyPenalty":{"type":"number","format":"double","minimum":-2,"maximum":2},"loggingPolicy":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentLoggingPolicy"},"loopConfig":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentLoopConfig"},"maxTokens":{"type":"integer","minimum":1},"memory":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentMemory"},"model":{"type":"string","minLength":1},"name":{"type":"string","minLength":1},"piiRedaction":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentPiiRedaction"},"presencePenalty":{"type":"number","format":"double","minimum":-2,"maximum":2},"reasoning":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentReasoning"},"sandbox":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentSandbox"},"seed":{"type":"integer"},"systemPrompt":{"type":"string"},"temperature":{"type":"number","format":"double","minimum":0,"maximum":2},"temporal":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentTemporal"},"tenancyStrategy":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentTenancyStrategy"},"tools":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentTools"},"topK":{"type":"integer","minimum":1,"maximum":500},"topP":{"type":"number","format":"double","minimum":0,"maximum":1},"versionId":{"type":"string","minLength":1},"voice":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1AgentVoice"}},"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1Agent"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1ClientToolsItemsOneOf0Annotations":{"type":"object","properties":{"consequentialHint":{"type":"boolean"},"debugging":{"type":"boolean"},"destructiveHint":{"type":"boolean"},"idempotentHint":{"type":"boolean"},"openWorldHint":{"type":"boolean"},"readOnlyHint":{"type":"boolean"},"untrustedContentHint":{"type":"boolean"}},"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1ClientToolsItemsOneOf0Annotations"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1ClientToolsItemsOneOf0Origin":{"type":"string","enum":["webmcp","sdk"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1ClientToolsItemsOneOf0Origin"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1ClientToolsItemsOneOf0ParametersSchemaType":{"type":"string","enum":["object"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1ClientToolsItemsOneOf0ParametersSchemaType"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1ClientToolsItemsOneOf0ParametersSchema":{"type":"object","properties":{"type":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1ClientToolsItemsOneOf0ParametersSchemaType"}},"required":["type"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1ClientToolsItemsOneOf0ParametersSchema"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1ClientToolsItems0":{"type":"object","properties":{"annotations":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1ClientToolsItemsOneOf0Annotations"},"description":{"type":"string","minLength":1},"name":{"type":"string","minLength":1},"origin":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1ClientToolsItemsOneOf0Origin"},"pageOrigin":{"type":"string"},"parametersSchema":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1ClientToolsItemsOneOf0ParametersSchema"},"untrustedContentHint":{"type":"boolean"}},"required":["description","name","parametersSchema"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1ClientToolsItems0"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1ClientToolsItemsOneOf1Catalog":{"type":"string","enum":["runtype-mcp"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1ClientToolsItemsOneOf1Catalog"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1ClientToolsItemsOneOf1Origin":{"type":"string","enum":["webmcp"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1ClientToolsItemsOneOf1Origin"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1ClientToolsItems1":{"type":"object","properties":{"catalog":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1ClientToolsItemsOneOf1Catalog"},"name":{"type":"string","minLength":1},"origin":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1ClientToolsItemsOneOf1Origin"}},"required":["catalog","name"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1ClientToolsItems1"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1ClientToolsItems":{"oneOf":[{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1ClientToolsItems0"},{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1ClientToolsItems1"}],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1ClientToolsItems"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1ClientToolsPolicy":{"type":"object","properties":{"allowlist":{"type":"array","items":{"type":"string"}}},"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1ClientToolsPolicy"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1CredentialProxiesItemsInjectionMode":{"type":"string","enum":["bearer_header","api_key_header","query_param","basic_auth"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1CredentialProxiesItemsInjectionMode"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1CredentialProxiesItems":{"type":"object","properties":{"envVarName":{"type":"string"},"hostnamePattern":{"type":"string","minLength":1},"injectionConfig":{"type":"object","additionalProperties":{"description":"Any type"},"default":{}},"injectionMode":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1CredentialProxiesItemsInjectionMode"},"pathPattern":{"type":"string","default":"/*"},"secretKey":{"type":"string","minLength":1}},"required":["hostnamePattern","injectionMode","secretKey"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1CredentialProxiesItems"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1EndUser":{"type":"object","properties":{"email":{"type":"string"},"id":{"type":"string","minLength":1}},"required":["id"],"description":"The end user (the person) the turn runs as. Exposed to tools as _endUser.*, drives memory-profile sharding, and satisfies an end-user-isolated tenancyStrategy. Distinct from _user (the Builder User).","title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1EndUser"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1Flow":{"type":"object","properties":{"agents":{"type":"object","additionalProperties":{"description":"Any type"}},"contentHash":{"type":"string","minLength":64,"maxLength":64},"description":{"type":"string"},"id":{"type":"string","minLength":1},"name":{"type":"string","minLength":1},"steps":{"type":"array","items":{"description":"Any type"}}},"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1Flow"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1History":{"type":"string","enum":["inline","stored"],"description":"Where this turn's prior history comes from. \"inline\" (the default, and today's behavior) replays exactly the `messages` sent here. \"stored\" replays the transcript saved on the `conversationId` conversation, treats `messages` as the new delta, and appends both the delta and the settled assistant turn back onto it; it requires a saved `agent.agentId` and a `conversationId`, and is refused for a flow dispatch, an inline or `claude_managed` agent, `Prefer: respond-async`, a steer (`x-runtype-concurrency: steer`), or a resume.","title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1History"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1IdentityProof":{"type":"object","properties":{"provider":{"type":"string","minLength":1,"maxLength":64},"token":{"type":"string","minLength":1,"maxLength":8192}},"required":["provider","token"],"description":"Customer-native auth proof for the Identity Exchange. When present and the surface has a matching integration, the verified tenant/end-user replace any body-asserted tenant/endUser (which are never trusted for web-embedded callers). A proof that fails verification is rejected with 401 `invalid_identity_proof`.","title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1IdentityProof"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1MessagesItemsContentOneOf1ItemsOneOf0Type":{"type":"string","enum":["text"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1MessagesItemsContentOneOf1ItemsOneOf0Type"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1MessagesItemsContentOneOf1Items0":{"type":"object","properties":{"text":{"type":"string"},"type":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1MessagesItemsContentOneOf1ItemsOneOf0Type"}},"required":["text","type"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1MessagesItemsContentOneOf1Items0"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1MessagesItemsContentOneOf1ItemsOneOf1Type":{"type":"string","enum":["image"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1MessagesItemsContentOneOf1ItemsOneOf1Type"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1MessagesItemsContentOneOf1Items1":{"type":"object","properties":{"image":{"type":"string"},"mimeType":{"type":"string"},"type":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1MessagesItemsContentOneOf1ItemsOneOf1Type"}},"required":["image","type"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1MessagesItemsContentOneOf1Items1"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1MessagesItemsContentOneOf1ItemsOneOf2Type":{"type":"string","enum":["file"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1MessagesItemsContentOneOf1ItemsOneOf2Type"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1MessagesItemsContentOneOf1Items2":{"type":"object","properties":{"data":{"type":"string"},"filename":{"type":"string"},"mimeType":{"type":"string"},"type":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1MessagesItemsContentOneOf1ItemsOneOf2Type"}},"required":["data","filename","mimeType","type"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1MessagesItemsContentOneOf1Items2"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1MessagesItemsContentOneOf1ItemsOneOf3Type":{"type":"string","enum":["reasoning"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1MessagesItemsContentOneOf1ItemsOneOf3Type"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1MessagesItemsContentOneOf1Items3":{"type":"object","properties":{"providerOptions":{"type":"object","additionalProperties":{"description":"Any type"}},"text":{"type":"string"},"type":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1MessagesItemsContentOneOf1ItemsOneOf3Type"}},"required":["text","type"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1MessagesItemsContentOneOf1Items3"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1MessagesItemsContentOneOf1Items":{"oneOf":[{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1MessagesItemsContentOneOf1Items0"},{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1MessagesItemsContentOneOf1Items1"},{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1MessagesItemsContentOneOf1Items2"},{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1MessagesItemsContentOneOf1Items3"}],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1MessagesItemsContentOneOf1Items"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1MessagesItemsContent1":{"type":"array","items":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1MessagesItemsContentOneOf1Items"},"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1MessagesItemsContent1"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1MessagesItemsContent":{"oneOf":[{"type":"string"},{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1MessagesItemsContent1"}],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1MessagesItemsContent"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1MessagesItemsRole":{"type":"string","enum":["system","user","assistant","tool"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1MessagesItemsRole"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1MessagesItemsToolCallsItems":{"type":"object","properties":{"args":{"type":"object","additionalProperties":{"description":"Any type"},"default":{}},"providerOptions":{"type":"object","additionalProperties":{"description":"Any type"}},"toolCallId":{"type":"string","minLength":1},"toolName":{"type":"string","minLength":1}},"required":["toolCallId","toolName"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1MessagesItemsToolCallsItems"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1MessagesItemsToolResultsItems":{"type":"object","properties":{"providerOptions":{"type":"object","additionalProperties":{"description":"Any type"}},"result":{"description":"Whatever the tool returned."},"toolCallId":{"type":"string","minLength":1,"description":"Must answer a toolCalls entry issued earlier."},"toolName":{"type":"string","minLength":1}},"required":["toolCallId","toolName"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1MessagesItemsToolResultsItems"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1MessagesItems":{"type":"object","properties":{"content":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1MessagesItemsContent"},"role":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1MessagesItemsRole"},"toolCalls":{"type":"array","items":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1MessagesItemsToolCallsItems"},"description":"Assistant messages only. Every entry must be answered by the next tool message."},"toolResults":{"type":"array","items":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1MessagesItemsToolResultsItems"},"description":"Tool messages only, and required on them."}},"required":["content","role"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1MessagesItems"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1OptionsEnvironment":{"type":"string","enum":["development","production"],"default":"development","title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1OptionsEnvironment"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1OptionsFlowMode":{"type":"string","enum":["existing","create","virtual","upsert"],"default":"existing","title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1OptionsFlowMode"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1OptionsLocalInferenceBackend":{"type":"string","enum":["ollama"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1OptionsLocalInferenceBackend"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1OptionsLocalInferenceSurface":{"type":"string","enum":["playground","flows","agents"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1OptionsLocalInferenceSurface"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1OptionsLocalInference":{"type":"object","properties":{"backend":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1OptionsLocalInferenceBackend"},"capabilityRevision":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"model":{"type":"string","minLength":1,"maxLength":256},"sessionId":{"type":"string","format":"uuid"},"surface":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1OptionsLocalInferenceSurface"}},"required":["backend","model","sessionId"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1OptionsLocalInference"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1OptionsLoggingPolicy":{"type":"string","enum":["default","on","off"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1OptionsLoggingPolicy"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1OptionsRecordMode":{"type":"string","enum":["existing","create","virtual"],"default":"existing","title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1OptionsRecordMode"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1OptionsResumeFrom":{"type":"object","properties":{"executionId":{"type":"string","minLength":1,"maxLength":128},"iteration":{"type":"integer","minimum":0}},"required":["executionId"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1OptionsResumeFrom"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1OptionsUpsertOptions":{"type":"object","properties":{"allowOverwriteExternalChanges":{"type":"boolean","default":false},"createVersionOnChange":{"type":"boolean","default":true}},"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1OptionsUpsertOptions"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1OptionsVersionType":{"type":"string","enum":["published","draft","test","virtual"],"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1OptionsVersionType"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1Options":{"type":"object","properties":{"autoAppendMetadata":{"type":"boolean","default":false},"cache":{"type":"boolean","description":"Set false to disable prompt caching for this request (no cache markers, no cache routing keys). Use for workloads where deterministic byte-identical requests must never share provider cache state, or to A/B against cached behavior. Default: caching follows the account rollout."},"clientToolOutputs":{"type":"object","additionalProperties":{"description":"Any type"}},"createVersion":{"type":"boolean","default":false},"debugMode":{"type":"boolean","default":false},"environment":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1OptionsEnvironment","default":"development"},"flowMode":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1OptionsFlowMode","default":"existing"},"flowTimeoutMs":{"type":"integer","minimum":1000,"maximum":1800000,"description":"Continuous Flow timeout. Values above 900000 ms require a Flow request detached with Prefer: respond-async; the asynchronous maximum is 1800000 ms."},"flowVersionId":{"type":"string"},"localInference":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1OptionsLocalInference"},"loggingPolicy":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1OptionsLoggingPolicy"},"modelOverride":{"type":"string"},"recordMode":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1OptionsRecordMode","default":"existing"},"resumeFrom":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1OptionsResumeFrom"},"stepTimeoutMs":{"type":"integer","minimum":1000,"maximum":1800000,"description":"Per-step timeout. Values above 600000 ms require a Flow request detached with Prefer: respond-async; the asynchronous maximum is 1800000 ms."},"storeResults":{"type":"boolean","default":true},"streamResponse":{"type":"boolean","default":true},"upsertOptions":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1OptionsUpsertOptions"},"useRuntimePackage":{"type":"boolean","description":"Execution-lane selector. `false` is RETIRED on AGENT dispatches: the legacy agent engine it selected has been deleted, so it is rejected with 400 LEGACY_AGENT_LANE_RETIRED (still carrying the RFC 9745 `Deprecation` + `X-API-Deprecation-Warning` response headers). Omitted and `true` are now IDENTICAL for agents: both run an eligible agent on the @runtypelabs/runtime lane, and both answer a definition the lane cannot execute faithfully with 400 RUNTIME_AGENT_PARITY_FOLD_UNSUPPORTED rather than degrading it. For FLOW dispatches the field is accepted but ignored: eligible flows always use the runtime lane, while ineligible flows still fold to legacy silently."},"versionLabel":{"type":"string"},"versionNotes":{"type":"string"},"versionType":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1OptionsVersionType"}},"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1Options"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1Record":{"type":"object","properties":{"id":{"type":"string","minLength":1},"metadata":{"type":"object","additionalProperties":{"description":"Any type"}},"name":{"type":"string","minLength":1},"ownerId":{"type":"string","minLength":1},"type":{"type":"string","minLength":1}},"title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1Record"},"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1Tenant":{"type":"object","properties":{"id":{"type":"string","minLength":1}},"required":["id"],"description":"The product tenant (a customer of your product, under your Builder Org) the turn runs within. Exposed to tools as _tenant.*.","title":"V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1Tenant"},"DispatchExecuteAFlowOrAgentRequest1":{"type":"object","properties":{"agent":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1Agent"},"clientTools":{"type":"array","items":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1ClientToolsItems"}},"clientToolsPolicy":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1ClientToolsPolicy"},"conversationId":{"type":"string","minLength":1},"credentialProxies":{"type":"array","items":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1CredentialProxiesItems"}},"endUser":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1EndUser","description":"The end user (the person) the turn runs as. Exposed to tools as _endUser.*, drives memory-profile sharding, and satisfies an end-user-isolated tenancyStrategy. Distinct from _user (the Builder User)."},"flow":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1Flow"},"history":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1History","description":"Where this turn's prior history comes from. \"inline\" (the default, and today's behavior) replays exactly the `messages` sent here. \"stored\" replays the transcript saved on the `conversationId` conversation, treats `messages` as the new delta, and appends both the delta and the settled assistant turn back onto it; it requires a saved `agent.agentId` and a `conversationId`, and is refused for a flow dispatch, an inline or `claude_managed` agent, `Prefer: respond-async`, a steer (`x-runtype-concurrency: steer`), or a resume."},"identityProof":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1IdentityProof","description":"Customer-native auth proof for the Identity Exchange. When present and the surface has a matching integration, the verified tenant/end-user replace any body-asserted tenant/endUser (which are never trusted for web-embedded callers). A proof that fails verification is rejected with 401 `invalid_identity_proof`."},"inputs":{"type":"object","additionalProperties":{"description":"Any type"}},"messages":{"type":"array","items":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1MessagesItems"},"description":"Conversation history for this turn, or with `history: \"stored\"` only the new delta. A `system` message that is not the first message keeps its position on OpenAI-family models (so a per-turn system message sent last leaves the cached leading prompt untouched) and is folded into the leading system prompt on providers that require a single leading system turn. A `tool` message must carry `toolResults` answering an assistant `toolCalls` entry issued earlier in the array."},"options":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1Options","default":{"autoAppendMetadata":false,"createVersion":false,"debugMode":false,"environment":"development","flowMode":"existing","recordMode":"existing","storeResults":true,"streamResponse":true}},"record":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1Record"},"secrets":{"type":"object","additionalProperties":{"type":"string"},"description":"Retired on BOTH dispatch targets. A NON-EMPTY map is rejected with 400: RUNTIME_AGENT_TRANSIENT_SECRETS_UNSUPPORTED on an agent dispatch, RUNTIME_FLOW_TRANSIENT_SECRETS_UNSUPPORTED on a flow dispatch (the flow target used to drop the map silently). An empty map is accepted and does nothing. Store credentials as managed secrets and reference them as {{secret:NAME}}. The field is kept on the wire for compatibility only."},"tenant":{"$ref":"#/components/schemas/V1DispatchPostRequestBodyContentApplicationJsonSchemaOneOf1Tenant","description":"The product tenant (a customer of your product, under your Builder Org) the turn runs within. Exposed to tools as _tenant.*."}},"required":["agent"],"title":"DispatchExecuteAFlowOrAgentRequest1"},"Dispatch_executeAFlowOrAgent_Request":{"oneOf":[{"$ref":"#/components/schemas/DispatchExecuteAFlowOrAgentRequest0"},{"$ref":"#/components/schemas/DispatchExecuteAFlowOrAgentRequest1"}],"title":"Dispatch_executeAFlowOrAgent_Request"},"ExecuteAFlowOrAgentRequestInternalServerError":{"oneOf":[{"$ref":"#/components/schemas/InternalError"},{"$ref":"#/components/schemas/ExecutionFailedError"}],"title":"ExecuteAFlowOrAgentRequestInternalServerError"},"V1DispatchApprovePostRequestBodyContentApplicationJsonSchemaDecision":{"type":"string","enum":["approved","denied"],"title":"V1DispatchApprovePostRequestBodyContentApplicationJsonSchemaDecision"},"DispatchApprovalContinuationJsonResponseDecision":{"type":"string","enum":["approved","denied"],"title":"DispatchApprovalContinuationJsonResponseDecision"},"DispatchApprovalContinuationJsonResponseStatus":{"type":"string","enum":["completed","paused","failed"],"title":"DispatchApprovalContinuationJsonResponseStatus"},"DispatchApprovalContinuationJsonResponse":{"type":"object","properties":{"blockReason":{"type":"string"},"code":{"type":"string"},"decision":{"$ref":"#/components/schemas/DispatchApprovalContinuationJsonResponseDecision"},"error":{"type":"string"},"executionId":{"type":"string"},"pausedReason":{"$ref":"#/components/schemas/DispatchPausedReason"},"status":{"$ref":"#/components/schemas/DispatchApprovalContinuationJsonResponseStatus"},"success":{"type":"boolean"},"upgradeUrl":{"type":"string"}},"required":["decision","executionId","status","success"],"title":"DispatchApprovalContinuationJsonResponse"},"DispatchDetachedApprovalJsonResponseStatus":{"type":"string","enum":["running"],"title":"DispatchDetachedApprovalJsonResponseStatus"},"DispatchDetachedApprovalJsonResponse":{"type":"object","properties":{"approvalId":{"type":"string"},"executionId":{"type":"string"},"status":{"$ref":"#/components/schemas/DispatchDetachedApprovalJsonResponseStatus"}},"required":["approvalId","executionId","status"],"title":"DispatchDetachedApprovalJsonResponse"},"DispatchApproveJsonResponse":{"oneOf":[{"$ref":"#/components/schemas/DispatchApprovalContinuationJsonResponse"},{"$ref":"#/components/schemas/DispatchDetachedApprovalJsonResponse"}],"title":"DispatchApproveJsonResponse"},"V1DispatchContinuePostRequestBodyContentApplicationJsonSchemaContinuationOneOf0MessagesItemsContentOneOf1ItemsOneOf0Type":{"type":"string","enum":["text"],"title":"V1DispatchContinuePostRequestBodyContentApplicationJsonSchemaContinuationOneOf0MessagesItemsContentOneOf1ItemsOneOf0Type"},"V1DispatchContinuePostRequestBodyContentApplicationJsonSchemaContinuationOneOf0MessagesItemsContentOneOf1Items0":{"type":"object","properties":{"text":{"type":"string"},"type":{"$ref":"#/components/schemas/V1DispatchContinuePostRequestBodyContentApplicationJsonSchemaContinuationOneOf0MessagesItemsContentOneOf1ItemsOneOf0Type"}},"required":["text","type"],"title":"V1DispatchContinuePostRequestBodyContentApplicationJsonSchemaContinuationOneOf0MessagesItemsContentOneOf1Items0"},"V1DispatchContinuePostRequestBodyContentApplicationJsonSchemaContinuationOneOf0MessagesItemsContentOneOf1ItemsOneOf1Type":{"type":"string","enum":["image"],"title":"V1DispatchContinuePostRequestBodyContentApplicationJsonSchemaContinuationOneOf0MessagesItemsContentOneOf1ItemsOneOf1Type"},"V1DispatchContinuePostRequestBodyContentApplicationJsonSchemaContinuationOneOf0MessagesItemsContentOneOf1Items1":{"type":"object","properties":{"image":{"type":"string"},"mimeType":{"type":"string"},"type":{"$ref":"#/components/schemas/V1DispatchContinuePostRequestBodyContentApplicationJsonSchemaContinuationOneOf0MessagesItemsContentOneOf1ItemsOneOf1Type"}},"required":["image","type"],"title":"V1DispatchContinuePostRequestBodyContentApplicationJsonSchemaContinuationOneOf0MessagesItemsContentOneOf1Items1"},"V1DispatchContinuePostRequestBodyContentApplicationJsonSchemaContinuationOneOf0MessagesItemsContentOneOf1ItemsOneOf2Type":{"type":"string","enum":["file"],"title":"V1DispatchContinuePostRequestBodyContentApplicationJsonSchemaContinuationOneOf0MessagesItemsContentOneOf1ItemsOneOf2Type"},"V1DispatchContinuePostRequestBodyContentApplicationJsonSchemaContinuationOneOf0MessagesItemsContentOneOf1Items2":{"type":"object","properties":{"data":{"type":"string"},"filename":{"type":"string"},"mimeType":{"type":"string"},"type":{"$ref":"#/components/schemas/V1DispatchContinuePostRequestBodyContentApplicationJsonSchemaContinuationOneOf0MessagesItemsContentOneOf1ItemsOneOf2Type"}},"required":["data","filename","mimeType","type"],"title":"V1DispatchContinuePostRequestBodyContentApplicationJsonSchemaContinuationOneOf0MessagesItemsContentOneOf1Items2"},"V1DispatchContinuePostRequestBodyContentApplicationJsonSchemaContinuationOneOf0MessagesItemsContentOneOf1ItemsOneOf3Type":{"type":"string","enum":["reasoning"],"title":"V1DispatchContinuePostRequestBodyContentApplicationJsonSchemaContinuationOneOf0MessagesItemsContentOneOf1ItemsOneOf3Type"},"V1DispatchContinuePostRequestBodyContentApplicationJsonSchemaContinuationOneOf0MessagesItemsContentOneOf1Items3":{"type":"object","properties":{"providerOptions":{"type":"object","additionalProperties":{"description":"Any type"}},"text":{"type":"string"},"type":{"$ref":"#/components/schemas/V1DispatchContinuePostRequestBodyContentApplicationJsonSchemaContinuationOneOf0MessagesItemsContentOneOf1ItemsOneOf3Type"}},"required":["text","type"],"title":"V1DispatchContinuePostRequestBodyContentApplicationJsonSchemaContinuationOneOf0MessagesItemsContentOneOf1Items3"},"V1DispatchContinuePostRequestBodyContentApplicationJsonSchemaContinuationOneOf0MessagesItemsContentOneOf1Items":{"oneOf":[{"$ref":"#/components/schemas/V1DispatchContinuePostRequestBodyContentApplicationJsonSchemaContinuationOneOf0MessagesItemsContentOneOf1Items0"},{"$ref":"#/components/schemas/V1DispatchContinuePostRequestBodyContentApplicationJsonSchemaContinuationOneOf0MessagesItemsContentOneOf1Items1"},{"$ref":"#/components/schemas/V1DispatchContinuePostRequestBodyContentApplicationJsonSchemaContinuationOneOf0MessagesItemsContentOneOf1Items2"},{"$ref":"#/components/schemas/V1DispatchContinuePostRequestBodyContentApplicationJsonSchemaContinuationOneOf0MessagesItemsContentOneOf1Items3"}],"title":"V1DispatchContinuePostRequestBodyContentApplicationJsonSchemaContinuationOneOf0MessagesItemsContentOneOf1Items"},"V1DispatchContinuePostRequestBodyContentApplicationJsonSchemaContinuationOneOf0MessagesItemsContent1":{"type":"array","items":{"$ref":"#/components/schemas/V1DispatchContinuePostRequestBodyContentApplicationJsonSchemaContinuationOneOf0MessagesItemsContentOneOf1Items"},"title":"V1DispatchContinuePostRequestBodyContentApplicationJsonSchemaContinuationOneOf0MessagesItemsContent1"},"V1DispatchContinuePostRequestBodyContentApplicationJsonSchemaContinuationOneOf0MessagesItemsContent":{"oneOf":[{"type":"string"},{"$ref":"#/components/schemas/V1DispatchContinuePostRequestBodyContentApplicationJsonSchemaContinuationOneOf0MessagesItemsContent1"}],"title":"V1DispatchContinuePostRequestBodyContentApplicationJsonSchemaContinuationOneOf0MessagesItemsContent"},"V1DispatchContinuePostRequestBodyContentApplicationJsonSchemaContinuationOneOf0MessagesItemsRole":{"type":"string","enum":["system","user","assistant","tool"],"title":"V1DispatchContinuePostRequestBodyContentApplicationJsonSchemaContinuationOneOf0MessagesItemsRole"},"V1DispatchContinuePostRequestBodyContentApplicationJsonSchemaContinuationOneOf0MessagesItemsToolCallsItems":{"type":"object","properties":{"args":{"type":"object","additionalProperties":{"description":"Any type"},"default":{}},"providerOptions":{"type":"object","additionalProperties":{"description":"Any type"}},"toolCallId":{"type":"string","minLength":1},"toolName":{"type":"string","minLength":1}},"required":["toolCallId","toolName"],"title":"V1DispatchContinuePostRequestBodyContentApplicationJsonSchemaContinuationOneOf0MessagesItemsToolCallsItems"},"V1DispatchContinuePostRequestBodyContentApplicationJsonSchemaContinuationOneOf0MessagesItemsToolResultsItems":{"type":"object","properties":{"providerOptions":{"type":"object","additionalProperties":{"description":"Any type"}},"result":{"description":"Whatever the tool returned."},"toolCallId":{"type":"string","minLength":1,"description":"Must answer a toolCalls entry issued earlier."},"toolName":{"type":"string","minLength":1}},"required":["toolCallId","toolName"],"title":"V1DispatchContinuePostRequestBodyContentApplicationJsonSchemaContinuationOneOf0MessagesItemsToolResultsItems"},"V1DispatchContinuePostRequestBodyContentApplicationJsonSchemaContinuationOneOf0MessagesItems":{"type":"object","properties":{"content":{"$ref":"#/components/schemas/V1DispatchContinuePostRequestBodyContentApplicationJsonSchemaContinuationOneOf0MessagesItemsContent"},"role":{"$ref":"#/components/schemas/V1DispatchContinuePostRequestBodyContentApplicationJsonSchemaContinuationOneOf0MessagesItemsRole"},"toolCalls":{"type":"array","items":{"$ref":"#/components/schemas/V1DispatchContinuePostRequestBodyContentApplicationJsonSchemaContinuationOneOf0MessagesItemsToolCallsItems"},"description":"Assistant messages only. Every entry must be answered by the next tool message."},"toolResults":{"type":"array","items":{"$ref":"#/components/schemas/V1DispatchContinuePostRequestBodyContentApplicationJsonSchemaContinuationOneOf0MessagesItemsToolResultsItems"},"description":"Tool messages only, and required on them."}},"required":["content","role"],"title":"V1DispatchContinuePostRequestBodyContentApplicationJsonSchemaContinuationOneOf0MessagesItems"},"V1DispatchContinuePostRequestBodyContentApplicationJsonSchemaContinuationOneOf0Type":{"type":"string","enum":["tool-output"],"title":"V1DispatchContinuePostRequestBodyContentApplicationJsonSchemaContinuationOneOf0Type"},"V1DispatchContinuePostRequestBodyContentApplicationJsonSchemaContinuation0":{"type":"object","properties":{"messages":{"type":"array","items":{"$ref":"#/components/schemas/V1DispatchContinuePostRequestBodyContentApplicationJsonSchemaContinuationOneOf0MessagesItems"}},"toolOutputs":{"type":"object","additionalProperties":{"description":"Any type"}},"type":{"$ref":"#/components/schemas/V1DispatchContinuePostRequestBodyContentApplicationJsonSchemaContinuationOneOf0Type"}},"required":["type"],"title":"V1DispatchContinuePostRequestBodyContentApplicationJsonSchemaContinuation0"},"V1DispatchContinuePostRequestBodyContentApplicationJsonSchemaContinuationOneOf1Decision":{"type":"string","enum":["approved","denied"],"title":"V1DispatchContinuePostRequestBodyContentApplicationJsonSchemaContinuationOneOf1Decision"},"V1DispatchContinuePostRequestBodyContentApplicationJsonSchemaContinuationOneOf1Type":{"type":"string","enum":["approval"],"title":"V1DispatchContinuePostRequestBodyContentApplicationJsonSchemaContinuationOneOf1Type"},"V1DispatchContinuePostRequestBodyContentApplicationJsonSchemaContinuation1":{"type":"object","properties":{"approvalId":{"type":"string"},"decision":{"$ref":"#/components/schemas/V1DispatchContinuePostRequestBodyContentApplicationJsonSchemaContinuationOneOf1Decision"},"reason":{"type":"string"},"remember":{"type":"boolean"},"type":{"$ref":"#/components/schemas/V1DispatchContinuePostRequestBodyContentApplicationJsonSchemaContinuationOneOf1Type"}},"required":["approvalId","decision","type"],"title":"V1DispatchContinuePostRequestBodyContentApplicationJsonSchemaContinuation1"},"V1DispatchContinuePostRequestBodyContentApplicationJsonSchemaContinuation":{"oneOf":[{"$ref":"#/components/schemas/V1DispatchContinuePostRequestBodyContentApplicationJsonSchemaContinuation0"},{"$ref":"#/components/schemas/V1DispatchContinuePostRequestBodyContentApplicationJsonSchemaContinuation1"}],"title":"V1DispatchContinuePostRequestBodyContentApplicationJsonSchemaContinuation"},"DispatchDetachedToolOutputJsonResponseAgentTargetResolution":{"type":"string","enum":["alias","version","legacy-live-row"],"description":"How the run selected its definition: `alias` or `version` for a request that named a selector, `legacy-live-row` for a run that read the mutable agent row. Matches `GET /v1/executions/{executionId}/status`.","title":"DispatchDetachedToolOutputJsonResponseAgentTargetResolution"},"DispatchDetachedToolOutputJsonResponsePauseKind":{"type":"string","enum":["client_tool","elicitation"],"title":"DispatchDetachedToolOutputJsonResponsePauseKind"},"DispatchDetachedToolOutputJsonResponseStatus":{"type":"string","enum":["running"],"title":"DispatchDetachedToolOutputJsonResponseStatus"},"DispatchDetachedToolOutputJsonResponse":{"type":"object","properties":{"agentTargetResolution":{"$ref":"#/components/schemas/DispatchDetachedToolOutputJsonResponseAgentTargetResolution","description":"How the run selected its definition: `alias` or `version` for a request that named a selector, `legacy-live-row` for a run that read the mutable agent row. Matches `GET /v1/executions/{executionId}/status`."},"agentVersionId":{"type":"string","description":"The agent version recorded for the run. When `agentTargetResolution` is `legacy-live-row`, this is the version the agent row pointed at, and the run read the mutable row rather than that version. Absent when neither exists."},"alias":{"type":"string","description":"The release alias (for example `live`) the version was resolved through, when one was."},"executionId":{"type":"string"},"pauseKind":{"$ref":"#/components/schemas/DispatchDetachedToolOutputJsonResponsePauseKind"},"status":{"$ref":"#/components/schemas/DispatchDetachedToolOutputJsonResponseStatus"}},"required":["executionId","pauseKind","status"],"title":"DispatchDetachedToolOutputJsonResponse"},"DispatchContinuationJsonResponse":{"oneOf":[{"$ref":"#/components/schemas/DispatchToolOutputContinuationJsonResponse"},{"$ref":"#/components/schemas/DispatchApprovalContinuationJsonResponse"},{"$ref":"#/components/schemas/DispatchDetachedApprovalJsonResponse"},{"$ref":"#/components/schemas/DispatchDetachedToolOutputJsonResponse"}],"title":"DispatchContinuationJsonResponse"},"V1DispatchResumePostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1ItemsOneOf0Type":{"type":"string","enum":["text"],"title":"V1DispatchResumePostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1ItemsOneOf0Type"},"V1DispatchResumePostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1Items0":{"type":"object","properties":{"text":{"type":"string"},"type":{"$ref":"#/components/schemas/V1DispatchResumePostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1ItemsOneOf0Type"}},"required":["text","type"],"title":"V1DispatchResumePostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1Items0"},"V1DispatchResumePostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1ItemsOneOf1Type":{"type":"string","enum":["image"],"title":"V1DispatchResumePostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1ItemsOneOf1Type"},"V1DispatchResumePostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1Items1":{"type":"object","properties":{"image":{"type":"string"},"mimeType":{"type":"string"},"type":{"$ref":"#/components/schemas/V1DispatchResumePostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1ItemsOneOf1Type"}},"required":["image","type"],"title":"V1DispatchResumePostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1Items1"},"V1DispatchResumePostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1ItemsOneOf2Type":{"type":"string","enum":["file"],"title":"V1DispatchResumePostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1ItemsOneOf2Type"},"V1DispatchResumePostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1Items2":{"type":"object","properties":{"data":{"type":"string"},"filename":{"type":"string"},"mimeType":{"type":"string"},"type":{"$ref":"#/components/schemas/V1DispatchResumePostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1ItemsOneOf2Type"}},"required":["data","filename","mimeType","type"],"title":"V1DispatchResumePostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1Items2"},"V1DispatchResumePostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1ItemsOneOf3Type":{"type":"string","enum":["reasoning"],"title":"V1DispatchResumePostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1ItemsOneOf3Type"},"V1DispatchResumePostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1Items3":{"type":"object","properties":{"providerOptions":{"type":"object","additionalProperties":{"description":"Any type"}},"text":{"type":"string"},"type":{"$ref":"#/components/schemas/V1DispatchResumePostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1ItemsOneOf3Type"}},"required":["text","type"],"title":"V1DispatchResumePostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1Items3"},"V1DispatchResumePostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1Items":{"oneOf":[{"$ref":"#/components/schemas/V1DispatchResumePostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1Items0"},{"$ref":"#/components/schemas/V1DispatchResumePostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1Items1"},{"$ref":"#/components/schemas/V1DispatchResumePostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1Items2"},{"$ref":"#/components/schemas/V1DispatchResumePostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1Items3"}],"title":"V1DispatchResumePostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1Items"},"V1DispatchResumePostRequestBodyContentApplicationJsonSchemaMessagesItemsContent1":{"type":"array","items":{"$ref":"#/components/schemas/V1DispatchResumePostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1Items"},"title":"V1DispatchResumePostRequestBodyContentApplicationJsonSchemaMessagesItemsContent1"},"V1DispatchResumePostRequestBodyContentApplicationJsonSchemaMessagesItemsContent":{"oneOf":[{"type":"string"},{"$ref":"#/components/schemas/V1DispatchResumePostRequestBodyContentApplicationJsonSchemaMessagesItemsContent1"}],"title":"V1DispatchResumePostRequestBodyContentApplicationJsonSchemaMessagesItemsContent"},"V1DispatchResumePostRequestBodyContentApplicationJsonSchemaMessagesItemsRole":{"type":"string","enum":["system","user","assistant","tool"],"title":"V1DispatchResumePostRequestBodyContentApplicationJsonSchemaMessagesItemsRole"},"V1DispatchResumePostRequestBodyContentApplicationJsonSchemaMessagesItemsToolCallsItems":{"type":"object","properties":{"args":{"type":"object","additionalProperties":{"description":"Any type"},"default":{}},"providerOptions":{"type":"object","additionalProperties":{"description":"Any type"}},"toolCallId":{"type":"string","minLength":1},"toolName":{"type":"string","minLength":1}},"required":["toolCallId","toolName"],"title":"V1DispatchResumePostRequestBodyContentApplicationJsonSchemaMessagesItemsToolCallsItems"},"V1DispatchResumePostRequestBodyContentApplicationJsonSchemaMessagesItemsToolResultsItems":{"type":"object","properties":{"providerOptions":{"type":"object","additionalProperties":{"description":"Any type"}},"result":{"description":"Whatever the tool returned."},"toolCallId":{"type":"string","minLength":1,"description":"Must answer a toolCalls entry issued earlier."},"toolName":{"type":"string","minLength":1}},"required":["toolCallId","toolName"],"title":"V1DispatchResumePostRequestBodyContentApplicationJsonSchemaMessagesItemsToolResultsItems"},"V1DispatchResumePostRequestBodyContentApplicationJsonSchemaMessagesItems":{"type":"object","properties":{"content":{"$ref":"#/components/schemas/V1DispatchResumePostRequestBodyContentApplicationJsonSchemaMessagesItemsContent"},"role":{"$ref":"#/components/schemas/V1DispatchResumePostRequestBodyContentApplicationJsonSchemaMessagesItemsRole"},"toolCalls":{"type":"array","items":{"$ref":"#/components/schemas/V1DispatchResumePostRequestBodyContentApplicationJsonSchemaMessagesItemsToolCallsItems"},"description":"Assistant messages only. Every entry must be answered by the next tool message."},"toolResults":{"type":"array","items":{"$ref":"#/components/schemas/V1DispatchResumePostRequestBodyContentApplicationJsonSchemaMessagesItemsToolResultsItems"},"description":"Tool messages only, and required on them."}},"required":["content","role"],"title":"V1DispatchResumePostRequestBodyContentApplicationJsonSchemaMessagesItems"},"DispatchResumeJsonResponse":{"oneOf":[{"$ref":"#/components/schemas/DispatchToolOutputContinuationJsonResponse"},{"$ref":"#/components/schemas/DispatchDetachedToolOutputJsonResponse"}],"title":"DispatchResumeJsonResponse"},"V1DocsSearchPostResponsesContentApplicationJsonSchemaContentItems":{"type":"object","properties":{"text":{"type":"string"},"type":{"type":"string"}},"required":["type"],"title":"V1DocsSearchPostResponsesContentApplicationJsonSchemaContentItems"},"Documentation_searchDocumentation_Response_200":{"type":"object","properties":{"content":{"type":"array","items":{"$ref":"#/components/schemas/V1DocsSearchPostResponsesContentApplicationJsonSchemaContentItems"}}},"required":["content"],"title":"Documentation_searchDocumentation_Response_200"},"Documentation_getPlatformDocumentation_Response_200":{"type":"object","properties":{"content":{"type":"string"},"mimeType":{"type":"string"}},"required":["content"],"title":"Documentation_getPlatformDocumentation_Response_200"},"Documentation_getBuildInstructions_Response_200":{"type":"object","properties":{"content":{"type":"string"}},"required":["content"],"title":"Documentation_getBuildInstructions_Response_200"},"EndUserAuthConsumeRequest":{"type":"object","properties":{"tenantOrganizationId":{"type":"string","minLength":1,"maxLength":255},"token":{"type":"string","minLength":1,"maxLength":255,"description":"The one-time sign-in token from the email"}},"required":["tenantOrganizationId","token"],"title":"EndUserAuthConsumeRequest"},"EndUserTokenGrantEndUser":{"type":"object","properties":{"displayName":{"type":["string","null"]},"email":{"type":"string"},"id":{"type":"string"},"tenantOrganizationId":{"type":"string"}},"required":["displayName","email","id","tenantOrganizationId"],"title":"EndUserTokenGrantEndUser"},"EndUserTokenGrantTokenType":{"type":"string","enum":["Bearer"],"title":"EndUserTokenGrantTokenType"},"EndUserTokenGrant":{"type":"object","properties":{"accessToken":{"type":"string","description":"Runtype-issued end-user access token: `rt_eu_` + ES256 JWT (1 hour)"},"endUser":{"$ref":"#/components/schemas/EndUserTokenGrantEndUser"},"expiresIn":{"type":"integer"},"refreshToken":{"type":"string","description":"Rotating refresh token (single-use, 30 days)"},"tokenType":{"$ref":"#/components/schemas/EndUserTokenGrantTokenType"}},"required":["accessToken","endUser","expiresIn","refreshToken","tokenType"],"title":"EndUserTokenGrant"},"EndUserAuthJwks":{"type":"object","properties":{"keys":{"type":"array","items":{"type":"object","additionalProperties":{"description":"Any type"}}}},"required":["keys"],"title":"EndUserAuthJwks"},"EndUserAuthRefreshRequest":{"type":"object","properties":{"refreshToken":{"type":"string","minLength":1,"maxLength":255}},"required":["refreshToken"],"title":"EndUserAuthRefreshRequest"},"EndUserAuthRequestLinkRequest":{"type":"object","properties":{"email":{"type":"string","format":"email","maxLength":255,"description":"The end user email address"},"tenantOrganizationId":{"type":"string","minLength":1,"maxLength":255,"description":"The customer organization whose product the end user is signing in to"}},"required":["email","tenantOrganizationId"],"title":"EndUserAuthRequestLinkRequest"},"EndUserAuthRequestLinkResponse":{"type":"object","properties":{"message":{"type":"string"},"ok":{"type":"boolean"}},"required":["message","ok"],"title":"EndUserAuthRequestLinkResponse"},"End-User_Integrations_beginEndUserOAuthConnection_Response_200":{"type":"object","properties":{"authorizeUrl":{"type":"string","description":"Redirect the end user here to authorize the third-party account."},"endUserId":{"type":"string","description":"The durable end-user id (eu_*) the token will scope to."},"state":{"type":"string","description":"Opaque single-use CSRF token (bound in KV)."}},"required":["authorizeUrl","endUserId","state"],"title":"End-User Integrations_beginEndUserOAuthConnection_Response_200"},"V1EvalAnalyzeStepsPostResponsesContentApplicationJsonSchemaResultsItemsTermAnalysisItems":{"type":"object","properties":{"occurrenceRate":{"type":"number","format":"double"},"stepsContainingTerm":{"type":"integer"},"term":{"type":"string"},"totalOccurrences":{"type":"integer"}},"required":["occurrenceRate","stepsContainingTerm","term","totalOccurrences"],"title":"V1EvalAnalyzeStepsPostResponsesContentApplicationJsonSchemaResultsItemsTermAnalysisItems"},"V1EvalAnalyzeStepsPostResponsesContentApplicationJsonSchemaResultsItems":{"type":"object","properties":{"batchExecutionId":{"type":"string"},"evalConfig":{"description":"Any type"},"evalName":{"type":"string"},"termAnalysis":{"type":"array","items":{"$ref":"#/components/schemas/V1EvalAnalyzeStepsPostResponsesContentApplicationJsonSchemaResultsItemsTermAnalysisItems"}},"totalStepsAnalyzed":{"type":"integer"}},"required":["batchExecutionId","termAnalysis","totalStepsAnalyzed"],"title":"V1EvalAnalyzeStepsPostResponsesContentApplicationJsonSchemaResultsItems"},"Evals_analyzeStepResults_Response_200":{"type":"object","properties":{"evalGroupId":{"type":"string"},"results":{"type":"array","items":{"$ref":"#/components/schemas/V1EvalAnalyzeStepsPostResponsesContentApplicationJsonSchemaResultsItems"}},"searchTerms":{"type":"array","items":{"type":"string"}},"stepIds":{"type":"array","items":{"type":"string"}}},"required":["evalGroupId","results","searchTerms","stepIds"],"title":"Evals_analyzeStepResults_Response_200"},"V1EvalBatchesGetParametersOrigin":{"type":"string","enum":["suite","adhoc"],"description":"Filter by run origin: \"suite\" = runs linked to an eval suite (CI gates, suite Run button); \"adhoc\" = suite-less runs (ad-hoc config comparisons, legacy evals).","title":"V1EvalBatchesGetParametersOrigin"},"V1EvalBatchesGetResponsesContentApplicationJsonSchemaBatchesItems":{"type":"object","properties":{},"title":"V1EvalBatchesGetResponsesContentApplicationJsonSchemaBatchesItems"},"Evals_listEvalBatches_Response_200":{"type":"object","properties":{"batches":{"type":"array","items":{"$ref":"#/components/schemas/V1EvalBatchesGetResponsesContentApplicationJsonSchemaBatchesItems"}},"count":{"type":"number","format":"double"},"hasMore":{"type":"boolean","description":"True when this page came back full — there may be more rows past it."},"limit":{"type":"number","format":"double"},"offset":{"type":"number","format":"double"}},"required":["batches","count","hasMore","limit","offset"],"title":"Evals_listEvalBatches_Response_200"},"V1EvalComparePostResponsesContentApplicationJsonSchemaEvalsItemsMetrics":{"type":"object","properties":{"avgCostPerRecord":{"type":"number","format":"double"},"avgDurationPerRecord":{"type":"number","format":"double"},"failedSteps":{"type":"integer"},"successRate":{"type":"number","format":"double"},"successfulSteps":{"type":"integer"},"totalCompletionTokens":{"type":"integer"},"totalCost":{"type":"number","format":"double"},"totalDurationMs":{"type":"number","format":"double"},"totalPromptTokens":{"type":"integer"},"totalSteps":{"type":"integer"}},"required":["avgCostPerRecord","avgDurationPerRecord","failedSteps","successRate","successfulSteps","totalCompletionTokens","totalCost","totalDurationMs","totalPromptTokens","totalSteps"],"title":"V1EvalComparePostResponsesContentApplicationJsonSchemaEvalsItemsMetrics"},"V1EvalComparePostResponsesContentApplicationJsonSchemaEvalsItems":{"type":"object","properties":{"batchExecutionId":{"type":"string"},"evalConfig":{"description":"Any type"},"evalName":{"type":"string"},"metrics":{"$ref":"#/components/schemas/V1EvalComparePostResponsesContentApplicationJsonSchemaEvalsItemsMetrics"}},"required":["batchExecutionId","metrics"],"title":"V1EvalComparePostResponsesContentApplicationJsonSchemaEvalsItems"},"Evals_compareEvals_Response_200":{"type":"object","properties":{"evalGroupId":{"type":"string"},"evals":{"type":"array","items":{"$ref":"#/components/schemas/V1EvalComparePostResponsesContentApplicationJsonSchemaEvalsItems"}}},"required":["evalGroupId","evals"],"title":"Evals_compareEvals_Response_200"},"V1EvalCompareRecordPostResponsesContentApplicationJsonSchemaEvalsItemsStepResultsItems":{"type":"object","properties":{"completionTokens":{"type":["integer","null"]},"durationMs":{"type":["integer","null"]},"error":{"type":"string"},"executedAt":{"type":"string"},"modelUsed":{"type":["string","null"]},"output":{"type":["string","null"]},"promptTokens":{"type":["integer","null"]},"stepId":{"type":"string"},"stepName":{"type":["string","null"]},"stepResultId":{"type":"string"},"stepType":{"type":"string"},"toolCalls":{"type":"array","items":{"description":"Any type"}},"totalCost":{"type":["number","null"],"format":"double"}},"required":["completionTokens","durationMs","executedAt","modelUsed","output","promptTokens","stepId","stepName","stepResultId","stepType","toolCalls","totalCost"],"title":"V1EvalCompareRecordPostResponsesContentApplicationJsonSchemaEvalsItemsStepResultsItems"},"V1EvalCompareRecordPostResponsesContentApplicationJsonSchemaEvalsItems":{"type":"object","properties":{"batchExecutionId":{"type":"string"},"evalConfig":{"description":"Any type"},"evalName":{"type":"string"},"stepResults":{"type":"array","items":{"$ref":"#/components/schemas/V1EvalCompareRecordPostResponsesContentApplicationJsonSchemaEvalsItemsStepResultsItems"}}},"required":["batchExecutionId","stepResults"],"title":"V1EvalCompareRecordPostResponsesContentApplicationJsonSchemaEvalsItems"},"Evals_compareRecordAcrossEvals_Response_200":{"type":"object","properties":{"evalGroupId":{"type":"string"},"evals":{"type":"array","items":{"$ref":"#/components/schemas/V1EvalCompareRecordPostResponsesContentApplicationJsonSchemaEvalsItems"}},"recordId":{"type":"string"}},"required":["evalGroupId","evals","recordId"],"title":"Evals_compareRecordAcrossEvals_Response_200"},"Evals_ensureDefaultEvalSuites_Response_200":{"type":"object","properties":{"created":{"type":"integer"}},"required":["created"],"title":"Evals_ensureDefaultEvalSuites_Response_200"},"V1EvalEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionCasesItemsExpectItems":{"type":"object","properties":{"kind":{"type":"string","minLength":1}},"required":["kind"],"title":"V1EvalEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionCasesItemsExpectItems"},"V1EvalEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionCasesItemsExpected":{"type":"object","properties":{"facts":{"type":"array","items":{"type":"string"}},"json":{"description":"Any type"},"text":{"type":"string"}},"title":"V1EvalEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionCasesItemsExpected"},"V1EvalEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionCasesItemsInputEndUser":{"type":"object","properties":{"email":{"type":"string"},"id":{"type":"string","minLength":1}},"required":["id"],"description":"The end user (the person) the turn runs as. Exposed to tools as _endUser.*, drives memory-profile sharding, and satisfies an end-user-isolated tenancyStrategy. Distinct from _user (the Builder User).","title":"V1EvalEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionCasesItemsInputEndUser"},"V1EvalEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionCasesItemsInputMessagesItems":{"type":"object","properties":{"content":{"type":"string"},"role":{"type":"string","minLength":1}},"required":["content","role"],"title":"V1EvalEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionCasesItemsInputMessagesItems"},"V1EvalEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionCasesItemsInputTenant":{"type":"object","properties":{"id":{"type":"string","minLength":1}},"required":["id"],"description":"The product tenant (a customer of your product, under your Builder Org) the turn runs within. Exposed to tools as _tenant.*.","title":"V1EvalEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionCasesItemsInputTenant"},"V1EvalEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionCasesItemsInputToolMocksItemsOutput":{"oneOf":[{"type":"boolean"},{"type":"number","format":"double"},{"type":"string"},{"type":"array","items":{"description":"Any type"}},{"type":"object","additionalProperties":{"description":"Any type"}}],"title":"V1EvalEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionCasesItemsInputToolMocksItemsOutput"},"V1EvalEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionCasesItemsInputToolMocksItems":{"type":"object","properties":{"input":{"description":"Any type"},"isError":{"type":"boolean"},"output":{"oneOf":[{"$ref":"#/components/schemas/V1EvalEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionCasesItemsInputToolMocksItemsOutput"},{"type":"null"}]},"sourceToolExecutionId":{"type":"string"},"toolName":{"type":"string","minLength":1},"truncated":{"type":"boolean"}},"required":["output","toolName"],"title":"V1EvalEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionCasesItemsInputToolMocksItems"},"V1EvalEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionCasesItemsInput":{"type":"object","properties":{"endUser":{"$ref":"#/components/schemas/V1EvalEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionCasesItemsInputEndUser","description":"The end user (the person) the turn runs as. Exposed to tools as _endUser.*, drives memory-profile sharding, and satisfies an end-user-isolated tenancyStrategy. Distinct from _user (the Builder User)."},"messages":{"type":"array","items":{"$ref":"#/components/schemas/V1EvalEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionCasesItemsInputMessagesItems"}},"tenant":{"$ref":"#/components/schemas/V1EvalEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionCasesItemsInputTenant","description":"The product tenant (a customer of your product, under your Builder Org) the turn runs within. Exposed to tools as _tenant.*."},"toolMocks":{"type":"array","items":{"$ref":"#/components/schemas/V1EvalEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionCasesItemsInputToolMocksItems"}},"variables":{"type":"object","additionalProperties":{"description":"Any type"}}},"title":"V1EvalEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionCasesItemsInput"},"V1EvalEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionCasesItems":{"type":"object","properties":{"expect":{"type":"array","items":{"$ref":"#/components/schemas/V1EvalEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionCasesItemsExpectItems"}},"expected":{"$ref":"#/components/schemas/V1EvalEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionCasesItemsExpected"},"input":{"$ref":"#/components/schemas/V1EvalEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionCasesItemsInput","default":{}},"name":{"type":"string","minLength":1}},"required":["expect","name"],"title":"V1EvalEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionCasesItems"},"V1EvalEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionIdentityDefaultsEndUser":{"type":"object","properties":{"email":{"type":"string"},"id":{"type":"string","minLength":1}},"required":["id"],"description":"The end user (the person) the turn runs as. Exposed to tools as _endUser.*, drives memory-profile sharding, and satisfies an end-user-isolated tenancyStrategy. Distinct from _user (the Builder User).","title":"V1EvalEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionIdentityDefaultsEndUser"},"V1EvalEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionIdentityDefaultsTenant":{"type":"object","properties":{"id":{"type":"string","minLength":1}},"required":["id"],"description":"The product tenant (a customer of your product, under your Builder Org) the turn runs within. Exposed to tools as _tenant.*.","title":"V1EvalEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionIdentityDefaultsTenant"},"V1EvalEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionIdentityDefaults":{"type":"object","properties":{"endUser":{"$ref":"#/components/schemas/V1EvalEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionIdentityDefaultsEndUser","description":"The end user (the person) the turn runs as. Exposed to tools as _endUser.*, drives memory-profile sharding, and satisfies an end-user-isolated tenancyStrategy. Distinct from _user (the Builder User)."},"tenant":{"$ref":"#/components/schemas/V1EvalEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionIdentityDefaultsTenant","description":"The product tenant (a customer of your product, under your Builder Org) the turn runs within. Exposed to tools as _tenant.*."}},"description":"Default identity (endUser / tenant) every case runs as unless the case sets its own. Omitting it on a converge clears the stored default.","title":"V1EvalEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionIdentityDefaults"},"V1EvalEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionRecordedToolMode":{"type":"string","enum":["next_step","continue"],"description":"How cases carrying toolMocks replay — captured (saved_from_run) or hand-authored alike: \"next_step\" (default; captured cases only) captures the first tool intent and stops, or \"continue\" serves each case's toolMocks by tool name and runs past the first action.","title":"V1EvalEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionRecordedToolMode"},"V1EvalEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionRecordedToolUnmatchedPolicy":{"type":"string","enum":["fail","stub"],"description":"For \"continue\"-mode replays, the unmatched-call policy: \"fail\" (default) or \"stub\".","title":"V1EvalEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionRecordedToolUnmatchedPolicy"},"V1EvalEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionTarget":{"type":"object","properties":{"agent":{"type":"string","minLength":1},"flow":{"type":"string","minLength":1}},"title":"V1EvalEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionTarget"},"V1EvalEnsurePostRequestBodyContentApplicationJsonSchemaDefinition":{"type":"object","properties":{"cases":{"type":"array","items":{"$ref":"#/components/schemas/V1EvalEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionCasesItems"}},"identityDefaults":{"$ref":"#/components/schemas/V1EvalEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionIdentityDefaults","description":"Default identity (endUser / tenant) every case runs as unless the case sets its own. Omitting it on a converge clears the stored default."},"name":{"type":"string","minLength":1},"recordedToolMode":{"$ref":"#/components/schemas/V1EvalEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionRecordedToolMode","description":"How cases carrying toolMocks replay — captured (saved_from_run) or hand-authored alike: \"next_step\" (default; captured cases only) captures the first tool intent and stops, or \"continue\" serves each case's toolMocks by tool name and runs past the first action."},"recordedToolUnmatchedPolicy":{"$ref":"#/components/schemas/V1EvalEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionRecordedToolUnmatchedPolicy","description":"For \"continue\"-mode replays, the unmatched-call policy: \"fail\" (default) or \"stub\"."},"target":{"$ref":"#/components/schemas/V1EvalEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionTarget"},"virtual":{"type":"boolean"}},"required":["cases","name","target"],"title":"V1EvalEnsurePostRequestBodyContentApplicationJsonSchemaDefinition"},"V1EvalEnsurePostRequestBodyContentApplicationJsonSchemaOnConflict":{"type":"string","enum":["error","overwrite"],"title":"V1EvalEnsurePostRequestBodyContentApplicationJsonSchemaOnConflict"},"EvalEnsureResponseOneOf0Result":{"type":"string","enum":["unchanged","created","updated"],"title":"EvalEnsureResponseOneOf0Result"},"EvalEnsureResponse0":{"type":"object","properties":{"contentHash":{"type":"string","description":"Server-computed canonical content hash. Clients should echo this hash in probes."},"result":{"$ref":"#/components/schemas/EvalEnsureResponseOneOf0Result"},"suiteId":{"type":"string"}},"required":["contentHash","result","suiteId"],"title":"EvalEnsureResponse0"},"EvalEnsureResponseOneOf1Result":{"type":"string","enum":["definitionRequired"],"title":"EvalEnsureResponseOneOf1Result"},"EvalEnsureResponse1":{"type":"object","properties":{"result":{"$ref":"#/components/schemas/EvalEnsureResponseOneOf1Result"}},"required":["result"],"title":"EvalEnsureResponse1"},"EvalEnsureResponseOneOf2Changes":{"type":"string","enum":["none","create","update"],"title":"EvalEnsureResponseOneOf2Changes"},"EvalEnsureResponseOneOf2Result":{"type":"string","enum":["plan"],"title":"EvalEnsureResponseOneOf2Result"},"EvalEnsureResponse2":{"type":"object","properties":{"changedKeys":{"type":"array","items":{"type":"string"}},"changes":{"$ref":"#/components/schemas/EvalEnsureResponseOneOf2Changes"},"contentHash":{"type":"string"},"remoteHash":{"type":"string"},"result":{"$ref":"#/components/schemas/EvalEnsureResponseOneOf2Result"},"suiteId":{"type":"string"}},"required":["changedKeys","changes","contentHash","result"],"title":"EvalEnsureResponse2"},"EvalEnsureResponse":{"oneOf":[{"$ref":"#/components/schemas/EvalEnsureResponse0"},{"$ref":"#/components/schemas/EvalEnsureResponse1"},{"$ref":"#/components/schemas/EvalEnsureResponse2"}],"title":"EvalEnsureResponse"},"EvalEnsureConflictCode":{"type":"string","enum":["external_modification","remote_changed"],"title":"EvalEnsureConflictCode"},"EvalEnsureConflict":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/EvalEnsureConflictCode"},"currentHash":{"type":["string","null"]},"error":{"type":"string"},"lastModifiedSource":{"type":"string"},"modifiedAt":{"type":["string","null"]}},"required":["code","error"],"title":"EvalEnsureConflict"},"CaptureExecutionPreviewAction":{"type":"object","properties":{"forkMessageIndex":{"type":"integer","minimum":0,"description":"Pass this as `forkMessageIndex` on the capture request to make THIS action the graded next step (the history is frozen just before it)."},"input":{"description":"Recorded call input (pattern-scrubbed)."},"isError":{"type":"boolean","description":"True when the recorded call failed (its output is the error payload)."},"toolName":{"type":"string"},"truncated":{"type":"boolean","description":"True when the recorded output was capped at capture; makes the case partially replayable."}},"required":["forkMessageIndex","toolName"],"title":"CaptureExecutionPreviewAction"},"CaptureExecutionPreview":{"type":"object","properties":{"actions":{"type":"array","items":{"$ref":"#/components/schemas/CaptureExecutionPreviewAction"},"description":"The recorded tool-call actions in invocation order — the fork-picker rows."},"defaultForkMessageIndex":{"type":"integer","description":"The fork the server uses when `forkMessageIndex` is omitted: just before the last recorded action, or the end of the seed for a run with no tool calls."},"executionId":{"type":"string"},"messageCount":{"type":"integer","description":"Length of the full reconstructed history (seed messages + one call/result pair per action)."},"replayable":{"type":"boolean","description":"True when every recorded tool output would be captured in full (nothing truncated)."}},"required":["actions","defaultForkMessageIndex","executionId","messageCount","replayable"],"title":"CaptureExecutionPreview"},"DecomposeCriteriaRequest":{"type":"object","properties":{"criteria":{"type":"string","minLength":1,"maxLength":4000,"description":"One plain-language AI-grader criterion to split into focused sub-checks."}},"required":["criteria"],"title":"DecomposeCriteriaRequest"},"DecomposeCriteriaResponseSubChecksItems":{"type":"object","properties":{"criteria":{"type":"string"}},"required":["criteria"],"title":"DecomposeCriteriaResponseSubChecksItems"},"DecomposeCriteriaResponse":{"type":"object","properties":{"model":{"type":"string","description":"Resolved model id that produced the proposal."},"subChecks":{"type":"array","items":{"$ref":"#/components/schemas/DecomposeCriteriaResponseSubChecksItems"},"description":"Proposed focused checks (1-8), ordered as the obligations appear in the original criterion. A single entry means the criterion is already focused. Each accepted sub-check becomes a plain {kind:\"ai\"} grader row."}},"required":["model","subChecks"],"title":"DecomposeCriteriaResponse"},"V1EvalGroupGroupIdGetResponsesContentApplicationJsonSchemaBatchesItems":{"type":"object","properties":{},"title":"V1EvalGroupGroupIdGetResponsesContentApplicationJsonSchemaBatchesItems"},"Evals_getEvalGroup_Response_200":{"type":"object","properties":{"batches":{"type":"array","items":{"$ref":"#/components/schemas/V1EvalGroupGroupIdGetResponsesContentApplicationJsonSchemaBatchesItems"}},"evalGroupId":{"type":"string"},"totalEvals":{"type":"number","format":"double"}},"required":["batches","evalGroupId","totalEvals"],"title":"Evals_getEvalGroup_Response_200"},"V1EvalProposalsGetParametersStatus":{"type":"string","enum":["proposed","accepted","edited_accepted","rejected"],"description":"Filter by status. Omit for all; the queue UI uses \"proposed\".","title":"V1EvalProposalsGetParametersStatus"},"EvalCaseProposalSource":{"type":"string","enum":["definition","trace","feedback","coverage_gap"],"title":"EvalCaseProposalSource"},"EvalCaseProposalStatus":{"type":"string","enum":["proposed","accepted","edited_accepted","rejected"],"title":"EvalCaseProposalStatus"},"EvalCaseProposal":{"type":"object","properties":{"acceptedCaseId":{"type":["string","null"]},"createdAt":{"type":"string"},"id":{"type":"string"},"proposedCase":{"description":"The full case body accept writes ({ name, input, expected?, notes? })."},"rationale":{"type":"string"},"resolvedAt":{"type":["string","null"]},"resolvedBy":{"type":["string","null"]},"source":{"$ref":"#/components/schemas/EvalCaseProposalSource"},"sourceRefs":{"type":"object","additionalProperties":{"description":"Any type"},"description":"Provenance pointers keyed by source (category/persona, toolName/instruction, executionId, feedbackId)."},"status":{"$ref":"#/components/schemas/EvalCaseProposalStatus"},"suggestedGraders":{"type":["array","null"],"items":{"description":"Any type"},"description":"GraderConfig[] the generator suggests adding. Informational in v1: accepting a proposal adds the case only, never graders."},"suiteId":{"type":"string"}},"required":["acceptedCaseId","createdAt","id","rationale","resolvedAt","resolvedBy","source","sourceRefs","status","suggestedGraders","suiteId"],"title":"EvalCaseProposal"},"SuiteEvalCaseProposals":{"type":"object","properties":{"proposals":{"type":"array","items":{"$ref":"#/components/schemas/EvalCaseProposal"},"description":"The newest matching proposals, at most `limit`."},"suiteId":{"type":"string"},"total":{"type":"integer","description":"Total proposals on this suite matching the filter."}},"required":["proposals","suiteId","total"],"title":"SuiteEvalCaseProposals"},"SuiteEvalCaseProposalsList":{"type":"object","properties":{"limit":{"type":"integer"},"suites":{"type":"array","items":{"$ref":"#/components/schemas/SuiteEvalCaseProposals"}}},"required":["limit","suites"],"title":"SuiteEvalCaseProposalsList"},"EvalPullResponseDefinitionCasesItemsExpectItems":{"type":"object","properties":{"kind":{"type":"string","minLength":1}},"required":["kind"],"title":"EvalPullResponseDefinitionCasesItemsExpectItems"},"EvalPullResponseDefinitionCasesItemsExpected":{"type":"object","properties":{"facts":{"type":"array","items":{"type":"string"}},"json":{"description":"Any type"},"text":{"type":"string"}},"title":"EvalPullResponseDefinitionCasesItemsExpected"},"EvalPullResponseDefinitionCasesItemsInputEndUser":{"type":"object","properties":{"email":{"type":"string"},"id":{"type":"string","minLength":1}},"required":["id"],"description":"The end user (the person) the turn runs as. Exposed to tools as _endUser.*, drives memory-profile sharding, and satisfies an end-user-isolated tenancyStrategy. Distinct from _user (the Builder User).","title":"EvalPullResponseDefinitionCasesItemsInputEndUser"},"EvalPullResponseDefinitionCasesItemsInputMessagesItems":{"type":"object","properties":{"content":{"type":"string"},"role":{"type":"string","minLength":1}},"required":["content","role"],"title":"EvalPullResponseDefinitionCasesItemsInputMessagesItems"},"EvalPullResponseDefinitionCasesItemsInputTenant":{"type":"object","properties":{"id":{"type":"string","minLength":1}},"required":["id"],"description":"The product tenant (a customer of your product, under your Builder Org) the turn runs within. Exposed to tools as _tenant.*.","title":"EvalPullResponseDefinitionCasesItemsInputTenant"},"EvalPullResponseDefinitionCasesItemsInputToolMocksItemsOutput":{"oneOf":[{"type":"boolean"},{"type":"number","format":"double"},{"type":"string"},{"type":"array","items":{"description":"Any type"}},{"type":"object","additionalProperties":{"description":"Any type"}}],"title":"EvalPullResponseDefinitionCasesItemsInputToolMocksItemsOutput"},"EvalPullResponseDefinitionCasesItemsInputToolMocksItems":{"type":"object","properties":{"input":{"description":"Any type"},"isError":{"type":"boolean"},"output":{"oneOf":[{"$ref":"#/components/schemas/EvalPullResponseDefinitionCasesItemsInputToolMocksItemsOutput"},{"type":"null"}]},"sourceToolExecutionId":{"type":"string"},"toolName":{"type":"string","minLength":1},"truncated":{"type":"boolean"}},"required":["output","toolName"],"title":"EvalPullResponseDefinitionCasesItemsInputToolMocksItems"},"EvalPullResponseDefinitionCasesItemsInput":{"type":"object","properties":{"endUser":{"$ref":"#/components/schemas/EvalPullResponseDefinitionCasesItemsInputEndUser","description":"The end user (the person) the turn runs as. Exposed to tools as _endUser.*, drives memory-profile sharding, and satisfies an end-user-isolated tenancyStrategy. Distinct from _user (the Builder User)."},"messages":{"type":"array","items":{"$ref":"#/components/schemas/EvalPullResponseDefinitionCasesItemsInputMessagesItems"}},"tenant":{"$ref":"#/components/schemas/EvalPullResponseDefinitionCasesItemsInputTenant","description":"The product tenant (a customer of your product, under your Builder Org) the turn runs within. Exposed to tools as _tenant.*."},"toolMocks":{"type":"array","items":{"$ref":"#/components/schemas/EvalPullResponseDefinitionCasesItemsInputToolMocksItems"}},"variables":{"type":"object","additionalProperties":{"description":"Any type"}}},"title":"EvalPullResponseDefinitionCasesItemsInput"},"EvalPullResponseDefinitionCasesItems":{"type":"object","properties":{"expect":{"type":"array","items":{"$ref":"#/components/schemas/EvalPullResponseDefinitionCasesItemsExpectItems"}},"expected":{"$ref":"#/components/schemas/EvalPullResponseDefinitionCasesItemsExpected"},"input":{"$ref":"#/components/schemas/EvalPullResponseDefinitionCasesItemsInput","default":{}},"name":{"type":"string","minLength":1}},"required":["expect","name"],"title":"EvalPullResponseDefinitionCasesItems"},"EvalPullResponseDefinitionIdentityDefaultsEndUser":{"type":"object","properties":{"email":{"type":"string"},"id":{"type":"string","minLength":1}},"required":["id"],"description":"The end user (the person) the turn runs as. Exposed to tools as _endUser.*, drives memory-profile sharding, and satisfies an end-user-isolated tenancyStrategy. Distinct from _user (the Builder User).","title":"EvalPullResponseDefinitionIdentityDefaultsEndUser"},"EvalPullResponseDefinitionIdentityDefaultsTenant":{"type":"object","properties":{"id":{"type":"string","minLength":1}},"required":["id"],"description":"The product tenant (a customer of your product, under your Builder Org) the turn runs within. Exposed to tools as _tenant.*.","title":"EvalPullResponseDefinitionIdentityDefaultsTenant"},"EvalPullResponseDefinitionIdentityDefaults":{"type":"object","properties":{"endUser":{"$ref":"#/components/schemas/EvalPullResponseDefinitionIdentityDefaultsEndUser","description":"The end user (the person) the turn runs as. Exposed to tools as _endUser.*, drives memory-profile sharding, and satisfies an end-user-isolated tenancyStrategy. Distinct from _user (the Builder User)."},"tenant":{"$ref":"#/components/schemas/EvalPullResponseDefinitionIdentityDefaultsTenant","description":"The product tenant (a customer of your product, under your Builder Org) the turn runs within. Exposed to tools as _tenant.*."}},"description":"Default identity (endUser / tenant) every case runs as unless the case sets its own. Omitting it on a converge clears the stored default.","title":"EvalPullResponseDefinitionIdentityDefaults"},"EvalPullResponseDefinitionRecordedToolMode":{"type":"string","enum":["next_step","continue"],"description":"How cases carrying toolMocks replay — captured (saved_from_run) or hand-authored alike: \"next_step\" (default; captured cases only) captures the first tool intent and stops, or \"continue\" serves each case's toolMocks by tool name and runs past the first action.","title":"EvalPullResponseDefinitionRecordedToolMode"},"EvalPullResponseDefinitionRecordedToolUnmatchedPolicy":{"type":"string","enum":["fail","stub"],"description":"For \"continue\"-mode replays, the unmatched-call policy: \"fail\" (default) or \"stub\".","title":"EvalPullResponseDefinitionRecordedToolUnmatchedPolicy"},"EvalPullResponseDefinitionTarget":{"type":"object","properties":{"agent":{"type":"string","minLength":1},"flow":{"type":"string","minLength":1}},"title":"EvalPullResponseDefinitionTarget"},"EvalPullResponseDefinition":{"type":"object","properties":{"cases":{"type":"array","items":{"$ref":"#/components/schemas/EvalPullResponseDefinitionCasesItems"}},"identityDefaults":{"$ref":"#/components/schemas/EvalPullResponseDefinitionIdentityDefaults","description":"Default identity (endUser / tenant) every case runs as unless the case sets its own. Omitting it on a converge clears the stored default."},"name":{"type":"string","minLength":1},"recordedToolMode":{"$ref":"#/components/schemas/EvalPullResponseDefinitionRecordedToolMode","description":"How cases carrying toolMocks replay — captured (saved_from_run) or hand-authored alike: \"next_step\" (default; captured cases only) captures the first tool intent and stops, or \"continue\" serves each case's toolMocks by tool name and runs past the first action."},"recordedToolUnmatchedPolicy":{"$ref":"#/components/schemas/EvalPullResponseDefinitionRecordedToolUnmatchedPolicy","description":"For \"continue\"-mode replays, the unmatched-call policy: \"fail\" (default) or \"stub\"."},"target":{"$ref":"#/components/schemas/EvalPullResponseDefinitionTarget"},"virtual":{"type":"boolean"}},"required":["cases","name","target"],"title":"EvalPullResponseDefinition"},"EvalPullResponse":{"type":"object","properties":{"contentHash":{"type":"string"},"definition":{"$ref":"#/components/schemas/EvalPullResponseDefinition"},"lastModifiedSource":{"type":["string","null"]},"suiteId":{"type":"string"},"updatedAt":{"type":["string","null"]}},"required":["contentHash","definition","lastModifiedSource","suiteId","updatedAt"],"title":"EvalPullResponse"},"V1EvalRunPostRequestBodyContentApplicationJsonSchemaAgent":{"type":"object","properties":{"alias":{"type":"string","minLength":1,"maxLength":63,"description":"Run whichever version this release alias currently points at. Resolved once for the whole run."},"versionId":{"type":"string","minLength":1,"description":"Run this exact immutable version snapshot."}},"description":"Version selector for an Agent target. Supply at most one of alias or versionId; the run resolves it once and every case executes that version.","title":"V1EvalRunPostRequestBodyContentApplicationJsonSchemaAgent"},"V1EvalRunPostRequestBodyContentApplicationJsonSchemaDefinitionCasesItemsExpectItems":{"type":"object","properties":{"kind":{"type":"string","minLength":1}},"required":["kind"],"title":"V1EvalRunPostRequestBodyContentApplicationJsonSchemaDefinitionCasesItemsExpectItems"},"V1EvalRunPostRequestBodyContentApplicationJsonSchemaDefinitionCasesItemsExpected":{"type":"object","properties":{"facts":{"type":"array","items":{"type":"string"}},"json":{"description":"Any type"},"text":{"type":"string"}},"title":"V1EvalRunPostRequestBodyContentApplicationJsonSchemaDefinitionCasesItemsExpected"},"V1EvalRunPostRequestBodyContentApplicationJsonSchemaDefinitionCasesItemsInputEndUser":{"type":"object","properties":{"email":{"type":"string"},"id":{"type":"string","minLength":1}},"required":["id"],"description":"The end user (the person) the turn runs as. Exposed to tools as _endUser.*, drives memory-profile sharding, and satisfies an end-user-isolated tenancyStrategy. Distinct from _user (the Builder User).","title":"V1EvalRunPostRequestBodyContentApplicationJsonSchemaDefinitionCasesItemsInputEndUser"},"V1EvalRunPostRequestBodyContentApplicationJsonSchemaDefinitionCasesItemsInputMessagesItems":{"type":"object","properties":{"content":{"type":"string"},"role":{"type":"string","minLength":1}},"required":["content","role"],"title":"V1EvalRunPostRequestBodyContentApplicationJsonSchemaDefinitionCasesItemsInputMessagesItems"},"V1EvalRunPostRequestBodyContentApplicationJsonSchemaDefinitionCasesItemsInputTenant":{"type":"object","properties":{"id":{"type":"string","minLength":1}},"required":["id"],"description":"The product tenant (a customer of your product, under your Builder Org) the turn runs within. Exposed to tools as _tenant.*.","title":"V1EvalRunPostRequestBodyContentApplicationJsonSchemaDefinitionCasesItemsInputTenant"},"V1EvalRunPostRequestBodyContentApplicationJsonSchemaDefinitionCasesItemsInputToolMocksItemsOutput":{"oneOf":[{"type":"boolean"},{"type":"number","format":"double"},{"type":"string"},{"type":"array","items":{"description":"Any type"}},{"type":"object","additionalProperties":{"description":"Any type"}}],"title":"V1EvalRunPostRequestBodyContentApplicationJsonSchemaDefinitionCasesItemsInputToolMocksItemsOutput"},"V1EvalRunPostRequestBodyContentApplicationJsonSchemaDefinitionCasesItemsInputToolMocksItems":{"type":"object","properties":{"input":{"description":"Any type"},"isError":{"type":"boolean"},"output":{"oneOf":[{"$ref":"#/components/schemas/V1EvalRunPostRequestBodyContentApplicationJsonSchemaDefinitionCasesItemsInputToolMocksItemsOutput"},{"type":"null"}]},"sourceToolExecutionId":{"type":"string"},"toolName":{"type":"string","minLength":1},"truncated":{"type":"boolean"}},"required":["output","toolName"],"title":"V1EvalRunPostRequestBodyContentApplicationJsonSchemaDefinitionCasesItemsInputToolMocksItems"},"V1EvalRunPostRequestBodyContentApplicationJsonSchemaDefinitionCasesItemsInput":{"type":"object","properties":{"endUser":{"$ref":"#/components/schemas/V1EvalRunPostRequestBodyContentApplicationJsonSchemaDefinitionCasesItemsInputEndUser","description":"The end user (the person) the turn runs as. Exposed to tools as _endUser.*, drives memory-profile sharding, and satisfies an end-user-isolated tenancyStrategy. Distinct from _user (the Builder User)."},"messages":{"type":"array","items":{"$ref":"#/components/schemas/V1EvalRunPostRequestBodyContentApplicationJsonSchemaDefinitionCasesItemsInputMessagesItems"}},"tenant":{"$ref":"#/components/schemas/V1EvalRunPostRequestBodyContentApplicationJsonSchemaDefinitionCasesItemsInputTenant","description":"The product tenant (a customer of your product, under your Builder Org) the turn runs within. Exposed to tools as _tenant.*."},"toolMocks":{"type":"array","items":{"$ref":"#/components/schemas/V1EvalRunPostRequestBodyContentApplicationJsonSchemaDefinitionCasesItemsInputToolMocksItems"}},"variables":{"type":"object","additionalProperties":{"description":"Any type"}}},"title":"V1EvalRunPostRequestBodyContentApplicationJsonSchemaDefinitionCasesItemsInput"},"V1EvalRunPostRequestBodyContentApplicationJsonSchemaDefinitionCasesItems":{"type":"object","properties":{"expect":{"type":"array","items":{"$ref":"#/components/schemas/V1EvalRunPostRequestBodyContentApplicationJsonSchemaDefinitionCasesItemsExpectItems"}},"expected":{"$ref":"#/components/schemas/V1EvalRunPostRequestBodyContentApplicationJsonSchemaDefinitionCasesItemsExpected"},"input":{"$ref":"#/components/schemas/V1EvalRunPostRequestBodyContentApplicationJsonSchemaDefinitionCasesItemsInput","default":{}},"name":{"type":"string","minLength":1}},"required":["expect","name"],"title":"V1EvalRunPostRequestBodyContentApplicationJsonSchemaDefinitionCasesItems"},"V1EvalRunPostRequestBodyContentApplicationJsonSchemaDefinitionIdentityDefaultsEndUser":{"type":"object","properties":{"email":{"type":"string"},"id":{"type":"string","minLength":1}},"required":["id"],"description":"The end user (the person) the turn runs as. Exposed to tools as _endUser.*, drives memory-profile sharding, and satisfies an end-user-isolated tenancyStrategy. Distinct from _user (the Builder User).","title":"V1EvalRunPostRequestBodyContentApplicationJsonSchemaDefinitionIdentityDefaultsEndUser"},"V1EvalRunPostRequestBodyContentApplicationJsonSchemaDefinitionIdentityDefaultsTenant":{"type":"object","properties":{"id":{"type":"string","minLength":1}},"required":["id"],"description":"The product tenant (a customer of your product, under your Builder Org) the turn runs within. Exposed to tools as _tenant.*.","title":"V1EvalRunPostRequestBodyContentApplicationJsonSchemaDefinitionIdentityDefaultsTenant"},"V1EvalRunPostRequestBodyContentApplicationJsonSchemaDefinitionIdentityDefaults":{"type":"object","properties":{"endUser":{"$ref":"#/components/schemas/V1EvalRunPostRequestBodyContentApplicationJsonSchemaDefinitionIdentityDefaultsEndUser","description":"The end user (the person) the turn runs as. Exposed to tools as _endUser.*, drives memory-profile sharding, and satisfies an end-user-isolated tenancyStrategy. Distinct from _user (the Builder User)."},"tenant":{"$ref":"#/components/schemas/V1EvalRunPostRequestBodyContentApplicationJsonSchemaDefinitionIdentityDefaultsTenant","description":"The product tenant (a customer of your product, under your Builder Org) the turn runs within. Exposed to tools as _tenant.*."}},"description":"Default identity (endUser / tenant) every case runs as unless the case sets its own. Omitting it on a converge clears the stored default.","title":"V1EvalRunPostRequestBodyContentApplicationJsonSchemaDefinitionIdentityDefaults"},"V1EvalRunPostRequestBodyContentApplicationJsonSchemaDefinitionRecordedToolMode":{"type":"string","enum":["next_step","continue"],"description":"How cases carrying toolMocks replay — captured (saved_from_run) or hand-authored alike: \"next_step\" (default; captured cases only) captures the first tool intent and stops, or \"continue\" serves each case's toolMocks by tool name and runs past the first action.","title":"V1EvalRunPostRequestBodyContentApplicationJsonSchemaDefinitionRecordedToolMode"},"V1EvalRunPostRequestBodyContentApplicationJsonSchemaDefinitionRecordedToolUnmatchedPolicy":{"type":"string","enum":["fail","stub"],"description":"For \"continue\"-mode replays, the unmatched-call policy: \"fail\" (default) or \"stub\".","title":"V1EvalRunPostRequestBodyContentApplicationJsonSchemaDefinitionRecordedToolUnmatchedPolicy"},"V1EvalRunPostRequestBodyContentApplicationJsonSchemaDefinitionTarget":{"type":"object","properties":{"agent":{"type":"string","minLength":1},"flow":{"type":"string","minLength":1}},"title":"V1EvalRunPostRequestBodyContentApplicationJsonSchemaDefinitionTarget"},"V1EvalRunPostRequestBodyContentApplicationJsonSchemaDefinition":{"type":"object","properties":{"cases":{"type":"array","items":{"$ref":"#/components/schemas/V1EvalRunPostRequestBodyContentApplicationJsonSchemaDefinitionCasesItems"}},"identityDefaults":{"$ref":"#/components/schemas/V1EvalRunPostRequestBodyContentApplicationJsonSchemaDefinitionIdentityDefaults","description":"Default identity (endUser / tenant) every case runs as unless the case sets its own. Omitting it on a converge clears the stored default."},"name":{"type":"string","minLength":1},"recordedToolMode":{"$ref":"#/components/schemas/V1EvalRunPostRequestBodyContentApplicationJsonSchemaDefinitionRecordedToolMode","description":"How cases carrying toolMocks replay — captured (saved_from_run) or hand-authored alike: \"next_step\" (default; captured cases only) captures the first tool intent and stops, or \"continue\" serves each case's toolMocks by tool name and runs past the first action."},"recordedToolUnmatchedPolicy":{"$ref":"#/components/schemas/V1EvalRunPostRequestBodyContentApplicationJsonSchemaDefinitionRecordedToolUnmatchedPolicy","description":"For \"continue\"-mode replays, the unmatched-call policy: \"fail\" (default) or \"stub\"."},"target":{"$ref":"#/components/schemas/V1EvalRunPostRequestBodyContentApplicationJsonSchemaDefinitionTarget"},"virtual":{"type":"boolean"}},"required":["cases","name","target"],"title":"V1EvalRunPostRequestBodyContentApplicationJsonSchemaDefinition"},"RunEvalResponseAgentTargetResolution":{"type":"string","enum":["alias","version","legacy-live-row"],"description":"How the run picked its version. Null on a run that predates release aliases.","title":"RunEvalResponseAgentTargetResolution"},"RunEvalResponseCasesItemsFailureKind":{"type":"string","enum":["platform_stall"],"description":"Present when the failure belongs to the platform, not the target: the model gateway went silent and the stall watchdog gave up before the target could answer. Such a case runs no graders and is excluded from the suite score. Absent on an ordinary failure.","title":"RunEvalResponseCasesItemsFailureKind"},"RunEvalResponseCasesItemsOutcomesItemsEvidenceItemsKind":{"type":"string","enum":["message","tool_call"],"title":"RunEvalResponseCasesItemsOutcomesItemsEvidenceItemsKind"},"RunEvalResponseCasesItemsOutcomesItemsEvidenceItems":{"type":"object","properties":{"index":{"type":"integer","minimum":0},"kind":{"$ref":"#/components/schemas/RunEvalResponseCasesItemsOutcomesItemsEvidenceItemsKind"}},"required":["index","kind"],"title":"RunEvalResponseCasesItemsOutcomesItemsEvidenceItems"},"RunEvalResponseCasesItemsOutcomesItemsJudgeDiagnosticsAttemptsItemsAttempt0":{"type":"string","enum":["1"],"title":"RunEvalResponseCasesItemsOutcomesItemsJudgeDiagnosticsAttemptsItemsAttempt0"},"RunEvalResponseCasesItemsOutcomesItemsJudgeDiagnosticsAttemptsItemsAttempt1":{"type":"string","enum":["2"],"title":"RunEvalResponseCasesItemsOutcomesItemsJudgeDiagnosticsAttemptsItemsAttempt1"},"RunEvalResponseCasesItemsOutcomesItemsJudgeDiagnosticsAttemptsItemsAttempt":{"oneOf":[{"$ref":"#/components/schemas/RunEvalResponseCasesItemsOutcomesItemsJudgeDiagnosticsAttemptsItemsAttempt0"},{"$ref":"#/components/schemas/RunEvalResponseCasesItemsOutcomesItemsJudgeDiagnosticsAttemptsItemsAttempt1"}],"title":"RunEvalResponseCasesItemsOutcomesItemsJudgeDiagnosticsAttemptsItemsAttempt"},"RunEvalResponseCasesItemsOutcomesItemsJudgeDiagnosticsAttemptsItemsFinishReason":{"type":"string","enum":["stop","length","content-filter","tool-calls","error","other","unknown"],"title":"RunEvalResponseCasesItemsOutcomesItemsJudgeDiagnosticsAttemptsItemsFinishReason"},"RunEvalResponseCasesItemsOutcomesItemsJudgeDiagnosticsAttemptsItemsModelError":{"type":"string","enum":["empty_completion","model_call_error"],"title":"RunEvalResponseCasesItemsOutcomesItemsJudgeDiagnosticsAttemptsItemsModelError"},"RunEvalResponseCasesItemsOutcomesItemsJudgeDiagnosticsAttemptsItemsParseError":{"type":"string","enum":["empty_completion","invalid_json","invalid_contract","missing_access_assessment","invalid_access_assessment","output_truncated"],"title":"RunEvalResponseCasesItemsOutcomesItemsJudgeDiagnosticsAttemptsItemsParseError"},"RunEvalResponseCasesItemsOutcomesItemsJudgeDiagnosticsAttemptsItemsStatus":{"type":"string","enum":["valid","invalid_response","model_error"],"title":"RunEvalResponseCasesItemsOutcomesItemsJudgeDiagnosticsAttemptsItemsStatus"},"RunEvalResponseCasesItemsOutcomesItemsJudgeDiagnosticsAttemptsItems":{"type":"object","properties":{"attempt":{"$ref":"#/components/schemas/RunEvalResponseCasesItemsOutcomesItemsJudgeDiagnosticsAttemptsItemsAttempt"},"cacheReadTokens":{"type":"integer","minimum":0,"maximum":9007199254740991},"cacheWriteTokens":{"type":"integer","minimum":0,"maximum":9007199254740991},"completionTokens":{"type":"integer","minimum":0,"maximum":9007199254740991},"durationMs":{"type":"integer","minimum":0,"maximum":9007199254740991},"finishReason":{"$ref":"#/components/schemas/RunEvalResponseCasesItemsOutcomesItemsJudgeDiagnosticsAttemptsItemsFinishReason"},"modelError":{"$ref":"#/components/schemas/RunEvalResponseCasesItemsOutcomesItemsJudgeDiagnosticsAttemptsItemsModelError"},"parseError":{"$ref":"#/components/schemas/RunEvalResponseCasesItemsOutcomesItemsJudgeDiagnosticsAttemptsItemsParseError"},"promptTokens":{"type":"integer","minimum":0,"maximum":9007199254740991},"provider":{"type":"string","maxLength":64},"reasoningTokens":{"type":"integer","minimum":0,"maximum":9007199254740991},"requestedModel":{"type":"string","maxLength":160},"resolvedModel":{"type":"string","maxLength":160},"responseChars":{"type":"integer","minimum":0,"maximum":9007199254740991},"status":{"$ref":"#/components/schemas/RunEvalResponseCasesItemsOutcomesItemsJudgeDiagnosticsAttemptsItemsStatus"},"usageObserved":{"type":"boolean"}},"required":["attempt","durationMs","requestedModel","status","usageObserved"],"title":"RunEvalResponseCasesItemsOutcomesItemsJudgeDiagnosticsAttemptsItems"},"RunEvalResponseCasesItemsOutcomesItemsJudgeDiagnosticsFlowFailure":{"type":"string","enum":["deadline_exhausted","execution_failed","invalid_response"],"title":"RunEvalResponseCasesItemsOutcomesItemsJudgeDiagnosticsFlowFailure"},"RunEvalResponseCasesItemsOutcomesItemsJudgeDiagnostics":{"type":"object","properties":{"attempts":{"type":"array","items":{"$ref":"#/components/schemas/RunEvalResponseCasesItemsOutcomesItemsJudgeDiagnosticsAttemptsItems"}},"flowFailure":{"$ref":"#/components/schemas/RunEvalResponseCasesItemsOutcomesItemsJudgeDiagnosticsFlowFailure"}},"required":["attempts"],"title":"RunEvalResponseCasesItemsOutcomesItemsJudgeDiagnostics"},"RunEvalResponseCasesItemsOutcomesItemsSeverity":{"type":"string","enum":["gate","soft"],"description":"Grader severity. A soft miss is reported but only fails the suite under strict mode. Absent ⇒ gate.","title":"RunEvalResponseCasesItemsOutcomesItemsSeverity"},"RunEvalResponseCasesItemsOutcomesItemsVerdict":{"type":"string","enum":["pass","fail","insufficient_evidence"],"description":"AI graders only: the judge's binary verdict. insufficient_evidence means the judge declined to guess; it renders as a warning and never fails the case.","title":"RunEvalResponseCasesItemsOutcomesItemsVerdict"},"RunEvalResponseCasesItemsOutcomesItems":{"type":"object","properties":{"evidence":{"type":"array","items":{"$ref":"#/components/schemas/RunEvalResponseCasesItemsOutcomesItemsEvidenceItems"},"description":"AI graders only: transcript entries the verdict rests on — indices into the run's trace steps (message) or tool calls (tool_call)."},"graderIndex":{"type":"integer"},"judgeDiagnostics":{"$ref":"#/components/schemas/RunEvalResponseCasesItemsOutcomesItemsJudgeDiagnostics"},"kind":{"type":"string"},"passed":{"type":"boolean"},"reasoning":{"type":"string"},"score":{"type":"number","format":"double"},"severity":{"$ref":"#/components/schemas/RunEvalResponseCasesItemsOutcomesItemsSeverity","description":"Grader severity. A soft miss is reported but only fails the suite under strict mode. Absent ⇒ gate."},"verdict":{"$ref":"#/components/schemas/RunEvalResponseCasesItemsOutcomesItemsVerdict","description":"AI graders only: the judge's binary verdict. insufficient_evidence means the judge declined to guess; it renders as a warning and never fails the case."}},"required":["graderIndex","kind","passed"],"title":"RunEvalResponseCasesItemsOutcomesItems"},"RunEvalResponseCasesItems":{"type":"object","properties":{"error":{"type":"string","description":"Why the case errored (the provider or execution failure text, 2000 chars max). Present only when errored is true and the run reported a cause."},"errored":{"type":"boolean"},"failureKind":{"$ref":"#/components/schemas/RunEvalResponseCasesItemsFailureKind","description":"Present when the failure belongs to the platform, not the target: the model gateway went silent and the stall watchdog gave up before the target could answer. Such a case runs no graders and is excluded from the suite score. Absent on an ordinary failure."},"name":{"type":"string"},"outcomes":{"type":"array","items":{"$ref":"#/components/schemas/RunEvalResponseCasesItemsOutcomesItems"}},"outputExcerpt":{"type":"string"},"passed":{"type":"boolean"}},"required":["errored","name","outcomes","outputExcerpt","passed"],"title":"RunEvalResponseCasesItems"},"RunEvalResponseTargetType":{"type":"string","enum":["flow","agent"],"title":"RunEvalResponseTargetType"},"RunEvalResponse":{"type":"object","properties":{"agentTargetAlias":{"type":["string","null"],"description":"The release alias the run resolved through, when it resolved through one."},"agentTargetResolution":{"$ref":"#/components/schemas/RunEvalResponseAgentTargetResolution","description":"How the run picked its version. Null on a run that predates release aliases."},"agentVersionId":{"type":["string","null"],"description":"The exact Agent version every case of this run executed. Null for a legacy run."},"caseManifestHash":{"type":["string","null"],"description":"SHA-256 over the ordered, normalized case set this run executed."},"cases":{"type":"array","items":{"$ref":"#/components/schemas/RunEvalResponseCasesItems"}},"evaluatorFingerprint":{"type":["string","null"],"description":"SHA-256 over the evaluator configuration this run scored with."},"name":{"type":"string"},"passed":{"type":"boolean","description":"True when every case passed every grader."},"passedCases":{"type":"integer"},"platformAbortedCases":{"type":"integer","description":"Cases the platform aborted before the target could answer. They run no graders and are counted in neither half of score, so totalCases minus this is the denominator score was taken over."},"runId":{"type":["string","null"],"description":"The persisted run id — query its scores via GET /eval/runs/{runId}/scores. Null for an ephemeral (virtual/inline) run."},"score":{"type":"number","format":"double","description":"Suite score, 0..1 (passed cases / graded cases). Platform-aborted cases are excluded from both halves."},"suiteId":{"type":["string","null"]},"targetType":{"$ref":"#/components/schemas/RunEvalResponseTargetType"},"totalCases":{"type":"integer"}},"required":["cases","name","passed","passedCases","platformAbortedCases","runId","score","suiteId","targetType","totalCases"],"title":"RunEvalResponse"},"EvalQuotaExceededErrorDetailsItems":{"type":"object","properties":{"code":{"type":"string","description":"Stable Runtype validation code (e.g. MISSING_REQUIRED_FIELD, INVALID_ENUM)."},"message":{"type":"string"},"path":{"type":"string","description":"Dotted JSON path to the offending field."},"suggestion":{"type":"string","description":"Actionable hint (allowed values, accepted range, …)."}},"required":["message"],"title":"EvalQuotaExceededErrorDetailsItems"},"EvalQuotaExceededErrorStats":{"type":"object","properties":{"evalLimit":{"type":"integer","description":"Daily eval limit; -1 means unlimited."},"evalsUsed":{"type":"integer"},"isAtLimit":{"type":"boolean"},"remaining":{"type":["number","null"],"format":"double"},"resetsAt":{"type":"string","description":"ISO 8601 instant the daily count resets (midnight UTC)."}},"required":["evalLimit","evalsUsed","isAtLimit","remaining","resetsAt"],"description":"Daily eval usage at the moment of a DAILY_EVAL_LIMIT or SPEND_LIMIT_EXCEEDED refusal.","title":"EvalQuotaExceededErrorStats"},"EvalQuotaExceededError":{"type":"object","properties":{"code":{"type":"string","description":"Stable error code. DAILY_EVAL_LIMIT: the daily eval count of the plan is used up; retry after `stats.resetsAt`. SPEND_LIMIT_EXCEEDED: the monthly spend cap is reached. CLAUDE_MANAGED_AGENTS_DENIED: the account cannot evaluate a Claude Managed agent."},"details":{"type":"array","items":{"$ref":"#/components/schemas/EvalQuotaExceededErrorDetailsItems"}},"error":{"type":"string"},"requiredScopes":{"type":"array","items":{"type":"string"},"description":"On `insufficient_scope`: every API key scope this request needs."},"message":{"type":"string","description":"Human-readable reason, including the limit and when it resets."},"stats":{"$ref":"#/components/schemas/EvalQuotaExceededErrorStats","description":"Daily eval usage at the moment of a DAILY_EVAL_LIMIT or SPEND_LIMIT_EXCEEDED refusal."}},"required":["code","error","message"],"title":"EvalQuotaExceededError"},"EvalRunScoresResponseAgentTargetResolution":{"type":"string","enum":["alias","version","legacy-live-row"],"description":"How the run picked its version. Null on a run that predates release aliases.","title":"EvalRunScoresResponseAgentTargetResolution"},"EvalRunScoresResponseCasesItemsExecutionEngine":{"type":"string","enum":["runtime","legacy","external"],"description":"Engine that actually executed this graded case ('runtime' | 'legacy' | 'external'). Recorded at write time from the committed lane decision; never inferred later. 'external' marks a run a customer executed outside Runtype and reported through ingest. Null for rows written before attribution shipped and for units that never started executing.","title":"EvalRunScoresResponseCasesItemsExecutionEngine"},"EvalRunScoresResponseCasesItemsFailureKind":{"type":"string","enum":["platform_stall"],"description":"Present when the failure belongs to the platform, not the target: the model gateway went silent and the stall watchdog gave up before the target could answer. Such a case runs no graders (its outcomes are empty) and is excluded from the suite score. Absent on an ordinary failure.","title":"EvalRunScoresResponseCasesItemsFailureKind"},"EvalRunScoresResponseCasesItemsNextStepToolCallsItems":{"type":"object","properties":{"input":{"description":"The call input the model emitted (captured, never executed)."},"name":{"type":"string","description":"Tool the target intended to call."}},"required":["name"],"title":"EvalRunScoresResponseCasesItemsNextStepToolCallsItems"},"EvalRunScoresResponseCasesItemsOutcomesItemsEvidenceItemsKind":{"type":"string","enum":["message","tool_call"],"title":"EvalRunScoresResponseCasesItemsOutcomesItemsEvidenceItemsKind"},"EvalRunScoresResponseCasesItemsOutcomesItemsEvidenceItems":{"type":"object","properties":{"index":{"type":"integer","minimum":0},"kind":{"$ref":"#/components/schemas/EvalRunScoresResponseCasesItemsOutcomesItemsEvidenceItemsKind"}},"required":["index","kind"],"title":"EvalRunScoresResponseCasesItemsOutcomesItemsEvidenceItems"},"EvalRunScoresResponseCasesItemsOutcomesItemsHumanVerdict":{"type":"string","enum":["agree","disagree"],"description":"Lightweight human review of this verdict; null when unreviewed.","title":"EvalRunScoresResponseCasesItemsOutcomesItemsHumanVerdict"},"EvalRunScoresResponseCasesItemsOutcomesItemsJudgeDiagnosticsAttemptsItemsAttempt0":{"type":"string","enum":["1"],"title":"EvalRunScoresResponseCasesItemsOutcomesItemsJudgeDiagnosticsAttemptsItemsAttempt0"},"EvalRunScoresResponseCasesItemsOutcomesItemsJudgeDiagnosticsAttemptsItemsAttempt1":{"type":"string","enum":["2"],"title":"EvalRunScoresResponseCasesItemsOutcomesItemsJudgeDiagnosticsAttemptsItemsAttempt1"},"EvalRunScoresResponseCasesItemsOutcomesItemsJudgeDiagnosticsAttemptsItemsAttempt":{"oneOf":[{"$ref":"#/components/schemas/EvalRunScoresResponseCasesItemsOutcomesItemsJudgeDiagnosticsAttemptsItemsAttempt0"},{"$ref":"#/components/schemas/EvalRunScoresResponseCasesItemsOutcomesItemsJudgeDiagnosticsAttemptsItemsAttempt1"}],"title":"EvalRunScoresResponseCasesItemsOutcomesItemsJudgeDiagnosticsAttemptsItemsAttempt"},"EvalRunScoresResponseCasesItemsOutcomesItemsJudgeDiagnosticsAttemptsItemsFinishReason":{"type":"string","enum":["stop","length","content-filter","tool-calls","error","other","unknown"],"title":"EvalRunScoresResponseCasesItemsOutcomesItemsJudgeDiagnosticsAttemptsItemsFinishReason"},"EvalRunScoresResponseCasesItemsOutcomesItemsJudgeDiagnosticsAttemptsItemsModelError":{"type":"string","enum":["empty_completion","model_call_error"],"title":"EvalRunScoresResponseCasesItemsOutcomesItemsJudgeDiagnosticsAttemptsItemsModelError"},"EvalRunScoresResponseCasesItemsOutcomesItemsJudgeDiagnosticsAttemptsItemsParseError":{"type":"string","enum":["empty_completion","invalid_json","invalid_contract","missing_access_assessment","invalid_access_assessment","output_truncated"],"title":"EvalRunScoresResponseCasesItemsOutcomesItemsJudgeDiagnosticsAttemptsItemsParseError"},"EvalRunScoresResponseCasesItemsOutcomesItemsJudgeDiagnosticsAttemptsItemsStatus":{"type":"string","enum":["valid","invalid_response","model_error"],"title":"EvalRunScoresResponseCasesItemsOutcomesItemsJudgeDiagnosticsAttemptsItemsStatus"},"EvalRunScoresResponseCasesItemsOutcomesItemsJudgeDiagnosticsAttemptsItems":{"type":"object","properties":{"attempt":{"$ref":"#/components/schemas/EvalRunScoresResponseCasesItemsOutcomesItemsJudgeDiagnosticsAttemptsItemsAttempt"},"cacheReadTokens":{"type":"integer","minimum":0,"maximum":9007199254740991},"cacheWriteTokens":{"type":"integer","minimum":0,"maximum":9007199254740991},"completionTokens":{"type":"integer","minimum":0,"maximum":9007199254740991},"durationMs":{"type":"integer","minimum":0,"maximum":9007199254740991},"finishReason":{"$ref":"#/components/schemas/EvalRunScoresResponseCasesItemsOutcomesItemsJudgeDiagnosticsAttemptsItemsFinishReason"},"modelError":{"$ref":"#/components/schemas/EvalRunScoresResponseCasesItemsOutcomesItemsJudgeDiagnosticsAttemptsItemsModelError"},"parseError":{"$ref":"#/components/schemas/EvalRunScoresResponseCasesItemsOutcomesItemsJudgeDiagnosticsAttemptsItemsParseError"},"promptTokens":{"type":"integer","minimum":0,"maximum":9007199254740991},"provider":{"type":"string","maxLength":64},"reasoningTokens":{"type":"integer","minimum":0,"maximum":9007199254740991},"requestedModel":{"type":"string","maxLength":160},"resolvedModel":{"type":"string","maxLength":160},"responseChars":{"type":"integer","minimum":0,"maximum":9007199254740991},"status":{"$ref":"#/components/schemas/EvalRunScoresResponseCasesItemsOutcomesItemsJudgeDiagnosticsAttemptsItemsStatus"},"usageObserved":{"type":"boolean"}},"required":["attempt","durationMs","requestedModel","status","usageObserved"],"title":"EvalRunScoresResponseCasesItemsOutcomesItemsJudgeDiagnosticsAttemptsItems"},"EvalRunScoresResponseCasesItemsOutcomesItemsJudgeDiagnosticsFlowFailure":{"type":"string","enum":["deadline_exhausted","execution_failed","invalid_response"],"title":"EvalRunScoresResponseCasesItemsOutcomesItemsJudgeDiagnosticsFlowFailure"},"EvalRunScoresResponseCasesItemsOutcomesItemsJudgeDiagnostics":{"type":"object","properties":{"attempts":{"type":"array","items":{"$ref":"#/components/schemas/EvalRunScoresResponseCasesItemsOutcomesItemsJudgeDiagnosticsAttemptsItems"}},"flowFailure":{"$ref":"#/components/schemas/EvalRunScoresResponseCasesItemsOutcomesItemsJudgeDiagnosticsFlowFailure"}},"required":["attempts"],"title":"EvalRunScoresResponseCasesItemsOutcomesItemsJudgeDiagnostics"},"EvalRunScoresResponseCasesItemsOutcomesItemsSeverity":{"type":"string","enum":["gate","soft"],"description":"Grader severity. A soft miss is reported but only fails the suite under strict mode. Absent ⇒ gate.","title":"EvalRunScoresResponseCasesItemsOutcomesItemsSeverity"},"EvalRunScoresResponseCasesItemsOutcomesItemsVerdict":{"type":"string","enum":["pass","fail","insufficient_evidence"],"description":"AI graders only: the judge's binary verdict. insufficient_evidence means the judge declined to guess; it renders as a warning and never fails the case.","title":"EvalRunScoresResponseCasesItemsOutcomesItemsVerdict"},"EvalRunScoresResponseCasesItemsOutcomesItems":{"type":"object","properties":{"evidence":{"type":"array","items":{"$ref":"#/components/schemas/EvalRunScoresResponseCasesItemsOutcomesItemsEvidenceItems"},"description":"AI graders only: transcript entries the verdict rests on — indices into the run's trace steps (message) or tool calls (tool_call)."},"graderIndex":{"type":"integer"},"humanVerdict":{"$ref":"#/components/schemas/EvalRunScoresResponseCasesItemsOutcomesItemsHumanVerdict","description":"Lightweight human review of this verdict; null when unreviewed."},"judgeDiagnostics":{"$ref":"#/components/schemas/EvalRunScoresResponseCasesItemsOutcomesItemsJudgeDiagnostics"},"kind":{"type":"string"},"passed":{"type":"boolean"},"reasoning":{"type":"string"},"score":{"type":"number","format":"double"},"scoreId":{"type":"string","description":"The persisted eval_case_scores row id (the review handle)."},"severity":{"$ref":"#/components/schemas/EvalRunScoresResponseCasesItemsOutcomesItemsSeverity","description":"Grader severity. A soft miss is reported but only fails the suite under strict mode. Absent ⇒ gate."},"verdict":{"$ref":"#/components/schemas/EvalRunScoresResponseCasesItemsOutcomesItemsVerdict","description":"AI graders only: the judge's binary verdict. insufficient_evidence means the judge declined to guess; it renders as a warning and never fails the case."}},"required":["graderIndex","humanVerdict","kind","passed","scoreId"],"title":"EvalRunScoresResponseCasesItemsOutcomesItems"},"EvalRunScoresResponseCasesItems":{"type":"object","properties":{"caseId":{"type":["string","null"],"description":"The saved eval case id; null when the case row was deleted or the record could not be mapped to a case."},"error":{"type":["string","null"],"description":"Why the case errored (the provider or execution failure text, 2000 chars max); null when the case did not error or the run predates this field."},"executionEngine":{"$ref":"#/components/schemas/EvalRunScoresResponseCasesItemsExecutionEngine","description":"Engine that actually executed this graded case ('runtime' | 'legacy' | 'external'). Recorded at write time from the committed lane decision; never inferred later. 'external' marks a run a customer executed outside Runtype and reported through ingest. Null for rows written before attribution shipped and for units that never started executing."},"failureKind":{"$ref":"#/components/schemas/EvalRunScoresResponseCasesItemsFailureKind","description":"Present when the failure belongs to the platform, not the target: the model gateway went silent and the stall watchdog gave up before the target could answer. Such a case runs no graders (its outcomes are empty) and is excluded from the suite score. Absent on an ordinary failure."},"name":{"type":"string"},"nextStepToolCalls":{"type":["array","null"],"items":{"$ref":"#/components/schemas/EvalRunScoresResponseCasesItemsNextStepToolCallsItems"},"description":"For a checkpoint (\"saved from run\") case run in next-step mode: the tool-call intent(s) the target emitted as its graded next step. An empty array means it replied with a message instead of calling a tool. Null for ordinary runs and for runs recorded before this field shipped."},"outcomes":{"type":"array","items":{"$ref":"#/components/schemas/EvalRunScoresResponseCasesItemsOutcomesItems"}},"outputExcerpt":{"type":"string","description":"Truncated snapshot of the output that was graded (2000 chars max)."},"passed":{"type":"boolean","description":"Recomputed from the persisted outcomes using the run's recorded strict mode, so historical verdicts match what the run originally reported."}},"required":["caseId","error","name","nextStepToolCalls","outcomes","outputExcerpt","passed"],"title":"EvalRunScoresResponseCasesItems"},"EvalRunScoresResponse":{"type":"object","properties":{"agentTargetAlias":{"type":["string","null"],"description":"The release alias the run resolved through, when it resolved through one."},"agentTargetResolution":{"$ref":"#/components/schemas/EvalRunScoresResponseAgentTargetResolution","description":"How the run picked its version. Null on a run that predates release aliases."},"agentVersionId":{"type":["string","null"],"description":"The exact Agent version every case of this run executed. Null for a legacy run."},"caseManifestHash":{"type":["string","null"],"description":"SHA-256 over the ordered, normalized case set this run executed."},"cases":{"type":"array","items":{"$ref":"#/components/schemas/EvalRunScoresResponseCasesItems"}},"evaluatorFingerprint":{"type":["string","null"],"description":"SHA-256 over the evaluator configuration this run scored with."},"name":{"type":["string","null"],"description":"The eval name recorded on the run."},"passedCases":{"type":"integer"},"platformAbortedCases":{"type":"integer","description":"Cases the platform aborted before the target could answer. They run no graders and are counted in neither half of score, so totalCases minus this is the denominator score was taken over."},"runId":{"type":"string","description":"The run (batch execution) id these scores belong to."},"score":{"type":["number","null"],"format":"double","description":"Suite score, 0..1 (passed cases / graded cases). Platform-aborted cases are excluded from both halves; null when the run graded no cases."},"strict":{"type":"boolean","description":"The severity semantics the run was graded with (and that these verdicts reproduce): true when a soft grader miss failed its case."},"suiteId":{"type":["string","null"],"description":"The eval suite the run executed; null when the suite was since deleted."},"totalCases":{"type":"integer"}},"required":["cases","name","passedCases","platformAbortedCases","runId","score","strict","suiteId","totalCases"],"title":"EvalRunScoresResponse"},"V1EvalScoresScoreIdReviewPostRequestBodyContentApplicationJsonSchemaVerdict":{"type":"string","enum":["agree","disagree"],"description":"Did the grader get this one right? \"agree\" / \"disagree\"; null clears an earlier review.","title":"V1EvalScoresScoreIdReviewPostRequestBodyContentApplicationJsonSchemaVerdict"},"EvalScoreReviewedHumanVerdict":{"type":"string","enum":["agree","disagree"],"title":"EvalScoreReviewedHumanVerdict"},"EvalScoreReviewed":{"type":"object","properties":{"humanVerdict":{"$ref":"#/components/schemas/EvalScoreReviewedHumanVerdict"},"scoreId":{"type":"string"}},"required":["humanVerdict","scoreId"],"title":"EvalScoreReviewed"},"EvalOverridesAdvisor":{"type":"object","properties":{"model":{"type":"string"},"systemPrompt":{"type":"string"}},"required":["model"],"description":"Advisor override for agent capabilities. `null` disables the advisor; omitting it leaves the target’s own config alone.","title":"EvalOverridesAdvisor"},"EvalStepOverrideValuesResponseFormat":{"type":"string","enum":["default","json","markdown","html","xml"],"title":"EvalStepOverrideValuesResponseFormat"},"EvalStepOverrideValues":{"type":"object","properties":{"frequencyPenalty":{"type":"number","format":"double"},"maxTokens":{"type":"integer"},"model":{"type":"string"},"presencePenalty":{"type":"number","format":"double"},"reasoning":{"description":"Any type"},"responseFormat":{"$ref":"#/components/schemas/EvalStepOverrideValuesResponseFormat"},"seed":{"type":"number","format":"double"},"temperature":{"type":"number","format":"double"},"tools":{"description":"Any type"},"topK":{"type":"number","format":"double"},"topP":{"type":"number","format":"double"}},"description":"Applies to every prompt step of the agent under test. Valid only on an agent target; sending it on a flow target is a 400.","title":"EvalStepOverrideValues"},"EvalOverridesClaudeManaged":{"type":"object","properties":{"model":{"type":"string"},"systemPrompt":{"type":"string"},"toolPermissions":{"type":"object","additionalProperties":{"type":"boolean"}}},"description":"Claude Managed variant override. Valid only on a claude_managed agent target; rejected on a standard agent rather than silently ignored.","title":"EvalOverridesClaudeManaged"},"EvalOverridesFlowResponseFormat":{"type":"string","enum":["default","json","markdown","html","xml"],"title":"EvalOverridesFlowResponseFormat"},"EvalOverridesFlow":{"type":"object","properties":{"frequencyPenalty":{"type":"number","format":"double"},"maxTokens":{"type":"integer"},"model":{"type":"string"},"presencePenalty":{"type":"number","format":"double"},"reasoning":{"description":"Any type"},"responseFormat":{"$ref":"#/components/schemas/EvalOverridesFlowResponseFormat"},"seed":{"type":"number","format":"double"},"temperature":{"type":"number","format":"double"},"tools":{"description":"Any type"},"topK":{"type":"number","format":"double"},"topP":{"type":"number","format":"double"}},"description":"Applies to every prompt step of the flow under test. Valid only on a flow target; sending it on an agent target is a 400.","title":"EvalOverridesFlow"},"EvalOverridesStepsResponseFormat":{"type":"string","enum":["default","json","markdown","html","xml"],"title":"EvalOverridesStepsResponseFormat"},"EvalOverridesSteps":{"type":"object","properties":{"frequencyPenalty":{"type":"number","format":"double"},"maxTokens":{"type":"integer"},"model":{"type":"string"},"presencePenalty":{"type":"number","format":"double"},"reasoning":{"description":"Any type"},"responseFormat":{"$ref":"#/components/schemas/EvalOverridesStepsResponseFormat"},"seed":{"type":"number","format":"double"},"temperature":{"type":"number","format":"double"},"tools":{"description":"Any type"},"topK":{"type":"number","format":"double"},"topP":{"type":"number","format":"double"}},"description":"Sampling/model/tool values applied to one override target. Unset fields inherit; a field set here beats the same field on a broader target.","title":"EvalOverridesSteps"},"EvalOverridesSubagentDefaultsResponseFormat":{"type":"string","enum":["default","json","markdown","html","xml"],"title":"EvalOverridesSubagentDefaultsResponseFormat"},"EvalOverridesSubagentDefaults":{"type":"object","properties":{"frequencyPenalty":{"type":"number","format":"double"},"maxTokens":{"type":"integer"},"model":{"type":"string"},"presencePenalty":{"type":"number","format":"double"},"reasoning":{"description":"Any type"},"responseFormat":{"$ref":"#/components/schemas/EvalOverridesSubagentDefaultsResponseFormat"},"seed":{"type":"number","format":"double"},"temperature":{"type":"number","format":"double"},"tools":{"description":"Any type"},"topK":{"type":"number","format":"double"},"topP":{"type":"number","format":"double"}},"description":"Applies to every reachable sub-agent with no `subagents` entry of its own. Does not apply to a dynamically-spawned child, which keeps the model its spawn resolved.","title":"EvalOverridesSubagentDefaults"},"EvalOverridesSubagentsResponseFormat":{"type":"string","enum":["default","json","markdown","html","xml"],"title":"EvalOverridesSubagentsResponseFormat"},"EvalOverridesSubagents":{"type":"object","properties":{"frequencyPenalty":{"type":"number","format":"double"},"maxTokens":{"type":"integer"},"model":{"type":"string"},"presencePenalty":{"type":"number","format":"double"},"reasoning":{"description":"Any type"},"responseFormat":{"$ref":"#/components/schemas/EvalOverridesSubagentsResponseFormat"},"seed":{"type":"number","format":"double"},"temperature":{"type":"number","format":"double"},"tools":{"description":"Any type"},"topK":{"type":"number","format":"double"},"topP":{"type":"number","format":"double"}},"description":"Sampling/model/tool values applied to one override target. Unset fields inherit; a field set here beats the same field on a broader target.","title":"EvalOverridesSubagents"},"EvalOverrides":{"type":"object","properties":{"advisor":{"oneOf":[{"$ref":"#/components/schemas/EvalOverridesAdvisor"},{"type":"null"}],"description":"Advisor override for agent capabilities. `null` disables the advisor; omitting it leaves the target’s own config alone."},"agent":{"$ref":"#/components/schemas/EvalStepOverrideValues"},"claudeManaged":{"$ref":"#/components/schemas/EvalOverridesClaudeManaged","description":"Claude Managed variant override. Valid only on a claude_managed agent target; rejected on a standard agent rather than silently ignored."},"flow":{"$ref":"#/components/schemas/EvalOverridesFlow","description":"Applies to every prompt step of the flow under test. Valid only on a flow target; sending it on an agent target is a 400."},"steps":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/EvalOverridesSteps"},"description":"Per-step overrides keyed by step id. Beats agent/flow field by field. A key naming no step of the target is a 400 rather than a silently-scored no-op."},"subagentDefaults":{"$ref":"#/components/schemas/EvalOverridesSubagentDefaults","description":"Applies to every reachable sub-agent with no `subagents` entry of its own. Does not apply to a dynamically-spawned child, which keeps the model its spawn resolved."},"subagents":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/EvalOverridesSubagents"},"description":"Per-sub-agent overrides keyed by agentId. The key is an identity, not a position: an entry applies wherever that agent runs, at any depth. A key naming an agent this target cannot reach is a 400."}},"description":"Canonical eval override field. Replaces `stepOverrides` (and its `\"*\"` key), `claudeManagedOverride` and `advisorOverride`; setting both spellings of one channel is a 400.","title":"EvalOverrides"},"EvalConfigRequest":{"type":"object","properties":{"evalConfigId":{"type":"string"},"evalName":{"type":"string"},"overrides":{"$ref":"#/components/schemas/EvalOverrides"}},"title":"EvalConfigRequest"},"V1EvalSubmitPostRequestBodyContentApplicationJsonSchemaAgent":{"type":"object","properties":{"alias":{"type":"string","minLength":1,"maxLength":63,"description":"Run whichever version this release alias currently points at. Resolved once for the whole run."},"versionId":{"type":"string","minLength":1,"description":"Run this exact immutable version snapshot."}},"description":"Version selector for an agentId target. Supply at most one of alias or versionId; the run resolves it once and every case executes that version.","title":"V1EvalSubmitPostRequestBodyContentApplicationJsonSchemaAgent"},"V1EvalSubmitPostResponsesContentApplicationJsonSchemaOneOf0SubmissionsItems":{"type":"object","properties":{"batchExecutionId":{"type":"string"},"evalName":{"type":"string"},"status":{"type":"string"}},"required":["batchExecutionId","status"],"title":"V1EvalSubmitPostResponsesContentApplicationJsonSchemaOneOf0SubmissionsItems"},"EvalsSubmitEvalResponse2000":{"type":"object","properties":{"evalGroupId":{"type":"string"},"submissions":{"type":"array","items":{"$ref":"#/components/schemas/V1EvalSubmitPostResponsesContentApplicationJsonSchemaOneOf0SubmissionsItems"}},"totalEvals":{"type":"integer"}},"required":["evalGroupId","submissions","totalEvals"],"title":"EvalsSubmitEvalResponse2000"},"EvalsSubmitEvalResponse2001":{"type":"object","properties":{"batchExecutionId":{"type":"string"},"status":{"type":"string"}},"required":["batchExecutionId","status"],"title":"EvalsSubmitEvalResponse2001"},"Evals_submitEval_Response_200":{"oneOf":[{"$ref":"#/components/schemas/EvalsSubmitEvalResponse2000"},{"$ref":"#/components/schemas/EvalsSubmitEvalResponse2001"}],"description":"Eval-group submission (when evalConfigs[] supplied) or a single batch submission.","title":"Evals_submitEval_Response_200"},"EvalLaneRefusalErrorCode":{"type":"string","enum":["RUNTIME_LANE_INELIGIBLE"],"description":"The flow uses capabilities the batch host cannot run.","title":"EvalLaneRefusalErrorCode"},"EvalLaneRefusalErrorDetailsItems":{"type":"object","properties":{"code":{"type":"string","description":"Stable Runtype validation code (e.g. MISSING_REQUIRED_FIELD, INVALID_ENUM)."},"message":{"type":"string"},"path":{"type":"string","description":"Dotted JSON path to the offending field."},"suggestion":{"type":"string","description":"Actionable hint (allowed values, accepted range, …)."}},"required":["message"],"title":"EvalLaneRefusalErrorDetailsItems"},"EvalLaneRefusalError":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/EvalLaneRefusalErrorCode","description":"The flow uses capabilities the batch host cannot run."},"details":{"type":"array","items":{"$ref":"#/components/schemas/EvalLaneRefusalErrorDetailsItems"}},"error":{"type":"string"},"requiredScopes":{"type":"array","items":{"type":"string"},"description":"On `insufficient_scope`: every API key scope this request needs."},"reasons":{"type":"array","items":{"type":"string"},"description":"Stable reason codes: `ineligible:*` capabilities (e.g. `ineligible:wait-until`), or `eval-override:*` for an eval override the batch host cannot apply."},"evalConfigId":{"type":"string","description":"`evalConfigId` of the refused configuration (product surface batch evals)."},"evalConfigIndex":{"type":"integer","description":"Index into `evalConfigs` of the refused configuration (multi-config submissions)."}},"required":["code","error","reasons"],"title":"EvalLaneRefusalError"},"SubmitEvalRequestUnprocessableEntityError":{"oneOf":[{"$ref":"#/components/schemas/EvalLaneRefusalError"},{"$ref":"#/components/schemas/Error"}],"title":"SubmitEvalRequestUnprocessableEntityError"},"EvalSuiteSummaryIdentityDefaultsEndUser":{"type":"object","properties":{"email":{"type":"string"},"id":{"type":"string","minLength":1}},"required":["id"],"description":"The end user (the person) the turn runs as. Exposed to tools as _endUser.*, drives memory-profile sharding, and satisfies an end-user-isolated tenancyStrategy. Distinct from _user (the Builder User).","title":"EvalSuiteSummaryIdentityDefaultsEndUser"},"EvalSuiteSummaryIdentityDefaultsTenant":{"type":"object","properties":{"id":{"type":"string","minLength":1}},"required":["id"],"description":"The product tenant (a customer of your product, under your Builder Org) the turn runs within. Exposed to tools as _tenant.*.","title":"EvalSuiteSummaryIdentityDefaultsTenant"},"EvalSuiteSummaryIdentityDefaults":{"type":"object","properties":{"endUser":{"$ref":"#/components/schemas/EvalSuiteSummaryIdentityDefaultsEndUser","description":"The end user (the person) the turn runs as. Exposed to tools as _endUser.*, drives memory-profile sharding, and satisfies an end-user-isolated tenancyStrategy. Distinct from _user (the Builder User)."},"tenant":{"$ref":"#/components/schemas/EvalSuiteSummaryIdentityDefaultsTenant","description":"The product tenant (a customer of your product, under your Builder Org) the turn runs within. Exposed to tools as _tenant.*."}},"description":"Default identity (endUser / tenant) cases run as unless they set their own; null when unset.","title":"EvalSuiteSummaryIdentityDefaults"},"EvalSuiteLatestRun":{"type":"object","properties":{"completedAt":{"type":["string","null"]},"passedCases":{"type":["integer","null"]},"platformAbortedCases":{"type":["integer","null"],"description":"Cases the platform aborted before the target could answer. They run no graders and are counted in neither half of score, so totalCases minus this is the denominator score was taken over."},"runId":{"type":"string"},"score":{"type":["number","null"],"format":"double","description":"Suite score of the run, 0..1; null while unscored (in flight / unscoreable)."},"startedAt":{"type":"string"},"status":{"type":"string"},"totalCases":{"type":["integer","null"]}},"required":["completedAt","passedCases","platformAbortedCases","runId","score","startedAt","status","totalCases"],"title":"EvalSuiteLatestRun"},"EvalSuiteSummaryRecordedToolMode":{"type":"string","enum":["next_step","continue"],"description":"How captured cases replay: \"next_step\" (default when null) or \"continue\".","title":"EvalSuiteSummaryRecordedToolMode"},"EvalSuiteSummaryRecordedToolUnmatchedPolicy":{"type":"string","enum":["fail","stub"],"description":"Unmatched-call policy for \"continue\"-mode replays: \"fail\" (default when null) or \"stub\".","title":"EvalSuiteSummaryRecordedToolUnmatchedPolicy"},"EvalSuiteSummaryTargetType":{"type":"string","enum":["flow","agent"],"title":"EvalSuiteSummaryTargetType"},"EvalSuiteSummaryWarningsItems":{"type":"object","properties":{"agentId":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"],"title":"EvalSuiteSummaryWarningsItems"},"EvalSuiteSummary":{"type":"object","properties":{"agentId":{"type":["string","null"]},"baselineBatchExecutionId":{"type":["string","null"]},"caseCount":{"type":"integer"},"createdAt":{"type":"string"},"description":{"type":["string","null"]},"enabledCaseCount":{"type":"integer"},"flowId":{"type":["string","null"]},"graders":{"type":"array","items":{"description":"Any type"},"description":"Ordered GraderConfig[] applied to every case."},"id":{"type":"string"},"identityDefaults":{"oneOf":[{"$ref":"#/components/schemas/EvalSuiteSummaryIdentityDefaults"},{"type":"null"}],"description":"Default identity (endUser / tenant) cases run as unless they set their own; null when unset."},"isDefault":{"type":"boolean"},"lastModifiedSource":{"type":["string","null"],"description":"Provenance of the last Definition write. 'sdk' / 'terraform' mean the suite is managed in code (converged by ensure on deploy)."},"latestRun":{"$ref":"#/components/schemas/EvalSuiteLatestRun"},"name":{"type":"string"},"recordedToolMode":{"$ref":"#/components/schemas/EvalSuiteSummaryRecordedToolMode","description":"How captured cases replay: \"next_step\" (default when null) or \"continue\"."},"recordedToolUnmatchedPolicy":{"$ref":"#/components/schemas/EvalSuiteSummaryRecordedToolUnmatchedPolicy","description":"Unmatched-call policy for \"continue\"-mode replays: \"fail\" (default when null) or \"stub\"."},"targetName":{"type":["string","null"],"description":"Display name of the target flow/agent; null when the target row is gone."},"targetType":{"$ref":"#/components/schemas/EvalSuiteSummaryTargetType"},"updatedAt":{"type":"string"},"warnings":{"type":"array","items":{"$ref":"#/components/schemas/EvalSuiteSummaryWarningsItems"},"description":"Non-blocking findings about this suite. `AGENT_NOT_DEPLOYED` means the target agent has no runnable `live` version, so a run that names no version selector refuses once the live default is on for the organization."}},"required":["agentId","baselineBatchExecutionId","caseCount","createdAt","description","enabledCaseCount","flowId","graders","id","identityDefaults","isDefault","lastModifiedSource","latestRun","name","recordedToolMode","recordedToolUnmatchedPolicy","targetName","targetType","updatedAt"],"title":"EvalSuiteSummary"},"EvalSuiteListResponse":{"type":"object","properties":{"count":{"type":"integer","description":"Number of suites in this page."},"limit":{"type":"integer"},"offset":{"type":"integer"},"suites":{"type":"array","items":{"$ref":"#/components/schemas/EvalSuiteSummary"}},"total":{"type":"integer","description":"Total suites matching the filter across all pages (for offset pagination)."}},"required":["count","limit","offset","suites","total"],"title":"EvalSuiteListResponse"},"V1EvalSuitesPostRequestBodyContentApplicationJsonSchemaCasesItemsExpected":{"type":"object","properties":{"facts":{"type":"array","items":{"type":"string"}},"json":{"description":"Any type"},"text":{"type":"string"}},"title":"V1EvalSuitesPostRequestBodyContentApplicationJsonSchemaCasesItemsExpected"},"V1EvalSuitesPostRequestBodyContentApplicationJsonSchemaCasesItemsGradersItems":{"type":"object","properties":{"kind":{"type":"string","minLength":1}},"required":["kind"],"title":"V1EvalSuitesPostRequestBodyContentApplicationJsonSchemaCasesItemsGradersItems"},"V1EvalSuitesPostRequestBodyContentApplicationJsonSchemaCasesItemsInputCheckpoint":{"type":"object","properties":{"forkMessageIndex":{"type":"integer","minimum":0},"sourceConversationId":{"type":"string"},"sourceExecutionId":{"type":"string"}},"required":["forkMessageIndex"],"title":"V1EvalSuitesPostRequestBodyContentApplicationJsonSchemaCasesItemsInputCheckpoint"},"V1EvalSuitesPostRequestBodyContentApplicationJsonSchemaCasesItemsInputEndUser":{"type":"object","properties":{"email":{"type":"string"},"id":{"type":"string","minLength":1}},"required":["id"],"description":"End user this case runs as (exposed to tools as _endUser.*, used to mint {{_identity.token}}). Overrides the suite identityDefaults.endUser. Required (or a suite default) when the agent sets config.tenancyStrategy.","title":"V1EvalSuitesPostRequestBodyContentApplicationJsonSchemaCasesItemsInputEndUser"},"V1EvalSuitesPostRequestBodyContentApplicationJsonSchemaCasesItemsInputMessagesItemsToolCallsItems":{"type":"object","properties":{"args":{"description":"Any type"},"toolCallId":{"type":"string"},"toolName":{"type":"string"}},"required":["toolCallId","toolName"],"title":"V1EvalSuitesPostRequestBodyContentApplicationJsonSchemaCasesItemsInputMessagesItemsToolCallsItems"},"V1EvalSuitesPostRequestBodyContentApplicationJsonSchemaCasesItemsInputMessagesItemsToolResultsItems":{"type":"object","properties":{"result":{"description":"Any type"},"toolCallId":{"type":"string"},"toolName":{"type":"string"}},"required":["toolCallId","toolName"],"title":"V1EvalSuitesPostRequestBodyContentApplicationJsonSchemaCasesItemsInputMessagesItemsToolResultsItems"},"V1EvalSuitesPostRequestBodyContentApplicationJsonSchemaCasesItemsInputMessagesItems":{"type":"object","properties":{"content":{"type":"string"},"role":{"type":"string","minLength":1},"toolCalls":{"type":"array","items":{"$ref":"#/components/schemas/V1EvalSuitesPostRequestBodyContentApplicationJsonSchemaCasesItemsInputMessagesItemsToolCallsItems"}},"toolResults":{"type":"array","items":{"$ref":"#/components/schemas/V1EvalSuitesPostRequestBodyContentApplicationJsonSchemaCasesItemsInputMessagesItemsToolResultsItems"}}},"required":["content","role"],"title":"V1EvalSuitesPostRequestBodyContentApplicationJsonSchemaCasesItemsInputMessagesItems"},"V1EvalSuitesPostRequestBodyContentApplicationJsonSchemaCasesItemsInputRecord":{"type":"object","properties":{"metadata":{"type":"object","additionalProperties":{"description":"Any type"}},"name":{"type":"string","minLength":1},"type":{"type":"string","minLength":1}},"description":"The record this case runs on, read by the flow as _record.name, _record.type and _record.metadata.*. Omitted fields keep the defaults: a record of type \"eval\" with empty metadata. Case variables still override same-named metadata fields at the top level.","title":"V1EvalSuitesPostRequestBodyContentApplicationJsonSchemaCasesItemsInputRecord"},"V1EvalSuitesPostRequestBodyContentApplicationJsonSchemaCasesItemsInputTenant":{"type":"object","properties":{"id":{"type":"string","minLength":1}},"required":["id"],"description":"Product tenant this case runs within (exposed as _tenant.*). Overrides the suite identityDefaults.tenant.","title":"V1EvalSuitesPostRequestBodyContentApplicationJsonSchemaCasesItemsInputTenant"},"V1EvalSuitesPostRequestBodyContentApplicationJsonSchemaCasesItemsInputToolMocksItemsOutput":{"oneOf":[{"type":"boolean"},{"type":"number","format":"double"},{"type":"string"},{"type":"array","items":{"description":"Any type"}},{"type":"object","additionalProperties":{"description":"Any type"}}],"title":"V1EvalSuitesPostRequestBodyContentApplicationJsonSchemaCasesItemsInputToolMocksItemsOutput"},"V1EvalSuitesPostRequestBodyContentApplicationJsonSchemaCasesItemsInputToolMocksItems":{"type":"object","properties":{"input":{"description":"Any type"},"isError":{"type":"boolean"},"output":{"oneOf":[{"$ref":"#/components/schemas/V1EvalSuitesPostRequestBodyContentApplicationJsonSchemaCasesItemsInputToolMocksItemsOutput"},{"type":"null"}]},"sourceToolExecutionId":{"type":"string"},"toolName":{"type":"string","minLength":1},"truncated":{"type":"boolean"}},"required":["output","toolName"],"title":"V1EvalSuitesPostRequestBodyContentApplicationJsonSchemaCasesItemsInputToolMocksItems"},"V1EvalSuitesPostRequestBodyContentApplicationJsonSchemaCasesItemsInput":{"type":"object","properties":{"checkpoint":{"$ref":"#/components/schemas/V1EvalSuitesPostRequestBodyContentApplicationJsonSchemaCasesItemsInputCheckpoint"},"endUser":{"$ref":"#/components/schemas/V1EvalSuitesPostRequestBodyContentApplicationJsonSchemaCasesItemsInputEndUser","description":"End user this case runs as (exposed to tools as _endUser.*, used to mint {{_identity.token}}). Overrides the suite identityDefaults.endUser. Required (or a suite default) when the agent sets config.tenancyStrategy."},"messages":{"type":"array","items":{"$ref":"#/components/schemas/V1EvalSuitesPostRequestBodyContentApplicationJsonSchemaCasesItemsInputMessagesItems"}},"record":{"$ref":"#/components/schemas/V1EvalSuitesPostRequestBodyContentApplicationJsonSchemaCasesItemsInputRecord","description":"The record this case runs on, read by the flow as _record.name, _record.type and _record.metadata.*. Omitted fields keep the defaults: a record of type \"eval\" with empty metadata. Case variables still override same-named metadata fields at the top level."},"tenant":{"$ref":"#/components/schemas/V1EvalSuitesPostRequestBodyContentApplicationJsonSchemaCasesItemsInputTenant","description":"Product tenant this case runs within (exposed as _tenant.*). Overrides the suite identityDefaults.tenant."},"toolMocks":{"type":"array","items":{"$ref":"#/components/schemas/V1EvalSuitesPostRequestBodyContentApplicationJsonSchemaCasesItemsInputToolMocksItems"}},"variables":{"type":"object","additionalProperties":{"description":"Any type"}}},"title":"V1EvalSuitesPostRequestBodyContentApplicationJsonSchemaCasesItemsInput"},"V1EvalSuitesPostRequestBodyContentApplicationJsonSchemaCasesItemsOrigin":{"type":"string","enum":["manual","saved_from_run","generated","imported","fpo"],"description":"Case provenance. Defaults to \"manual\" when omitted. \"ensure\" is reserved for config-as-code converges.","title":"V1EvalSuitesPostRequestBodyContentApplicationJsonSchemaCasesItemsOrigin"},"V1EvalSuitesPostRequestBodyContentApplicationJsonSchemaCasesItems":{"type":"object","properties":{"enabled":{"type":"boolean"},"expected":{"$ref":"#/components/schemas/V1EvalSuitesPostRequestBodyContentApplicationJsonSchemaCasesItemsExpected"},"graders":{"type":"array","items":{"$ref":"#/components/schemas/V1EvalSuitesPostRequestBodyContentApplicationJsonSchemaCasesItemsGradersItems"},"description":"Per-case graders. When set, they REPLACE the suite-level graders for this case (not appended). Omit to score the case with the suite graders."},"input":{"$ref":"#/components/schemas/V1EvalSuitesPostRequestBodyContentApplicationJsonSchemaCasesItemsInput","default":{}},"name":{"type":"string","minLength":1},"notes":{"type":"string"},"origin":{"$ref":"#/components/schemas/V1EvalSuitesPostRequestBodyContentApplicationJsonSchemaCasesItemsOrigin","description":"Case provenance. Defaults to \"manual\" when omitted. \"ensure\" is reserved for config-as-code converges."}},"required":["name"],"title":"V1EvalSuitesPostRequestBodyContentApplicationJsonSchemaCasesItems"},"V1EvalSuitesPostRequestBodyContentApplicationJsonSchemaGradersItems":{"type":"object","properties":{"kind":{"type":"string","minLength":1}},"required":["kind"],"title":"V1EvalSuitesPostRequestBodyContentApplicationJsonSchemaGradersItems"},"V1EvalSuitesPostRequestBodyContentApplicationJsonSchemaIdentityDefaultsEndUser":{"type":"object","properties":{"email":{"type":"string"},"id":{"type":"string","minLength":1}},"required":["id"],"description":"The end user (the person) the turn runs as. Exposed to tools as _endUser.*, drives memory-profile sharding, and satisfies an end-user-isolated tenancyStrategy. Distinct from _user (the Builder User).","title":"V1EvalSuitesPostRequestBodyContentApplicationJsonSchemaIdentityDefaultsEndUser"},"V1EvalSuitesPostRequestBodyContentApplicationJsonSchemaIdentityDefaultsTenant":{"type":"object","properties":{"id":{"type":"string","minLength":1}},"required":["id"],"description":"The product tenant (a customer of your product, under your Builder Org) the turn runs within. Exposed to tools as _tenant.*.","title":"V1EvalSuitesPostRequestBodyContentApplicationJsonSchemaIdentityDefaultsTenant"},"V1EvalSuitesPostRequestBodyContentApplicationJsonSchemaIdentityDefaults":{"type":"object","properties":{"endUser":{"$ref":"#/components/schemas/V1EvalSuitesPostRequestBodyContentApplicationJsonSchemaIdentityDefaultsEndUser","description":"The end user (the person) the turn runs as. Exposed to tools as _endUser.*, drives memory-profile sharding, and satisfies an end-user-isolated tenancyStrategy. Distinct from _user (the Builder User)."},"tenant":{"$ref":"#/components/schemas/V1EvalSuitesPostRequestBodyContentApplicationJsonSchemaIdentityDefaultsTenant","description":"The product tenant (a customer of your product, under your Builder Org) the turn runs within. Exposed to tools as _tenant.*."}},"description":"Default identity (endUser / tenant) every case runs as unless the case sets its own. Required (or per-case identity) when the agent sets config.tenancyStrategy. No credentials: the identity is asserted by the suite author.","title":"V1EvalSuitesPostRequestBodyContentApplicationJsonSchemaIdentityDefaults"},"V1EvalSuitesPostRequestBodyContentApplicationJsonSchemaRecordedToolMode":{"type":"string","enum":["next_step","continue"],"description":"How captured (saved_from_run) cases replay. \"next_step\" (default) captures the first tool intent and stops; \"continue\" serves recorded toolMocks and runs past the first action.","title":"V1EvalSuitesPostRequestBodyContentApplicationJsonSchemaRecordedToolMode"},"V1EvalSuitesPostRequestBodyContentApplicationJsonSchemaRecordedToolUnmatchedPolicy":{"type":"string","enum":["fail","stub"],"description":"For \"continue\"-mode replays, what to do when a tool call has no matching mock: \"fail\" (default, divergence is the signal) or \"stub\" (canned success so the run keeps going). A replay never reaches the real tool.","title":"V1EvalSuitesPostRequestBodyContentApplicationJsonSchemaRecordedToolUnmatchedPolicy"},"EvalCase":{"type":"object","properties":{"createdAt":{"type":"string"},"enabled":{"type":"boolean"},"expected":{"description":"Any type"},"graders":{"type":["array","null"],"items":{"description":"Any type"},"description":"Per-case graders that REPLACE the suite graders for this case, or null when the case uses the suite graders."},"id":{"type":"string"},"input":{"description":"{ variables?, messages?, toolMocks?, endUser?, tenant?, record? } — what the case feeds the target, the identity it runs as, and the record it runs on."},"name":{"type":"string"},"notes":{"type":["string","null"]},"origin":{"type":"string"},"suiteId":{"type":"string"},"updatedAt":{"type":"string"}},"required":["createdAt","enabled","graders","id","name","notes","origin","suiteId","updatedAt"],"title":"EvalCase"},"EvalSuiteDetailIdentityDefaultsEndUser":{"type":"object","properties":{"email":{"type":"string"},"id":{"type":"string","minLength":1}},"required":["id"],"description":"The end user (the person) the turn runs as. Exposed to tools as _endUser.*, drives memory-profile sharding, and satisfies an end-user-isolated tenancyStrategy. Distinct from _user (the Builder User).","title":"EvalSuiteDetailIdentityDefaultsEndUser"},"EvalSuiteDetailIdentityDefaultsTenant":{"type":"object","properties":{"id":{"type":"string","minLength":1}},"required":["id"],"description":"The product tenant (a customer of your product, under your Builder Org) the turn runs within. Exposed to tools as _tenant.*.","title":"EvalSuiteDetailIdentityDefaultsTenant"},"EvalSuiteDetailIdentityDefaults":{"type":"object","properties":{"endUser":{"$ref":"#/components/schemas/EvalSuiteDetailIdentityDefaultsEndUser","description":"The end user (the person) the turn runs as. Exposed to tools as _endUser.*, drives memory-profile sharding, and satisfies an end-user-isolated tenancyStrategy. Distinct from _user (the Builder User)."},"tenant":{"$ref":"#/components/schemas/EvalSuiteDetailIdentityDefaultsTenant","description":"The product tenant (a customer of your product, under your Builder Org) the turn runs within. Exposed to tools as _tenant.*."}},"description":"Default identity (endUser / tenant) cases run as unless they set their own; null when unset.","title":"EvalSuiteDetailIdentityDefaults"},"EvalSuiteDetailJudgeAgreement":{"type":"object","properties":{"agree":{"type":"integer","description":"Reviewed AI-grader verdicts the human agreed with."},"total":{"type":"integer","description":"All reviewed AI-grader verdicts across the suite's runs."}},"required":["agree","total"],"description":"The judge-trust corpus (E6 calibration): how often the AI grader agrees with your reviews, surfaced as a plain fraction. Null until at least one verdict has been reviewed (POST /eval/scores/{scoreId}/review).","title":"EvalSuiteDetailJudgeAgreement"},"EvalSuiteDetailRecordedToolMode":{"type":"string","enum":["next_step","continue"],"description":"How captured cases replay: \"next_step\" (default when null) or \"continue\".","title":"EvalSuiteDetailRecordedToolMode"},"EvalSuiteDetailRecordedToolUnmatchedPolicy":{"type":"string","enum":["fail","stub"],"description":"Unmatched-call policy for \"continue\"-mode replays: \"fail\" (default when null) or \"stub\".","title":"EvalSuiteDetailRecordedToolUnmatchedPolicy"},"EvalSuiteDetailTargetType":{"type":"string","enum":["flow","agent"],"title":"EvalSuiteDetailTargetType"},"EvalSuiteDetailWarningsItems":{"type":"object","properties":{"agentId":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"],"title":"EvalSuiteDetailWarningsItems"},"EvalSuiteDetail":{"type":"object","properties":{"agentId":{"type":["string","null"]},"baselineBatchExecutionId":{"type":["string","null"]},"caseCount":{"type":"integer"},"cases":{"type":"array","items":{"$ref":"#/components/schemas/EvalCase"}},"createdAt":{"type":"string"},"description":{"type":["string","null"]},"enabledCaseCount":{"type":"integer"},"flowId":{"type":["string","null"]},"graders":{"type":"array","items":{"description":"Any type"},"description":"Ordered GraderConfig[] applied to every case."},"id":{"type":"string"},"identityDefaults":{"oneOf":[{"$ref":"#/components/schemas/EvalSuiteDetailIdentityDefaults"},{"type":"null"}],"description":"Default identity (endUser / tenant) cases run as unless they set their own; null when unset."},"isDefault":{"type":"boolean"},"judgeAgreement":{"oneOf":[{"$ref":"#/components/schemas/EvalSuiteDetailJudgeAgreement"},{"type":"null"}],"description":"The judge-trust corpus (E6 calibration): how often the AI grader agrees with your reviews, surfaced as a plain fraction. Null until at least one verdict has been reviewed (POST /eval/scores/{scoreId}/review)."},"lastModifiedSource":{"type":["string","null"],"description":"Provenance of the last Definition write. 'sdk' / 'terraform' mean the suite is managed in code (converged by ensure on deploy)."},"latestRun":{"$ref":"#/components/schemas/EvalSuiteLatestRun"},"name":{"type":"string"},"recordedToolMode":{"$ref":"#/components/schemas/EvalSuiteDetailRecordedToolMode","description":"How captured cases replay: \"next_step\" (default when null) or \"continue\"."},"recordedToolUnmatchedPolicy":{"$ref":"#/components/schemas/EvalSuiteDetailRecordedToolUnmatchedPolicy","description":"Unmatched-call policy for \"continue\"-mode replays: \"fail\" (default when null) or \"stub\"."},"targetName":{"type":["string","null"],"description":"Display name of the target flow/agent; null when the target row is gone."},"targetType":{"$ref":"#/components/schemas/EvalSuiteDetailTargetType"},"updatedAt":{"type":"string"},"warnings":{"type":"array","items":{"$ref":"#/components/schemas/EvalSuiteDetailWarningsItems"},"description":"Non-blocking findings about this suite. `AGENT_NOT_DEPLOYED` means the target agent has no runnable `live` version, so a run that names no version selector refuses once the live default is on for the organization."}},"required":["agentId","baselineBatchExecutionId","caseCount","cases","createdAt","description","enabledCaseCount","flowId","graders","id","identityDefaults","isDefault","judgeAgreement","lastModifiedSource","latestRun","name","recordedToolMode","recordedToolUnmatchedPolicy","targetName","targetType","updatedAt"],"title":"EvalSuiteDetail"},"Evals_deleteEvalSuite_Response_200":{"type":"object","properties":{"success":{"type":"boolean"}},"required":["success"],"title":"Evals_deleteEvalSuite_Response_200"},"V1EvalSuitesIdPatchRequestBodyContentApplicationJsonSchemaGradersItems":{"type":"object","properties":{"kind":{"type":"string","minLength":1}},"required":["kind"],"title":"V1EvalSuitesIdPatchRequestBodyContentApplicationJsonSchemaGradersItems"},"V1EvalSuitesIdPatchRequestBodyContentApplicationJsonSchemaIdentityDefaultsEndUser":{"type":"object","properties":{"email":{"type":"string"},"id":{"type":"string","minLength":1}},"required":["id"],"description":"The end user (the person) the turn runs as. Exposed to tools as _endUser.*, drives memory-profile sharding, and satisfies an end-user-isolated tenancyStrategy. Distinct from _user (the Builder User).","title":"V1EvalSuitesIdPatchRequestBodyContentApplicationJsonSchemaIdentityDefaultsEndUser"},"V1EvalSuitesIdPatchRequestBodyContentApplicationJsonSchemaIdentityDefaultsTenant":{"type":"object","properties":{"id":{"type":"string","minLength":1}},"required":["id"],"description":"The product tenant (a customer of your product, under your Builder Org) the turn runs within. Exposed to tools as _tenant.*.","title":"V1EvalSuitesIdPatchRequestBodyContentApplicationJsonSchemaIdentityDefaultsTenant"},"V1EvalSuitesIdPatchRequestBodyContentApplicationJsonSchemaIdentityDefaults":{"type":"object","properties":{"endUser":{"$ref":"#/components/schemas/V1EvalSuitesIdPatchRequestBodyContentApplicationJsonSchemaIdentityDefaultsEndUser","description":"The end user (the person) the turn runs as. Exposed to tools as _endUser.*, drives memory-profile sharding, and satisfies an end-user-isolated tenancyStrategy. Distinct from _user (the Builder User)."},"tenant":{"$ref":"#/components/schemas/V1EvalSuitesIdPatchRequestBodyContentApplicationJsonSchemaIdentityDefaultsTenant","description":"The product tenant (a customer of your product, under your Builder Org) the turn runs within. Exposed to tools as _tenant.*."}},"description":"Default identity (endUser / tenant) every case runs as unless the case sets its own; replaces the stored value. null clears it.","title":"V1EvalSuitesIdPatchRequestBodyContentApplicationJsonSchemaIdentityDefaults"},"V1EvalSuitesIdPatchRequestBodyContentApplicationJsonSchemaRecordedToolMode":{"type":"string","enum":["next_step","continue"],"description":"How captured (saved_from_run) cases replay. \"next_step\" captures the first tool intent and stops; \"continue\" serves recorded toolMocks and runs past the first action. null resets to the default (next_step).","title":"V1EvalSuitesIdPatchRequestBodyContentApplicationJsonSchemaRecordedToolMode"},"V1EvalSuitesIdPatchRequestBodyContentApplicationJsonSchemaRecordedToolUnmatchedPolicy":{"type":"string","enum":["fail","stub"],"description":"For \"continue\"-mode replays, the unmatched-call policy: \"fail\" (divergence is the signal) or \"stub\" (canned success). null resets to the default (fail).","title":"V1EvalSuitesIdPatchRequestBodyContentApplicationJsonSchemaRecordedToolUnmatchedPolicy"},"V1EvalSuitesIdCasesPostRequestBodyContentApplicationJsonSchemaCasesItemsExpected":{"type":"object","properties":{"facts":{"type":"array","items":{"type":"string"}},"json":{"description":"Any type"},"text":{"type":"string"}},"title":"V1EvalSuitesIdCasesPostRequestBodyContentApplicationJsonSchemaCasesItemsExpected"},"V1EvalSuitesIdCasesPostRequestBodyContentApplicationJsonSchemaCasesItemsGradersItems":{"type":"object","properties":{"kind":{"type":"string","minLength":1}},"required":["kind"],"title":"V1EvalSuitesIdCasesPostRequestBodyContentApplicationJsonSchemaCasesItemsGradersItems"},"V1EvalSuitesIdCasesPostRequestBodyContentApplicationJsonSchemaCasesItemsInputCheckpoint":{"type":"object","properties":{"forkMessageIndex":{"type":"integer","minimum":0},"sourceConversationId":{"type":"string"},"sourceExecutionId":{"type":"string"}},"required":["forkMessageIndex"],"title":"V1EvalSuitesIdCasesPostRequestBodyContentApplicationJsonSchemaCasesItemsInputCheckpoint"},"V1EvalSuitesIdCasesPostRequestBodyContentApplicationJsonSchemaCasesItemsInputEndUser":{"type":"object","properties":{"email":{"type":"string"},"id":{"type":"string","minLength":1}},"required":["id"],"description":"End user this case runs as (exposed to tools as _endUser.*, used to mint {{_identity.token}}). Overrides the suite identityDefaults.endUser. Required (or a suite default) when the agent sets config.tenancyStrategy.","title":"V1EvalSuitesIdCasesPostRequestBodyContentApplicationJsonSchemaCasesItemsInputEndUser"},"V1EvalSuitesIdCasesPostRequestBodyContentApplicationJsonSchemaCasesItemsInputMessagesItemsToolCallsItems":{"type":"object","properties":{"args":{"description":"Any type"},"toolCallId":{"type":"string"},"toolName":{"type":"string"}},"required":["toolCallId","toolName"],"title":"V1EvalSuitesIdCasesPostRequestBodyContentApplicationJsonSchemaCasesItemsInputMessagesItemsToolCallsItems"},"V1EvalSuitesIdCasesPostRequestBodyContentApplicationJsonSchemaCasesItemsInputMessagesItemsToolResultsItems":{"type":"object","properties":{"result":{"description":"Any type"},"toolCallId":{"type":"string"},"toolName":{"type":"string"}},"required":["toolCallId","toolName"],"title":"V1EvalSuitesIdCasesPostRequestBodyContentApplicationJsonSchemaCasesItemsInputMessagesItemsToolResultsItems"},"V1EvalSuitesIdCasesPostRequestBodyContentApplicationJsonSchemaCasesItemsInputMessagesItems":{"type":"object","properties":{"content":{"type":"string"},"role":{"type":"string","minLength":1},"toolCalls":{"type":"array","items":{"$ref":"#/components/schemas/V1EvalSuitesIdCasesPostRequestBodyContentApplicationJsonSchemaCasesItemsInputMessagesItemsToolCallsItems"}},"toolResults":{"type":"array","items":{"$ref":"#/components/schemas/V1EvalSuitesIdCasesPostRequestBodyContentApplicationJsonSchemaCasesItemsInputMessagesItemsToolResultsItems"}}},"required":["content","role"],"title":"V1EvalSuitesIdCasesPostRequestBodyContentApplicationJsonSchemaCasesItemsInputMessagesItems"},"V1EvalSuitesIdCasesPostRequestBodyContentApplicationJsonSchemaCasesItemsInputRecord":{"type":"object","properties":{"metadata":{"type":"object","additionalProperties":{"description":"Any type"}},"name":{"type":"string","minLength":1},"type":{"type":"string","minLength":1}},"description":"The record this case runs on, read by the flow as _record.name, _record.type and _record.metadata.*. Omitted fields keep the defaults: a record of type \"eval\" with empty metadata. Case variables still override same-named metadata fields at the top level.","title":"V1EvalSuitesIdCasesPostRequestBodyContentApplicationJsonSchemaCasesItemsInputRecord"},"V1EvalSuitesIdCasesPostRequestBodyContentApplicationJsonSchemaCasesItemsInputTenant":{"type":"object","properties":{"id":{"type":"string","minLength":1}},"required":["id"],"description":"Product tenant this case runs within (exposed as _tenant.*). Overrides the suite identityDefaults.tenant.","title":"V1EvalSuitesIdCasesPostRequestBodyContentApplicationJsonSchemaCasesItemsInputTenant"},"V1EvalSuitesIdCasesPostRequestBodyContentApplicationJsonSchemaCasesItemsInputToolMocksItemsOutput":{"oneOf":[{"type":"boolean"},{"type":"number","format":"double"},{"type":"string"},{"type":"array","items":{"description":"Any type"}},{"type":"object","additionalProperties":{"description":"Any type"}}],"title":"V1EvalSuitesIdCasesPostRequestBodyContentApplicationJsonSchemaCasesItemsInputToolMocksItemsOutput"},"V1EvalSuitesIdCasesPostRequestBodyContentApplicationJsonSchemaCasesItemsInputToolMocksItems":{"type":"object","properties":{"input":{"description":"Any type"},"isError":{"type":"boolean"},"output":{"oneOf":[{"$ref":"#/components/schemas/V1EvalSuitesIdCasesPostRequestBodyContentApplicationJsonSchemaCasesItemsInputToolMocksItemsOutput"},{"type":"null"}]},"sourceToolExecutionId":{"type":"string"},"toolName":{"type":"string","minLength":1},"truncated":{"type":"boolean"}},"required":["output","toolName"],"title":"V1EvalSuitesIdCasesPostRequestBodyContentApplicationJsonSchemaCasesItemsInputToolMocksItems"},"V1EvalSuitesIdCasesPostRequestBodyContentApplicationJsonSchemaCasesItemsInput":{"type":"object","properties":{"checkpoint":{"$ref":"#/components/schemas/V1EvalSuitesIdCasesPostRequestBodyContentApplicationJsonSchemaCasesItemsInputCheckpoint"},"endUser":{"$ref":"#/components/schemas/V1EvalSuitesIdCasesPostRequestBodyContentApplicationJsonSchemaCasesItemsInputEndUser","description":"End user this case runs as (exposed to tools as _endUser.*, used to mint {{_identity.token}}). Overrides the suite identityDefaults.endUser. Required (or a suite default) when the agent sets config.tenancyStrategy."},"messages":{"type":"array","items":{"$ref":"#/components/schemas/V1EvalSuitesIdCasesPostRequestBodyContentApplicationJsonSchemaCasesItemsInputMessagesItems"}},"record":{"$ref":"#/components/schemas/V1EvalSuitesIdCasesPostRequestBodyContentApplicationJsonSchemaCasesItemsInputRecord","description":"The record this case runs on, read by the flow as _record.name, _record.type and _record.metadata.*. Omitted fields keep the defaults: a record of type \"eval\" with empty metadata. Case variables still override same-named metadata fields at the top level."},"tenant":{"$ref":"#/components/schemas/V1EvalSuitesIdCasesPostRequestBodyContentApplicationJsonSchemaCasesItemsInputTenant","description":"Product tenant this case runs within (exposed as _tenant.*). Overrides the suite identityDefaults.tenant."},"toolMocks":{"type":"array","items":{"$ref":"#/components/schemas/V1EvalSuitesIdCasesPostRequestBodyContentApplicationJsonSchemaCasesItemsInputToolMocksItems"}},"variables":{"type":"object","additionalProperties":{"description":"Any type"}}},"title":"V1EvalSuitesIdCasesPostRequestBodyContentApplicationJsonSchemaCasesItemsInput"},"V1EvalSuitesIdCasesPostRequestBodyContentApplicationJsonSchemaCasesItemsOrigin":{"type":"string","enum":["manual","saved_from_run","generated","imported","fpo"],"description":"Case provenance. Defaults to \"manual\" when omitted. \"ensure\" is reserved for config-as-code converges.","title":"V1EvalSuitesIdCasesPostRequestBodyContentApplicationJsonSchemaCasesItemsOrigin"},"V1EvalSuitesIdCasesPostRequestBodyContentApplicationJsonSchemaCasesItems":{"type":"object","properties":{"enabled":{"type":"boolean"},"expected":{"$ref":"#/components/schemas/V1EvalSuitesIdCasesPostRequestBodyContentApplicationJsonSchemaCasesItemsExpected"},"graders":{"type":"array","items":{"$ref":"#/components/schemas/V1EvalSuitesIdCasesPostRequestBodyContentApplicationJsonSchemaCasesItemsGradersItems"},"description":"Per-case graders. When set, they REPLACE the suite-level graders for this case (not appended). Omit to score the case with the suite graders."},"input":{"$ref":"#/components/schemas/V1EvalSuitesIdCasesPostRequestBodyContentApplicationJsonSchemaCasesItemsInput","default":{}},"name":{"type":"string","minLength":1},"notes":{"type":"string"},"origin":{"$ref":"#/components/schemas/V1EvalSuitesIdCasesPostRequestBodyContentApplicationJsonSchemaCasesItemsOrigin","description":"Case provenance. Defaults to \"manual\" when omitted. \"ensure\" is reserved for config-as-code converges."}},"required":["name"],"title":"V1EvalSuitesIdCasesPostRequestBodyContentApplicationJsonSchemaCasesItems"},"EvalCasesCreated":{"type":"object","properties":{"cases":{"type":"array","items":{"$ref":"#/components/schemas/EvalCase"}}},"required":["cases"],"title":"EvalCasesCreated"},"V1EvalSuitesIdCasesFromExecutionPostRequestBodyContentApplicationJsonSchemaExpected":{"type":"object","properties":{"facts":{"type":"array","items":{"type":"string"}},"json":{"description":"Any type"},"text":{"type":"string"}},"description":"What \"good\" looks like for the graded next step (optional; e.g. pre-filled from a 👍).","title":"V1EvalSuitesIdCasesFromExecutionPostRequestBodyContentApplicationJsonSchemaExpected"},"CapturedEvalCase":{"type":"object","properties":{"case":{"$ref":"#/components/schemas/EvalCase"},"replayable":{"type":"boolean","description":"True when every recorded tool output was captured in full. False when any output was truncated at capture — the case still saves, but tool outputs are partial (\"⚠ tool outputs weren’t fully captured\")."}},"required":["case","replayable"],"title":"CapturedEvalCase"},"Evals_deleteEvalCase_Response_200":{"type":"object","properties":{"success":{"type":"boolean"}},"required":["success"],"title":"Evals_deleteEvalCase_Response_200"},"V1EvalSuitesIdCasesCaseIdPatchRequestBodyContentApplicationJsonSchemaExpected":{"type":"object","properties":{"facts":{"type":"array","items":{"type":"string"}},"json":{"description":"Any type"},"text":{"type":"string"}},"title":"V1EvalSuitesIdCasesCaseIdPatchRequestBodyContentApplicationJsonSchemaExpected"},"V1EvalSuitesIdCasesCaseIdPatchRequestBodyContentApplicationJsonSchemaGradersItems":{"type":"object","properties":{"kind":{"type":"string","minLength":1}},"required":["kind"],"title":"V1EvalSuitesIdCasesCaseIdPatchRequestBodyContentApplicationJsonSchemaGradersItems"},"V1EvalSuitesIdCasesCaseIdPatchRequestBodyContentApplicationJsonSchemaInputCheckpoint":{"type":"object","properties":{"forkMessageIndex":{"type":"integer","minimum":0},"sourceConversationId":{"type":"string"},"sourceExecutionId":{"type":"string"}},"required":["forkMessageIndex"],"title":"V1EvalSuitesIdCasesCaseIdPatchRequestBodyContentApplicationJsonSchemaInputCheckpoint"},"V1EvalSuitesIdCasesCaseIdPatchRequestBodyContentApplicationJsonSchemaInputEndUser":{"type":"object","properties":{"email":{"type":"string"},"id":{"type":"string","minLength":1}},"required":["id"],"description":"End user this case runs as (exposed to tools as _endUser.*, used to mint {{_identity.token}}). Overrides the suite identityDefaults.endUser. Required (or a suite default) when the agent sets config.tenancyStrategy.","title":"V1EvalSuitesIdCasesCaseIdPatchRequestBodyContentApplicationJsonSchemaInputEndUser"},"V1EvalSuitesIdCasesCaseIdPatchRequestBodyContentApplicationJsonSchemaInputMessagesItemsToolCallsItems":{"type":"object","properties":{"args":{"description":"Any type"},"toolCallId":{"type":"string"},"toolName":{"type":"string"}},"required":["toolCallId","toolName"],"title":"V1EvalSuitesIdCasesCaseIdPatchRequestBodyContentApplicationJsonSchemaInputMessagesItemsToolCallsItems"},"V1EvalSuitesIdCasesCaseIdPatchRequestBodyContentApplicationJsonSchemaInputMessagesItemsToolResultsItems":{"type":"object","properties":{"result":{"description":"Any type"},"toolCallId":{"type":"string"},"toolName":{"type":"string"}},"required":["toolCallId","toolName"],"title":"V1EvalSuitesIdCasesCaseIdPatchRequestBodyContentApplicationJsonSchemaInputMessagesItemsToolResultsItems"},"V1EvalSuitesIdCasesCaseIdPatchRequestBodyContentApplicationJsonSchemaInputMessagesItems":{"type":"object","properties":{"content":{"type":"string"},"role":{"type":"string","minLength":1},"toolCalls":{"type":"array","items":{"$ref":"#/components/schemas/V1EvalSuitesIdCasesCaseIdPatchRequestBodyContentApplicationJsonSchemaInputMessagesItemsToolCallsItems"}},"toolResults":{"type":"array","items":{"$ref":"#/components/schemas/V1EvalSuitesIdCasesCaseIdPatchRequestBodyContentApplicationJsonSchemaInputMessagesItemsToolResultsItems"}}},"required":["content","role"],"title":"V1EvalSuitesIdCasesCaseIdPatchRequestBodyContentApplicationJsonSchemaInputMessagesItems"},"V1EvalSuitesIdCasesCaseIdPatchRequestBodyContentApplicationJsonSchemaInputRecord":{"type":"object","properties":{"metadata":{"type":"object","additionalProperties":{"description":"Any type"}},"name":{"type":"string","minLength":1},"type":{"type":"string","minLength":1}},"description":"The record this case runs on, read by the flow as _record.name, _record.type and _record.metadata.*. Omitted fields keep the defaults: a record of type \"eval\" with empty metadata. Case variables still override same-named metadata fields at the top level.","title":"V1EvalSuitesIdCasesCaseIdPatchRequestBodyContentApplicationJsonSchemaInputRecord"},"V1EvalSuitesIdCasesCaseIdPatchRequestBodyContentApplicationJsonSchemaInputTenant":{"type":"object","properties":{"id":{"type":"string","minLength":1}},"required":["id"],"description":"Product tenant this case runs within (exposed as _tenant.*). Overrides the suite identityDefaults.tenant.","title":"V1EvalSuitesIdCasesCaseIdPatchRequestBodyContentApplicationJsonSchemaInputTenant"},"V1EvalSuitesIdCasesCaseIdPatchRequestBodyContentApplicationJsonSchemaInputToolMocksItemsOutput":{"oneOf":[{"type":"boolean"},{"type":"number","format":"double"},{"type":"string"},{"type":"array","items":{"description":"Any type"}},{"type":"object","additionalProperties":{"description":"Any type"}}],"title":"V1EvalSuitesIdCasesCaseIdPatchRequestBodyContentApplicationJsonSchemaInputToolMocksItemsOutput"},"V1EvalSuitesIdCasesCaseIdPatchRequestBodyContentApplicationJsonSchemaInputToolMocksItems":{"type":"object","properties":{"input":{"description":"Any type"},"isError":{"type":"boolean"},"output":{"oneOf":[{"$ref":"#/components/schemas/V1EvalSuitesIdCasesCaseIdPatchRequestBodyContentApplicationJsonSchemaInputToolMocksItemsOutput"},{"type":"null"}]},"sourceToolExecutionId":{"type":"string"},"toolName":{"type":"string","minLength":1},"truncated":{"type":"boolean"}},"required":["output","toolName"],"title":"V1EvalSuitesIdCasesCaseIdPatchRequestBodyContentApplicationJsonSchemaInputToolMocksItems"},"V1EvalSuitesIdCasesCaseIdPatchRequestBodyContentApplicationJsonSchemaInput":{"type":"object","properties":{"checkpoint":{"$ref":"#/components/schemas/V1EvalSuitesIdCasesCaseIdPatchRequestBodyContentApplicationJsonSchemaInputCheckpoint"},"endUser":{"$ref":"#/components/schemas/V1EvalSuitesIdCasesCaseIdPatchRequestBodyContentApplicationJsonSchemaInputEndUser","description":"End user this case runs as (exposed to tools as _endUser.*, used to mint {{_identity.token}}). Overrides the suite identityDefaults.endUser. Required (or a suite default) when the agent sets config.tenancyStrategy."},"messages":{"type":"array","items":{"$ref":"#/components/schemas/V1EvalSuitesIdCasesCaseIdPatchRequestBodyContentApplicationJsonSchemaInputMessagesItems"}},"record":{"$ref":"#/components/schemas/V1EvalSuitesIdCasesCaseIdPatchRequestBodyContentApplicationJsonSchemaInputRecord","description":"The record this case runs on, read by the flow as _record.name, _record.type and _record.metadata.*. Omitted fields keep the defaults: a record of type \"eval\" with empty metadata. Case variables still override same-named metadata fields at the top level."},"tenant":{"$ref":"#/components/schemas/V1EvalSuitesIdCasesCaseIdPatchRequestBodyContentApplicationJsonSchemaInputTenant","description":"Product tenant this case runs within (exposed as _tenant.*). Overrides the suite identityDefaults.tenant."},"toolMocks":{"type":"array","items":{"$ref":"#/components/schemas/V1EvalSuitesIdCasesCaseIdPatchRequestBodyContentApplicationJsonSchemaInputToolMocksItems"}},"variables":{"type":"object","additionalProperties":{"description":"Any type"}}},"title":"V1EvalSuitesIdCasesCaseIdPatchRequestBodyContentApplicationJsonSchemaInput"},"EvalCoverageInstructionsItemsPolarity":{"type":"string","enum":["should","should_not"],"title":"EvalCoverageInstructionsItemsPolarity"},"EvalCoverageInstructionsItems":{"type":"object","properties":{"clause":{"type":"string"},"covered":{"type":"boolean"},"coveredBy":{"type":"array","items":{"type":"string"},"description":"The AI-grader criteria that cover it."},"polarity":{"$ref":"#/components/schemas/EvalCoverageInstructionsItemsPolarity"}},"required":["clause","covered","coveredBy","polarity"],"title":"EvalCoverageInstructionsItems"},"EvalCoverageSummary":{"type":"object","properties":{"instructionsCovered":{"type":"integer"},"instructionsTotal":{"type":"integer"},"toolsCovered":{"type":"integer"},"toolsTotal":{"type":"integer"}},"required":["instructionsCovered","instructionsTotal","toolsCovered","toolsTotal"],"title":"EvalCoverageSummary"},"EvalCoverageToolsItems":{"type":"object","properties":{"covered":{"type":"boolean"},"coveredBy":{"type":"array","items":{"type":"string"},"description":"Names of the cases that cover it."},"description":{"type":"string"},"name":{"type":"string"}},"required":["covered","coveredBy","name"],"title":"EvalCoverageToolsItems"},"EvalCoverage":{"type":"object","properties":{"definitionHash":{"type":"string"},"instructions":{"type":"array","items":{"$ref":"#/components/schemas/EvalCoverageInstructionsItems"}},"inventoryDegraded":{"type":"boolean","description":"True when the instruction inventory pass failed; the tools axis is still accurate."},"inventoryRefreshed":{"type":"boolean"},"summary":{"$ref":"#/components/schemas/EvalCoverageSummary"},"tools":{"type":"array","items":{"$ref":"#/components/schemas/EvalCoverageToolsItems"}}},"required":["definitionHash","instructions","inventoryDegraded","inventoryRefreshed","summary","tools"],"title":"EvalCoverage"},"V1EvalSuitesIdGenerateCasesPostRequestBodyContentApplicationJsonSchemaGap":{"type":"object","properties":{"instruction":{"type":"string","minLength":1},"toolName":{"type":"string","minLength":1}},"description":"Generate for one coverage gap: cases exercising this tool or probing this instruction clause (proposals land with source \"coverage_gap\"). Provide exactly one of toolName/instruction.","title":"V1EvalSuitesIdGenerateCasesPostRequestBodyContentApplicationJsonSchemaGap"},"EvalCasesGenerated":{"type":"object","properties":{"droppedCount":{"type":"integer","description":"Cases dropped by the gradeability audit (unstable pass bar)."},"generatedCount":{"type":"integer","description":"Cases the model produced before filtering."},"model":{"type":"string","description":"Resolved model id that produced the generation."},"proposals":{"type":"array","items":{"$ref":"#/components/schemas/EvalCaseProposal"}}},"required":["droppedCount","generatedCount","model","proposals"],"title":"EvalCasesGenerated"},"V1EvalSuitesIdProposalsGetParametersStatus":{"type":"string","enum":["proposed","accepted","edited_accepted","rejected"],"description":"Filter by status. Omit for all; the queue UI uses \"proposed\".","title":"V1EvalSuitesIdProposalsGetParametersStatus"},"EvalCaseProposalList":{"type":"object","properties":{"count":{"type":"integer","description":"Proposals in this page."},"limit":{"type":"integer"},"offset":{"type":"integer"},"proposals":{"type":"array","items":{"$ref":"#/components/schemas/EvalCaseProposal"}},"total":{"type":"integer","description":"Total proposals matching the filter."}},"required":["count","limit","offset","proposals","total"],"title":"EvalCaseProposalList"},"V1EvalSuitesIdProposalsProposalIdAcceptPostRequestBodyContentApplicationJsonSchemaCaseExpected":{"type":"object","properties":{"facts":{"type":"array","items":{"type":"string"}},"json":{"description":"Any type"},"text":{"type":"string"}},"title":"V1EvalSuitesIdProposalsProposalIdAcceptPostRequestBodyContentApplicationJsonSchemaCaseExpected"},"V1EvalSuitesIdProposalsProposalIdAcceptPostRequestBodyContentApplicationJsonSchemaCaseInputCheckpoint":{"type":"object","properties":{"forkMessageIndex":{"type":"integer","minimum":0},"sourceConversationId":{"type":"string"},"sourceExecutionId":{"type":"string"}},"required":["forkMessageIndex"],"title":"V1EvalSuitesIdProposalsProposalIdAcceptPostRequestBodyContentApplicationJsonSchemaCaseInputCheckpoint"},"V1EvalSuitesIdProposalsProposalIdAcceptPostRequestBodyContentApplicationJsonSchemaCaseInputEndUser":{"type":"object","properties":{"email":{"type":"string"},"id":{"type":"string","minLength":1}},"required":["id"],"description":"The end user (the person) the turn runs as. Exposed to tools as _endUser.*, drives memory-profile sharding, and satisfies an end-user-isolated tenancyStrategy. Distinct from _user (the Builder User).","title":"V1EvalSuitesIdProposalsProposalIdAcceptPostRequestBodyContentApplicationJsonSchemaCaseInputEndUser"},"V1EvalSuitesIdProposalsProposalIdAcceptPostRequestBodyContentApplicationJsonSchemaCaseInputMessagesItems":{"type":"object","properties":{"content":{"type":"string"},"role":{"type":"string","minLength":1}},"required":["content","role"],"title":"V1EvalSuitesIdProposalsProposalIdAcceptPostRequestBodyContentApplicationJsonSchemaCaseInputMessagesItems"},"V1EvalSuitesIdProposalsProposalIdAcceptPostRequestBodyContentApplicationJsonSchemaCaseInputTenant":{"type":"object","properties":{"id":{"type":"string","minLength":1}},"required":["id"],"description":"The product tenant (a customer of your product, under your Builder Org) the turn runs within. Exposed to tools as _tenant.*.","title":"V1EvalSuitesIdProposalsProposalIdAcceptPostRequestBodyContentApplicationJsonSchemaCaseInputTenant"},"V1EvalSuitesIdProposalsProposalIdAcceptPostRequestBodyContentApplicationJsonSchemaCaseInputToolMocksItemsOutput":{"oneOf":[{"type":"boolean"},{"type":"number","format":"double"},{"type":"string"},{"type":"array","items":{"description":"Any type"}},{"type":"object","additionalProperties":{"description":"Any type"}}],"title":"V1EvalSuitesIdProposalsProposalIdAcceptPostRequestBodyContentApplicationJsonSchemaCaseInputToolMocksItemsOutput"},"V1EvalSuitesIdProposalsProposalIdAcceptPostRequestBodyContentApplicationJsonSchemaCaseInputToolMocksItems":{"type":"object","properties":{"input":{"description":"Any type"},"isError":{"type":"boolean"},"output":{"oneOf":[{"$ref":"#/components/schemas/V1EvalSuitesIdProposalsProposalIdAcceptPostRequestBodyContentApplicationJsonSchemaCaseInputToolMocksItemsOutput"},{"type":"null"}]},"sourceToolExecutionId":{"type":"string"},"toolName":{"type":"string","minLength":1},"truncated":{"type":"boolean"}},"required":["output","toolName"],"title":"V1EvalSuitesIdProposalsProposalIdAcceptPostRequestBodyContentApplicationJsonSchemaCaseInputToolMocksItems"},"V1EvalSuitesIdProposalsProposalIdAcceptPostRequestBodyContentApplicationJsonSchemaCaseInput":{"type":"object","properties":{"checkpoint":{"$ref":"#/components/schemas/V1EvalSuitesIdProposalsProposalIdAcceptPostRequestBodyContentApplicationJsonSchemaCaseInputCheckpoint"},"endUser":{"$ref":"#/components/schemas/V1EvalSuitesIdProposalsProposalIdAcceptPostRequestBodyContentApplicationJsonSchemaCaseInputEndUser","description":"The end user (the person) the turn runs as. Exposed to tools as _endUser.*, drives memory-profile sharding, and satisfies an end-user-isolated tenancyStrategy. Distinct from _user (the Builder User)."},"messages":{"type":"array","items":{"$ref":"#/components/schemas/V1EvalSuitesIdProposalsProposalIdAcceptPostRequestBodyContentApplicationJsonSchemaCaseInputMessagesItems"}},"tenant":{"$ref":"#/components/schemas/V1EvalSuitesIdProposalsProposalIdAcceptPostRequestBodyContentApplicationJsonSchemaCaseInputTenant","description":"The product tenant (a customer of your product, under your Builder Org) the turn runs within. Exposed to tools as _tenant.*."},"toolMocks":{"type":"array","items":{"$ref":"#/components/schemas/V1EvalSuitesIdProposalsProposalIdAcceptPostRequestBodyContentApplicationJsonSchemaCaseInputToolMocksItems"}},"variables":{"type":"object","additionalProperties":{"description":"Any type"}}},"title":"V1EvalSuitesIdProposalsProposalIdAcceptPostRequestBodyContentApplicationJsonSchemaCaseInput"},"V1EvalSuitesIdProposalsProposalIdAcceptPostRequestBodyContentApplicationJsonSchemaCase":{"type":"object","properties":{"expected":{"$ref":"#/components/schemas/V1EvalSuitesIdProposalsProposalIdAcceptPostRequestBodyContentApplicationJsonSchemaCaseExpected"},"input":{"$ref":"#/components/schemas/V1EvalSuitesIdProposalsProposalIdAcceptPostRequestBodyContentApplicationJsonSchemaCaseInput"},"name":{"type":"string","minLength":1},"notes":{"type":"string"}},"required":["input","name"],"description":"Reviewer-edited case body. Omit to accept the proposal verbatim; provide it to save an edited version (recorded as \"edited_accepted\"; the machine original stays on the proposal for audit).","title":"V1EvalSuitesIdProposalsProposalIdAcceptPostRequestBodyContentApplicationJsonSchemaCase"},"EvalCaseProposalAccepted":{"type":"object","properties":{"case":{"description":"The materialized eval case row."},"proposal":{"$ref":"#/components/schemas/EvalCaseProposal"}},"required":["proposal"],"title":"EvalCaseProposalAccepted"},"Evals_rejectAnEvalCaseProposal_Response_200":{"type":"object","properties":{"proposal":{"$ref":"#/components/schemas/EvalCaseProposal"}},"required":["proposal"],"title":"Evals_rejectAnEvalCaseProposal_Response_200"},"EvalAgentSelector":{"type":"object","properties":{"alias":{"type":"string","minLength":1,"maxLength":63,"description":"Run whichever version this release alias currently points at. Resolved once for the whole run."},"versionId":{"type":"string","minLength":1,"description":"Run this exact immutable version snapshot."}},"description":"Version selector for an Agent-target suite. Supply at most one of alias or versionId; omit it to run the saved configuration.","title":"EvalAgentSelector"},"V1EvalSuitesIdRunPostRequestBodyContentApplicationJsonSchemaMode":{"type":"string","enum":["sync","batch"],"description":"Force the execution path. Default: sync for suites within the synchronous case limit (50), batch above it.","title":"V1EvalSuitesIdRunPostRequestBodyContentApplicationJsonSchemaMode"},"V1EvalIdResultsGetResponsesContentApplicationJsonSchemaAgentTargetResolution":{"type":"string","enum":["alias","version","legacy-live-row"],"description":"How the run picked its version. Null on a run that predates release aliases.","title":"V1EvalIdResultsGetResponsesContentApplicationJsonSchemaAgentTargetResolution"},"V1EvalIdResultsGetResponsesContentApplicationJsonSchemaCaseErrorsItems":{"type":"object","properties":{"caseId":{"type":["string","null"]},"error":{"type":"string"},"name":{"type":"string"}},"required":["caseId","error","name"],"title":"V1EvalIdResultsGetResponsesContentApplicationJsonSchemaCaseErrorsItems"},"V1EvalIdResultsGetResponsesContentApplicationJsonSchemaResultsByRecordItemsExecutionEngine":{"type":"string","enum":["runtime","legacy","external"],"description":"Engine that actually executed this step ('runtime' | 'legacy' | 'external'). Recorded at write time from the committed lane decision; never inferred later. 'external' marks a run a customer executed outside Runtype and reported through ingest. Null for rows written before attribution shipped and for units that never started executing.","title":"V1EvalIdResultsGetResponsesContentApplicationJsonSchemaResultsByRecordItemsExecutionEngine"},"V1EvalIdResultsGetResponsesContentApplicationJsonSchemaResultsByRecordItemsToolCallsItems":{"type":"object","properties":{"errorMessage":{"type":["string","null"]},"executedAt":{"type":"string"},"executionTimeMs":{"type":["integer","null"]},"inputParameters":{"description":"Any type"},"model":{"type":["string","null"]},"outputResult":{"description":"Any type"},"status":{"type":"string"},"toolDescription":{"type":["string","null"]},"toolExecutionId":{"type":"string"},"toolId":{"type":["string","null"]},"toolName":{"type":"string"}},"required":["errorMessage","executedAt","executionTimeMs","model","status","toolDescription","toolExecutionId","toolId","toolName"],"title":"V1EvalIdResultsGetResponsesContentApplicationJsonSchemaResultsByRecordItemsToolCallsItems"},"V1EvalIdResultsGetResponsesContentApplicationJsonSchemaResultsByRecordItems":{"type":"object","properties":{"completionTokens":{"type":["integer","null"]},"durationMs":{"type":["integer","null"]},"errorMessage":{"type":["string","null"]},"errorStack":{"type":["string","null"]},"executedAt":{"type":"string"},"executionEngine":{"$ref":"#/components/schemas/V1EvalIdResultsGetResponsesContentApplicationJsonSchemaResultsByRecordItemsExecutionEngine","description":"Engine that actually executed this step ('runtime' | 'legacy' | 'external'). Recorded at write time from the committed lane decision; never inferred later. 'external' marks a run a customer executed outside Runtype and reported through ingest. Null for rows written before attribution shipped and for units that never started executing."},"executionSessionId":{"type":["string","null"]},"inputVariables":{"description":"Any type"},"messageHistory":{"type":["array","null"],"items":{"description":"Any type"}},"modelUsed":{"type":["string","null"]},"output":{"type":["string","null"]},"promptTokens":{"type":["integer","null"]},"reasoningContent":{"type":["string","null"]},"reasoningTokens":{"type":["integer","null"]},"recordMetadata":{"description":"Any type"},"recordName":{"type":["string","null"]},"resolvedPrompt":{"type":["string","null"]},"retryCount":{"type":["integer","null"]},"stepConfig":{"description":"Any type"},"stepId":{"type":["string","null"]},"stepName":{"type":["string","null"]},"stepResultId":{"type":"string"},"stepType":{"type":"string"},"toolCalls":{"type":"array","items":{"$ref":"#/components/schemas/V1EvalIdResultsGetResponsesContentApplicationJsonSchemaResultsByRecordItemsToolCallsItems"}},"totalCost":{"type":["number","null"],"format":"double"}},"required":["completionTokens","durationMs","errorMessage","errorStack","executedAt","executionSessionId","messageHistory","modelUsed","output","promptTokens","reasoningContent","reasoningTokens","recordName","resolvedPrompt","retryCount","stepId","stepName","stepResultId","stepType","toolCalls","totalCost"],"title":"V1EvalIdResultsGetResponsesContentApplicationJsonSchemaResultsByRecordItems"},"Evals_getEvalResults_Response_200":{"type":"object","properties":{"agentTargetAlias":{"type":["string","null"],"description":"The release alias the run resolved through, when it resolved through one."},"agentTargetResolution":{"$ref":"#/components/schemas/V1EvalIdResultsGetResponsesContentApplicationJsonSchemaAgentTargetResolution","description":"How the run picked its version. Null on a run that predates release aliases."},"agentVersionId":{"type":["string","null"],"description":"The exact Agent version every case of this run executed. Null for a legacy run."},"batchExecutionId":{"type":"string"},"caseErrors":{"type":"array","items":{"$ref":"#/components/schemas/V1EvalIdResultsGetResponsesContentApplicationJsonSchemaCaseErrorsItems"},"description":"Every graded case that errored, with the failure text its scores recorded. Empty when no case errored, when the run is not scored yet, or when it was scored before the field shipped."},"caseManifestHash":{"type":["string","null"],"description":"SHA-256 over the ordered, normalized case set this run executed."},"completedAt":{"type":"string"},"evalConfig":{"description":"Any type"},"evalGroupId":{"type":"string"},"evalName":{"type":"string"},"evaluatorFingerprint":{"type":["string","null"],"description":"SHA-256 over the evaluator configuration this run scored with."},"failedRecords":{"type":"integer"},"flowId":{"type":["string","null"]},"processedRecords":{"type":"integer"},"resultsByRecord":{"type":"object","additionalProperties":{"type":"array","items":{"$ref":"#/components/schemas/V1EvalIdResultsGetResponsesContentApplicationJsonSchemaResultsByRecordItems"}}},"startedAt":{"type":"string"},"status":{"type":"string"},"totalRecords":{"type":"integer"}},"required":["batchExecutionId","caseErrors","failedRecords","flowId","processedRecords","resultsByRecord","startedAt","status","totalRecords"],"title":"Evals_getEvalResults_Response_200"},"V1EventsGetParametersOnlyRegressions":{"type":"string","enum":["true","false"],"description":"Eval runs only: keep runs whose pass rate dropped","title":"V1EventsGetParametersOnlyRegressions"},"ProductEventOccurrenceName":{"type":"string","enum":["runtype.execution.failed","runtype.approval.requested","runtype.schedule.run_failed","runtype.eval.run_completed","runtype.simulation.run_completed","runtype.conversation.human_takeover","runtype.skill.proposal_created","runtype.task.input_required","runtype.task.completed","runtype.task.failed","runtype.task.cancelled","runtype.signal.fired","runtype.signal.cluster_appeared","runtype.api_key_request.decided"],"title":"ProductEventOccurrenceName"},"ProductEventOccurrence":{"type":"object","properties":{"cursor":{"type":"string","pattern":"^(0|[1-9]\\d{0,18})$","description":"Position of this occurrence in the organization log"},"data":{"type":"object","additionalProperties":{"description":"Any type"},"description":"Ids plus a short summary; shape per `payloadSchema`"},"eventId":{"type":"string","description":"Occurrence id (typeid, `pev_` prefix)"},"name":{"$ref":"#/components/schemas/ProductEventOccurrenceName"},"timestamp":{"type":"string","description":"When it happened (ISO 8601)"}},"required":["cursor","data","eventId","name","timestamp"],"title":"ProductEventOccurrence"},"ProductEventPollResult":{"type":"object","properties":{"cursor":{"type":["string","null"],"pattern":"^(0|[1-9]\\d{0,18})$","description":"Pass back as `after`: after the last returned event, or the head when none"},"events":{"type":"array","items":{"$ref":"#/components/schemas/ProductEventOccurrence"}},"hasMore":{"type":"boolean","description":"More events matched beyond `maxEvents`; poll again now"},"nextPollMs":{"type":"integer","description":"Suggested wait before the next poll"},"truncated":{"type":"boolean","description":"True when `after` predates retention or `maxAgeMs`, so events were skipped"}},"required":["cursor","events","hasMore","nextPollMs","truncated"],"title":"ProductEventPollResult"},"ProductEventErrorCode":{"type":"string","enum":["EVENT_NOT_FOUND","INVALID_EVENT_ARGUMENTS","INVALID_EVENT_CURSOR","EVENT_SCOPE_FORBIDDEN"],"description":"Stable error code","title":"ProductEventErrorCode"},"ProductEventErrorDetailsItems":{"type":"object","properties":{"code":{"type":"string","description":"Stable Runtype validation code (e.g. MISSING_REQUIRED_FIELD, INVALID_ENUM)."},"message":{"type":"string"},"path":{"type":"string","description":"Dotted JSON path to the offending field."},"suggestion":{"type":"string","description":"Actionable hint (allowed values, accepted range, …)."}},"required":["message"],"title":"ProductEventErrorDetailsItems"},"ProductEventError":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/ProductEventErrorCode","description":"Stable error code"},"details":{"type":"array","items":{"$ref":"#/components/schemas/ProductEventErrorDetailsItems"}},"error":{"type":"string"},"requiredScopes":{"type":"array","items":{"type":"string"},"description":"On `insufficient_scope`: every API key scope this request needs."}},"required":["code","error"],"title":"ProductEventError"},"V1EventsGetResponsesContentApplicationJsonSchemaCode":{"type":"string","enum":["EVENT_NOT_FOUND","INVALID_EVENT_ARGUMENTS","INVALID_EVENT_CURSOR","EVENT_SCOPE_FORBIDDEN"],"description":"Stable error code","title":"V1EventsGetResponsesContentApplicationJsonSchemaCode"},"V1EventsGetResponsesContentApplicationJsonSchemaDetailsItems":{"type":"object","properties":{"code":{"type":"string","description":"Stable Runtype validation code (e.g. MISSING_REQUIRED_FIELD, INVALID_ENUM)."},"message":{"type":"string"},"path":{"type":"string","description":"Dotted JSON path to the offending field."},"suggestion":{"type":"string","description":"Actionable hint (allowed values, accepted range, …)."}},"required":["message"],"title":"V1EventsGetResponsesContentApplicationJsonSchemaDetailsItems"},"PollProductEventsRequestForbiddenError":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/V1EventsGetResponsesContentApplicationJsonSchemaCode","description":"Stable error code"},"details":{"type":"array","items":{"$ref":"#/components/schemas/V1EventsGetResponsesContentApplicationJsonSchemaDetailsItems"}},"error":{"type":"string"},"requiredScopes":{"type":"array","items":{"type":"string"},"description":"On `insufficient_scope`: every API key scope this request needs."}},"required":["error"],"title":"PollProductEventsRequestForbiddenError"},"ProductEventDescriptorDeliveryItems":{"type":"string","enum":["poll"],"title":"ProductEventDescriptorDeliveryItems"},"ProductEventDescriptorName":{"type":"string","enum":["runtype.execution.failed","runtype.approval.requested","runtype.schedule.run_failed","runtype.eval.run_completed","runtype.simulation.run_completed","runtype.conversation.human_takeover","runtype.skill.proposal_created","runtype.task.input_required","runtype.task.completed","runtype.task.failed","runtype.task.cancelled","runtype.signal.fired","runtype.signal.cluster_appeared","runtype.api_key_request.decided"],"title":"ProductEventDescriptorName"},"ProductEventDescriptor":{"type":"object","properties":{"delivery":{"type":"array","items":{"$ref":"#/components/schemas/ProductEventDescriptorDeliveryItems"}},"description":{"type":"string"},"inputSchema":{"type":"object","additionalProperties":{"description":"Any type"},"description":"JSON Schema for the filter arguments this event accepts"},"name":{"$ref":"#/components/schemas/ProductEventDescriptorName"},"payloadSchema":{"type":"object","additionalProperties":{"description":"Any type"},"description":"JSON Schema for the occurrence `data`"},"requiredScopes":{"type":"array","items":{"type":"string"},"description":"API-key scopes that can read this event (any one); sessions read every event"}},"required":["delivery","description","inputSchema","name","payloadSchema","requiredScopes"],"title":"ProductEventDescriptor"},"Events_listEventTypes_Response_200":{"type":"object","properties":{"events":{"type":"array","items":{"$ref":"#/components/schemas/ProductEventDescriptor"}}},"required":["events"],"title":"Events_listEventTypes_Response_200"},"InputDeliveryReceiptStatus":{"type":"string","enum":["pending","applied","settled","not_applied"],"title":"InputDeliveryReceiptStatus"},"InputDeliveryReceipt":{"type":"object","properties":{"deliveryId":{"type":"string","minLength":1},"executionId":{"type":"string","minLength":1},"initial":{"type":"boolean"},"outcome":{"type":"string"},"sequence":{"type":"integer","minimum":0},"status":{"$ref":"#/components/schemas/InputDeliveryReceiptStatus"}},"required":["deliveryId","executionId","initial","sequence","status"],"title":"InputDeliveryReceipt"},"V1ExecutionsExecutionIdJournalGetResponsesContentApplicationJsonSchemaJournalEventsItems":{"type":"object","properties":{"attempt":{"type":["integer","null"]},"createdAt":{"type":["string","null"]},"eventName":{"type":"string"},"id":{"type":"string"},"payload":{"type":"object","additionalProperties":{"description":"Any type"}},"seq":{"type":"integer"},"stepId":{"type":["string","null"]}},"required":["attempt","createdAt","eventName","id","payload","seq","stepId"],"title":"V1ExecutionsExecutionIdJournalGetResponsesContentApplicationJsonSchemaJournalEventsItems"},"Executions_readAnExecutionJournal_Response_200":{"type":"object","properties":{"executionId":{"type":"string"},"journalEvents":{"type":"array","items":{"$ref":"#/components/schemas/V1ExecutionsExecutionIdJournalGetResponsesContentApplicationJsonSchemaJournalEventsItems"}},"truncated":{"type":"boolean","description":"True when the execution has more than 1000 journal events and the returned list is capped."}},"required":["executionId","journalEvents","truncated"],"title":"Executions_readAnExecutionJournal_Response_200"},"V1ExecutionsExecutionIdStatusGetResponsesContentApplicationJsonSchemaAgentTargetResolution":{"type":"string","enum":["alias","version","legacy-live-row"],"description":"How the run selected its definition: `alias` or `version` for a request that named a selector, `legacy-live-row` for a run that read the mutable agent row.","title":"V1ExecutionsExecutionIdStatusGetResponsesContentApplicationJsonSchemaAgentTargetResolution"},"V1ExecutionsExecutionIdStatusGetResponsesContentApplicationJsonSchemaAgentVersion":{"type":"object","properties":{"id":{"type":"string"},"label":{"type":["string","null"]},"versionNumber":{"type":"integer"}},"required":["id","label","versionNumber"],"description":"Version number and label for `agentVersionId`. `null` exactly when `agentVersionId` is `null`.","title":"V1ExecutionsExecutionIdStatusGetResponsesContentApplicationJsonSchemaAgentVersion"},"V1ExecutionsExecutionIdStatusGetResponsesContentApplicationJsonSchemaExecutionLane":{"type":"string","enum":["durable","in_process"],"description":"Which substrate ran this turn: `durable` for a Durable Object (a Runtype session, or the run owner a detached run is handed to), `in_process` for the request worker. Present only for an execution with a canonical agent row; a flow handle and a Claude Managed handle omit it.","title":"V1ExecutionsExecutionIdStatusGetResponsesContentApplicationJsonSchemaExecutionLane"},"V1ExecutionsExecutionIdStatusGetResponsesContentApplicationJsonSchemaStatus":{"type":"string","enum":["queued","running","paused","completed","failed","cancelled"],"title":"V1ExecutionsExecutionIdStatusGetResponsesContentApplicationJsonSchemaStatus"},"V1ExecutionsExecutionIdStatusGetResponsesContentApplicationJsonSchemaTargetKind":{"type":"string","enum":["flow","agent"],"title":"V1ExecutionsExecutionIdStatusGetResponsesContentApplicationJsonSchemaTargetKind"},"Executions_pollAnAsynchronousExecution_Response_200":{"type":"object","properties":{"agentTargetResolution":{"$ref":"#/components/schemas/V1ExecutionsExecutionIdStatusGetResponsesContentApplicationJsonSchemaAgentTargetResolution","description":"How the run selected its definition: `alias` or `version` for a request that named a selector, `legacy-live-row` for a run that read the mutable agent row."},"agentVersion":{"oneOf":[{"$ref":"#/components/schemas/V1ExecutionsExecutionIdStatusGetResponsesContentApplicationJsonSchemaAgentVersion"},{"type":"null"}],"description":"Version number and label for `agentVersionId`. `null` exactly when `agentVersionId` is `null`."},"agentVersionId":{"type":["string","null"],"description":"The `agent_versions` row the run was recorded against. Present only for durable agent executions; `null` when that surface stamps no version."},"createdAt":{"type":"string"},"error":{"type":"string"},"executionId":{"type":"string"},"executionLane":{"$ref":"#/components/schemas/V1ExecutionsExecutionIdStatusGetResponsesContentApplicationJsonSchemaExecutionLane","description":"Which substrate ran this turn: `durable` for a Durable Object (a Runtype session, or the run owner a detached run is handed to), `in_process` for the request worker. Present only for an execution with a canonical agent row; a flow handle and a Claude Managed handle omit it."},"httpStatus":{"type":"integer"},"result":{"description":"Any type"},"resultUnavailable":{"type":"boolean","description":"Present and `true` when the execution settled but its result was too large to store or could not be retrieved; `result` then holds only a summary and `resultUnavailableReason` explains why. `error` keeps describing an execution failure; on an otherwise completed execution it repeats the reason."},"resultUnavailableReason":{"type":"string","description":"Why the result is unavailable. Present exactly when `resultUnavailable` is `true`."},"status":{"$ref":"#/components/schemas/V1ExecutionsExecutionIdStatusGetResponsesContentApplicationJsonSchemaStatus"},"targetId":{"type":"string"},"targetKind":{"$ref":"#/components/schemas/V1ExecutionsExecutionIdStatusGetResponsesContentApplicationJsonSchemaTargetKind"},"underlyingExecutionId":{"type":"string"}},"required":["createdAt","executionId","status","targetKind"],"title":"Executions_pollAnAsynchronousExecution_Response_200"},"ExtractionModelCredentialRequirementsProvider":{"type":"string","enum":["platform"],"title":"ExtractionModelCredentialRequirementsProvider"},"ExtractionModelCredentialRequirements":{"type":"object","properties":{"organizationCredentialSupported":{"type":"boolean"},"platformFundingSupported":{"type":"boolean"},"provider":{"$ref":"#/components/schemas/ExtractionModelCredentialRequirementsProvider"}},"required":["organizationCredentialSupported","platformFundingSupported","provider"],"title":"ExtractionModelCredentialRequirements"},"ExtractionModelPricing":{"type":"object","properties":{"inputPer1MTokens":{"type":"number","format":"double"},"inputPerToken":{"type":"string"},"outputPer1MTokens":{"type":"number","format":"double"},"outputPerToken":{"type":"string"}},"required":["inputPer1MTokens","inputPerToken","outputPer1MTokens","outputPerToken"],"title":"ExtractionModelPricing"},"ExtractionModelProvider":{"type":"string","enum":["cloudflare"],"title":"ExtractionModelProvider"},"ExtractionModelRoute":{"type":"string","enum":["cloudflare-workers-ai"],"title":"ExtractionModelRoute"},"ExtractionModel":{"type":"object","properties":{"contextWindow":{"type":"integer"},"credentialRequirements":{"$ref":"#/components/schemas/ExtractionModelCredentialRequirements"},"description":{"type":"string"},"docsUrl":{"type":"string"},"id":{"type":"string"},"maxImageBytes":{"type":"integer"},"maxImages":{"type":"integer"},"maxTotalImageBytes":{"type":"integer"},"name":{"type":"string"},"passTokens":{"type":"integer"},"platformFunding":{"type":"boolean"},"pricing":{"$ref":"#/components/schemas/ExtractionModelPricing"},"provider":{"$ref":"#/components/schemas/ExtractionModelProvider"},"providerModelId":{"type":"string"},"route":{"$ref":"#/components/schemas/ExtractionModelRoute"}},"required":["contextWindow","credentialRequirements","description","docsUrl","id","maxImageBytes","maxImages","maxTotalImageBytes","name","passTokens","platformFunding","pricing","provider","providerModelId","route"],"title":"ExtractionModel"},"Extraction_Models_listExtractionModels_Response_200":{"type":"object","properties":{"models":{"type":"array","items":{"$ref":"#/components/schemas/ExtractionModel"}}},"required":["models"],"title":"Extraction Models_listExtractionModels_Response_200"},"RuntimeExtractionRequestOptions":{"type":"object","properties":{"includeQuantiles":{"type":"boolean"},"returnStateText":{"type":"boolean"}},"title":"RuntimeExtractionRequestOptions"},"RuntimeExtractionRequest":{"type":"object","properties":{"executionId":{"type":"string","minLength":1,"description":"The self-hosted execution asking, recorded on the extraction telemetry."},"fields":{"type":"object","additionalProperties":{"description":"Any type"},"description":"Field name to field spec, each `{ type: \"text\" | \"number\" | \"date\" | \"time\" | \"datetime\" | \"duration\" | \"list\" | \"estimate\" | \"forecast\", instructions?, ... }`. Refused with `EXTRACTION_FIELDS_INVALID` and one sentence per problem."},"images":{"type":"array","items":{"description":"Any type"},"description":"Up to the model limit of embedded images: data: URLs or `{ contentType, base64 }`. Remote URLs are refused."},"model":{"type":"string","minLength":1,"description":"Extraction model id; defaults to the platform default."},"options":{"$ref":"#/components/schemas/RuntimeExtractionRequestOptions"},"referenceDate":{"type":"string","description":"ISO date anchoring dates written without a year."},"state":{"type":"string","description":"The text to read. Never echoed in errors or logs."},"stepId":{"type":"string","minLength":1}},"required":["fields","state"],"title":"RuntimeExtractionRequest"},"RuntimeExtractionMetadataKeySource":{"type":"string","enum":["user","platform"],"title":"RuntimeExtractionMetadataKeySource"},"RuntimeExtractionMetadataUsage":{"type":"object","properties":{"inputTokens":{"type":"number","format":"double"},"outputTokens":{"type":"number","format":"double"},"passes":{"type":"number","format":"double"},"reported":{"type":"boolean"}},"required":["inputTokens","outputTokens","reported"],"title":"RuntimeExtractionMetadataUsage"},"RuntimeExtractionMetadata":{"type":"object","properties":{"estimatedCostUsd":{"type":"number","format":"double","description":"Provider rates, before margin."},"keySource":{"$ref":"#/components/schemas/RuntimeExtractionMetadataKeySource"},"provider":{"type":"string"},"requestedModel":{"type":"string"},"resolvedModelId":{"type":["string","null"]},"route":{"type":"string"},"usage":{"$ref":"#/components/schemas/RuntimeExtractionMetadataUsage"}},"required":["keySource","provider","requestedModel","resolvedModelId","route","usage"],"title":"RuntimeExtractionMetadata"},"RuntimeExtractionResponse":{"type":"object","properties":{"answers":{"type":"object","additionalProperties":{"description":"Any type"},"description":"One answer per field: value, confidence, pNull, span(s) and estimate intervals."},"extraction":{"$ref":"#/components/schemas/RuntimeExtractionMetadata"},"model":{"type":"string"},"stateText":{"type":"string","description":"The text answer spans index into; present only when `options.returnStateText` asked for it."},"truncated":{"type":"boolean"},"usage":{"type":"object","additionalProperties":{"description":"Any type"}},"values":{"type":"object","additionalProperties":{"description":"Any type"},"description":"One value per field; null when the input does not determine it."}},"required":["answers","extraction","model","truncated","usage","values"],"title":"RuntimeExtractionResponse"},"ExtractTypedFieldsHostedExtractionProviderRequestBadRequestError":{"type":"object","properties":{"code":{"type":"string","description":"Stable code for a caller-fixable failure, e.g. EXTRACTION_FIELDS_INVALID or EXTRACTION_MODEL_UNKNOWN."},"details":{"type":"object","additionalProperties":{"description":"Any type"}},"error":{"type":"string"},"requiredScopes":{"type":"array","items":{"type":"string"},"description":"On `insufficient_scope`: every API key scope this request needs."}},"required":["error"],"title":"ExtractTypedFieldsHostedExtractionProviderRequestBadRequestError"},"ExtractTypedFieldsHostedExtractionProviderRequestUnprocessableEntityError":{"type":"object","properties":{"code":{"type":"string","description":"Stable code for a caller-fixable failure, e.g. EXTRACTION_FIELDS_INVALID or EXTRACTION_MODEL_UNKNOWN."},"details":{"type":"object","additionalProperties":{"description":"Any type"}},"error":{"type":"string"},"requiredScopes":{"type":"array","items":{"type":"string"},"description":"On `insufficient_scope`: every API key scope this request needs."}},"required":["error"],"title":"ExtractTypedFieldsHostedExtractionProviderRequestUnprocessableEntityError"},"V1FeedbackGetResponsesContentApplicationJsonSchemaFeedbackItems":{"type":"object","properties":{"comment":{"type":["string","null"]},"createdAt":{"type":"string"},"feedbackType":{"type":"string"},"flowId":{"type":["string","null"]},"id":{"type":"string"},"messageId":{"type":["string","null"]},"messageIndex":{"type":["number","null"],"format":"double"},"messageRole":{"type":["string","null"]},"rating":{"type":["number","null"],"format":"double"},"recordId":{"type":["string","null"]}},"required":["comment","createdAt","feedbackType","flowId","id","messageId","messageIndex","messageRole","rating","recordId"],"title":"V1FeedbackGetResponsesContentApplicationJsonSchemaFeedbackItems"},"V1FeedbackGetResponsesContentApplicationJsonSchemaPagination":{"type":"object","properties":{"hasMore":{"type":"boolean"},"limit":{"type":"integer"},"offset":{"type":"integer"}},"required":["hasMore","limit","offset"],"title":"V1FeedbackGetResponsesContentApplicationJsonSchemaPagination"},"Feedback_listFeedbackWithFilters_Response_200":{"type":"object","properties":{"feedback":{"type":"array","items":{"$ref":"#/components/schemas/V1FeedbackGetResponsesContentApplicationJsonSchemaFeedbackItems"}},"pagination":{"$ref":"#/components/schemas/V1FeedbackGetResponsesContentApplicationJsonSchemaPagination"}},"required":["feedback","pagination"],"title":"Feedback_listFeedbackWithFilters_Response_200"},"Feedback_submitFeedbackOnAMessage_Response_200":{"type":"object","properties":{"feedbackId":{"type":"string"},"message":{"type":"string"},"success":{"type":"boolean"}},"required":["feedbackId","message","success"],"title":"Feedback_submitFeedbackOnAMessage_Response_200"},"V1FeedbackStatsGetResponsesContentApplicationJsonSchemaStatsCsat":{"type":"object","properties":{"average":{"type":"number","format":"double"},"count":{"type":"integer"},"distribution":{"type":"object","additionalProperties":{"type":"integer"}}},"required":["average","count","distribution"],"title":"V1FeedbackStatsGetResponsesContentApplicationJsonSchemaStatsCsat"},"V1FeedbackStatsGetResponsesContentApplicationJsonSchemaStatsNps":{"type":"object","properties":{"count":{"type":"integer"},"detractors":{"type":"integer"},"passives":{"type":"integer"},"promoters":{"type":"integer"},"score":{"type":"integer"}},"required":["count","detractors","passives","promoters","score"],"title":"V1FeedbackStatsGetResponsesContentApplicationJsonSchemaStatsNps"},"V1FeedbackStatsGetResponsesContentApplicationJsonSchemaStats":{"type":"object","properties":{"copies":{"type":"integer"},"csat":{"$ref":"#/components/schemas/V1FeedbackStatsGetResponsesContentApplicationJsonSchemaStatsCsat"},"downvotes":{"type":"integer"},"netScore":{"type":"integer"},"nps":{"$ref":"#/components/schemas/V1FeedbackStatsGetResponsesContentApplicationJsonSchemaStatsNps"},"total":{"type":"integer"},"upvotes":{"type":"integer"}},"required":["copies","downvotes","netScore","total","upvotes"],"title":"V1FeedbackStatsGetResponsesContentApplicationJsonSchemaStats"},"Feedback_getFeedbackStatistics_Response_200":{"type":"object","properties":{"stats":{"$ref":"#/components/schemas/V1FeedbackStatsGetResponsesContentApplicationJsonSchemaStats"}},"required":["stats"],"title":"Feedback_getFeedbackStatistics_Response_200"},"V1FeedbackIdGetResponsesContentApplicationJsonSchemaFeedback":{"type":"object","properties":{"clientTokenId":{"type":["string","null"]},"comment":{"type":["string","null"]},"createdAt":{"type":"string"},"feedbackType":{"type":"string"},"flowId":{"type":["string","null"]},"id":{"type":"string"},"messageId":{"type":["string","null"]},"messageIndex":{"type":["number","null"],"format":"double"},"messageRole":{"type":["string","null"]},"metadata":{"type":["object","null"],"additionalProperties":{"description":"Any type"}},"rating":{"type":["number","null"],"format":"double"},"recordId":{"type":["string","null"]},"sessionId":{"type":["string","null"]}},"required":["clientTokenId","comment","createdAt","feedbackType","flowId","id","messageId","messageIndex","messageRole","metadata","rating","recordId","sessionId"],"title":"V1FeedbackIdGetResponsesContentApplicationJsonSchemaFeedback"},"Feedback_getSpecificFeedbackRecord_Response_200":{"type":"object","properties":{"feedback":{"$ref":"#/components/schemas/V1FeedbackIdGetResponsesContentApplicationJsonSchemaFeedback"}},"required":["feedback"],"title":"Feedback_getSpecificFeedbackRecord_Response_200"},"Feedback_deleteFeedbackRecord_Response_200":{"type":"object","properties":{"message":{"type":"string"},"success":{"type":"boolean"}},"required":["message","success"],"title":"Feedback_deleteFeedbackRecord_Response_200"},"V1FlowStepsFlowFlowIdGetResponsesContentApplicationJsonSchemaDataItems":{"type":"object","properties":{"config":{"type":"object","additionalProperties":{"description":"Any type"}},"createdAt":{"description":"Any type"},"enabled":{"type":"boolean"},"flowId":{"type":"string"},"id":{"type":"string"},"name":{"type":"string"},"order":{"type":"integer"},"type":{"type":"string"},"updatedAt":{"description":"Any type"},"userId":{"type":"string"},"when":{"type":"string"}},"required":["config","createdAt","enabled","flowId","id","order","type","updatedAt","userId"],"title":"V1FlowStepsFlowFlowIdGetResponsesContentApplicationJsonSchemaDataItems"},"Flow_Steps_getAllFlowStepsForAFlow_Response_200":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1FlowStepsFlowFlowIdGetResponsesContentApplicationJsonSchemaDataItems"}},"flowId":{"type":"string"},"flowName":{"type":"string"}},"required":["data","flowId","flowName"],"title":"Flow Steps_getAllFlowStepsForAFlow_Response_200"},"V1FlowVersionsFlowIdGetParametersType":{"type":"string","enum":["published","draft","test","virtual"],"title":"V1FlowVersionsFlowIdGetParametersType"},"V1FlowVersionsFlowIdGetResponsesContentApplicationJsonSchemaVersionsItems":{"type":"object","properties":{"createdAt":{"type":"string"},"id":{"type":"string"},"label":{"type":["string","null"]},"notes":{"type":["string","null"]},"publishedAt":{"type":["string","null"]},"savedVersionNumber":{"type":["integer","null"]},"stepCount":{"type":"integer"},"stepSummary":{"type":["string","null"]},"userId":{"type":"string"},"versionNumber":{"type":"integer"},"versionType":{"type":"string"}},"required":["createdAt","id","label","notes","publishedAt","savedVersionNumber","stepCount","stepSummary","userId","versionNumber","versionType"],"title":"V1FlowVersionsFlowIdGetResponsesContentApplicationJsonSchemaVersionsItems"},"Flow_Versions_listVersionsForAFlow_Response_200":{"type":"object","properties":{"draftVersionId":{"type":["string","null"]},"draftVersionMatchesConfig":{"type":"boolean"},"flowId":{"type":"string"},"publishedVersionId":{"type":["string","null"]},"versions":{"type":"array","items":{"$ref":"#/components/schemas/V1FlowVersionsFlowIdGetResponsesContentApplicationJsonSchemaVersionsItems"}}},"required":["draftVersionId","flowId","publishedVersionId","versions"],"title":"Flow Versions_listVersionsForAFlow_Response_200"},"V1FlowVersionsFlowIdPublishPostRequestBodyContentApplicationJsonSchemaOnConflict":{"type":"string","enum":["error","overwrite"],"default":"error","description":"Use overwrite only after confirming replacement of a code-managed flow.","title":"V1FlowVersionsFlowIdPublishPostRequestBodyContentApplicationJsonSchemaOnConflict"},"V1FlowVersionsFlowIdPublishPostResponsesContentApplicationJsonSchemaLastModifiedSource":{"type":"string","enum":["sdk","terraform"],"title":"V1FlowVersionsFlowIdPublishPostResponsesContentApplicationJsonSchemaLastModifiedSource"},"Flow_Versions_publishASpecificFlowVersion_Response_200":{"type":"object","properties":{"applied":{"type":"object","additionalProperties":{"type":"boolean"}},"flowId":{"type":"string"},"lastModifiedSource":{"$ref":"#/components/schemas/V1FlowVersionsFlowIdPublishPostResponsesContentApplicationJsonSchemaLastModifiedSource"},"message":{"type":"string"},"success":{"type":"boolean"},"versionId":{"type":"string"},"warnings":{"type":"array","items":{"type":"string"}}},"required":["applied","flowId","lastModifiedSource","message","success","versionId","warnings"],"title":"Flow Versions_publishASpecificFlowVersion_Response_200"},"V1FlowVersionsFlowIdPublishPostResponsesContentApplicationJsonSchemaDetailsItems":{"type":"object","properties":{"code":{"type":"string","description":"Stable Runtype validation code (e.g. MISSING_REQUIRED_FIELD, INVALID_ENUM)."},"message":{"type":"string"},"path":{"type":"string","description":"Dotted JSON path to the offending field."},"suggestion":{"type":"string","description":"Actionable hint (allowed values, accepted range, …)."}},"required":["message"],"title":"V1FlowVersionsFlowIdPublishPostResponsesContentApplicationJsonSchemaDetailsItems"},"PublishASpecificFlowVersionRequestBadRequestError":{"type":"object","properties":{"code":{"type":"string","description":"Stable error code. `insufficient_scope` marks an API key that lacks a scope this request needs."},"details":{"type":"array","items":{"$ref":"#/components/schemas/V1FlowVersionsFlowIdPublishPostResponsesContentApplicationJsonSchemaDetailsItems"}},"error":{"type":"string"},"requiredScopes":{"type":"array","items":{"type":"string"},"description":"On `insufficient_scope`: every API key scope this request needs."}},"required":["error"],"title":"PublishASpecificFlowVersionRequestBadRequestError"},"V1FlowVersionsFlowIdPublishPostResponsesContentApplicationJsonSchemaCode":{"type":"string","enum":["managed_by_code_conflict"],"description":"Stable error code. `insufficient_scope` marks an API key that lacks a scope this request needs.","title":"V1FlowVersionsFlowIdPublishPostResponsesContentApplicationJsonSchemaCode"},"PublishASpecificFlowVersionRequestConflictError":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/V1FlowVersionsFlowIdPublishPostResponsesContentApplicationJsonSchemaCode","description":"Stable error code. `insufficient_scope` marks an API key that lacks a scope this request needs."},"details":{"type":"array","items":{"$ref":"#/components/schemas/V1FlowVersionsFlowIdPublishPostResponsesContentApplicationJsonSchemaDetailsItems"}},"error":{"type":"string"},"requiredScopes":{"type":"array","items":{"type":"string"},"description":"On `insufficient_scope`: every API key scope this request needs."},"lastModifiedSource":{"$ref":"#/components/schemas/V1FlowVersionsFlowIdPublishPostResponsesContentApplicationJsonSchemaLastModifiedSource"}},"required":["code","error","lastModifiedSource"],"title":"PublishASpecificFlowVersionRequestConflictError"},"Flow_Versions_getThePublishedVersionForAFlow_Response_200":{"type":"object","properties":{"createdAt":{"type":"string"},"flowConfig":{"type":["object","null"],"additionalProperties":{"description":"Any type"}},"flowId":{"type":"string"},"id":{"type":"string"},"label":{"type":["string","null"]},"notes":{"type":["string","null"]},"publishedAt":{"type":["string","null"]},"savedVersionNumber":{"type":["integer","null"]},"userId":{"type":"string"},"versionNumber":{"type":"integer"},"versionType":{"type":"string"}},"required":["createdAt","flowConfig","flowId","id","label","notes","publishedAt","savedVersionNumber","userId","versionNumber","versionType"],"title":"Flow Versions_getThePublishedVersionForAFlow_Response_200"},"Flow_Versions_getASpecificFlowVersion_Response_200":{"type":"object","properties":{"createdAt":{"type":"string"},"flowConfig":{"type":["object","null"],"additionalProperties":{"description":"Any type"}},"flowId":{"type":"string"},"id":{"type":"string"},"label":{"type":["string","null"]},"notes":{"type":["string","null"]},"publishedAt":{"type":["string","null"]},"savedVersionNumber":{"type":["integer","null"]},"userId":{"type":"string"},"versionNumber":{"type":"integer"},"versionType":{"type":"string"}},"required":["createdAt","flowConfig","flowId","id","label","notes","publishedAt","savedVersionNumber","userId","versionNumber","versionType"],"title":"Flow Versions_getASpecificFlowVersion_Response_200"},"V1FlowsGetParametersView":{"type":"string","enum":["full","compact"],"description":"Response representation. `full` (default) preserves complete values; `compact` shortens every string value longer than 100 characters to a 100-character preview followed by `…`.","title":"V1FlowsGetParametersView"},"V1FlowsGetParametersInclude":{"type":"string","enum":["usage"],"description":"usage adds each flow usage: the model ids its steps name and the record types its steps write.","title":"V1FlowsGetParametersInclude"},"V1FlowsGetResponsesContentApplicationJsonSchemaDataItemsUsage":{"type":"object","properties":{"models":{"type":"array","items":{"type":"string"},"description":"Model ids the flow steps name, each once."},"recordTypesWritten":{"type":"array","items":{"type":"string"},"description":"Record types the upsert-record and update-record steps write, each once."}},"required":["models","recordTypesWritten"],"description":"What the saved flow steps reach. Present only when the request asked for include=usage.","title":"V1FlowsGetResponsesContentApplicationJsonSchemaDataItemsUsage"},"V1FlowsGetResponsesContentApplicationJsonSchemaDataItems":{"type":"object","properties":{"createdAt":{"type":"string"},"draftVersionId":{"type":["string","null"]},"id":{"type":"string"},"lastModifiedSource":{"type":["string","null"]},"lastRunAt":{"type":["string","null"]},"name":{"type":"string"},"publishedVersionId":{"type":["string","null"],"description":"The live version id, or null while the flow has never been published."},"updatedAt":{"type":"string"},"usage":{"$ref":"#/components/schemas/V1FlowsGetResponsesContentApplicationJsonSchemaDataItemsUsage","description":"What the saved flow steps reach. Present only when the request asked for include=usage."}},"required":["createdAt","draftVersionId","id","lastModifiedSource","lastRunAt","name","publishedVersionId","updatedAt"],"title":"V1FlowsGetResponsesContentApplicationJsonSchemaDataItems"},"Flows_listFlows_Response_200":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1FlowsGetResponsesContentApplicationJsonSchemaDataItems"}},"pagination":{"$ref":"#/components/schemas/Pagination"}},"required":["data","pagination"],"title":"Flows_listFlows_Response_200"},"V1FlowsPostRequestBodyContentApplicationJsonSchemaFlowStepsItemsType":{"type":"string","enum":["prompt","crawl","fetch-url","retrieve-record","get-record","list-records","api-call","transform-data","template","conditional","loop","set-variable","upsert-record","send-email","send-event","send-stream","update-record","search","generate-embedding","vector-search","tool-call","wait-until","paginate-api","store-vector","execute-agent","store-asset","generate-pdf","save-memory","recall-memory","memory-summary","extract"],"title":"V1FlowsPostRequestBodyContentApplicationJsonSchemaFlowStepsItemsType"},"V1FlowsPostRequestBodyContentApplicationJsonSchemaFlowStepsItems":{"type":"object","properties":{"config":{"description":"Any type"},"enabled":{"type":"boolean","default":true},"id":{"type":"string","pattern":"^[A-Za-z0-9_\\-:.]+$","minLength":1,"maxLength":128},"name":{"type":"string","minLength":1},"order":{"type":"integer","minimum":0},"type":{"$ref":"#/components/schemas/V1FlowsPostRequestBodyContentApplicationJsonSchemaFlowStepsItemsType"},"when":{"type":"string","maxLength":500}},"required":["name","type"],"title":"V1FlowsPostRequestBodyContentApplicationJsonSchemaFlowStepsItems"},"V1FlowsPostRequestBodyContentApplicationJsonSchemaInputsItemsType":{"type":"string","enum":["string","number","boolean","object","array"],"description":"Expected value type.","title":"V1FlowsPostRequestBodyContentApplicationJsonSchemaInputsItemsType"},"V1FlowsPostRequestBodyContentApplicationJsonSchemaInputsItems":{"type":"object","properties":{"description":{"type":"string","maxLength":500,"description":"Short explanation of the value."},"name":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9_]*$","minLength":1,"maxLength":128,"description":"Variable name, referenced in steps as {{name}}."},"required":{"type":"boolean","description":"Whether callers must supply it. Stored only; not enforced at run time yet."},"type":{"$ref":"#/components/schemas/V1FlowsPostRequestBodyContentApplicationJsonSchemaInputsItemsType","description":"Expected value type."}},"required":["name"],"title":"V1FlowsPostRequestBodyContentApplicationJsonSchemaInputsItems"},"V1FlowsPostRequestBodyContentApplicationJsonSchemaStepsItemsType":{"type":"string","enum":["prompt","crawl","fetch-url","retrieve-record","get-record","list-records","api-call","transform-data","template","conditional","loop","set-variable","upsert-record","send-email","send-event","send-stream","update-record","search","generate-embedding","vector-search","tool-call","wait-until","paginate-api","store-vector","execute-agent","store-asset","generate-pdf","save-memory","recall-memory","memory-summary","extract"],"title":"V1FlowsPostRequestBodyContentApplicationJsonSchemaStepsItemsType"},"V1FlowsPostRequestBodyContentApplicationJsonSchemaStepsItems":{"type":"object","properties":{"config":{"description":"Any type"},"enabled":{"type":"boolean","default":true},"id":{"type":"string","pattern":"^[A-Za-z0-9_\\-:.]+$","minLength":1,"maxLength":128},"name":{"type":"string","minLength":1},"order":{"type":"integer","minimum":0},"type":{"$ref":"#/components/schemas/V1FlowsPostRequestBodyContentApplicationJsonSchemaStepsItemsType"},"when":{"type":"string","maxLength":500}},"required":["name","type"],"title":"V1FlowsPostRequestBodyContentApplicationJsonSchemaStepsItems"},"V1FlowsPostResponsesContentApplicationJsonSchemaFlowStepsItems":{"type":"object","properties":{"config":{"type":"object","additionalProperties":{"description":"Any type"}},"enabled":{"type":"boolean"},"id":{"type":"string"},"name":{"type":"string"},"order":{"type":"integer"},"type":{"type":"string"}},"required":["id","type"],"title":"V1FlowsPostResponsesContentApplicationJsonSchemaFlowStepsItems"},"V1FlowsPostResponsesContentApplicationJsonSchemaInputsItemsType":{"type":"string","enum":["string","number","boolean","object","array"],"description":"Expected value type.","title":"V1FlowsPostResponsesContentApplicationJsonSchemaInputsItemsType"},"V1FlowsPostResponsesContentApplicationJsonSchemaInputsItems":{"type":"object","properties":{"description":{"type":"string","maxLength":500,"description":"Short explanation of the value."},"name":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9_]*$","minLength":1,"maxLength":128,"description":"Variable name, referenced in steps as {{name}}."},"required":{"type":"boolean","description":"Whether callers must supply it. Stored only; not enforced at run time yet."},"type":{"$ref":"#/components/schemas/V1FlowsPostResponsesContentApplicationJsonSchemaInputsItemsType","description":"Expected value type."}},"required":["name"],"title":"V1FlowsPostResponsesContentApplicationJsonSchemaInputsItems"},"Flows_createFlow_Response_201":{"type":"object","properties":{"createdAt":{"type":"string"},"dashboardUrl":{"type":"string"},"description":{"type":["string","null"]},"draftVersionId":{"type":["string","null"]},"flowSteps":{"type":"array","items":{"$ref":"#/components/schemas/V1FlowsPostResponsesContentApplicationJsonSchemaFlowStepsItems"}},"id":{"type":"string"},"inputs":{"type":"array","items":{"$ref":"#/components/schemas/V1FlowsPostResponsesContentApplicationJsonSchemaInputsItems"},"description":"Inputs the flow expects its caller to supply. Absent when none are declared."},"lastModifiedSource":{"type":["string","null"]},"lastRunAt":{"type":["string","null"]},"name":{"type":"string"},"organizationId":{"type":["string","null"]},"publishedVersionId":{"type":["string","null"]},"sampleMetadata":{"type":"object","additionalProperties":{"description":"Any type"}},"stepCount":{"type":"integer"},"updatedAt":{"type":"string"},"userId":{"type":"string"}},"required":["createdAt","flowSteps","id","lastModifiedSource","name","organizationId","updatedAt","userId"],"title":"Flows_createFlow_Response_201"},"V1FlowsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionStepsItems":{"type":"object","properties":{"config":{"type":"object","additionalProperties":{"description":"Any type"}},"enabled":{"type":"boolean"},"name":{"type":"string","minLength":1},"order":{"type":"integer"},"type":{"type":"string","minLength":1},"when":{"type":"string"}},"required":["name","type"],"title":"V1FlowsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionStepsItems"},"V1FlowsEnsurePostRequestBodyContentApplicationJsonSchemaDefinition":{"type":"object","properties":{"name":{"type":"string","minLength":1},"steps":{"type":"array","items":{"$ref":"#/components/schemas/V1FlowsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionStepsItems"}}},"required":["name","steps"],"title":"V1FlowsEnsurePostRequestBodyContentApplicationJsonSchemaDefinition"},"V1FlowsEnsurePostRequestBodyContentApplicationJsonSchemaOnConflict":{"type":"string","enum":["error","overwrite"],"title":"V1FlowsEnsurePostRequestBodyContentApplicationJsonSchemaOnConflict"},"V1FlowsEnsurePostRequestBodyContentApplicationJsonSchemaRelease":{"type":"string","enum":["none","publish"],"title":"V1FlowsEnsurePostRequestBodyContentApplicationJsonSchemaRelease"},"FlowEnsureResponseOneOf0Result":{"type":"string","enum":["unchanged","created","updated"],"title":"FlowEnsureResponseOneOf0Result"},"FlowEnsureResponse0":{"type":"object","properties":{"contentHash":{"type":"string","description":"Server-computed canonical content hash. Clients should echo this hash in probes."},"flowId":{"type":"string"},"result":{"$ref":"#/components/schemas/FlowEnsureResponseOneOf0Result"},"versionId":{"type":["string","null"],"description":"The version snapshot backing this state (null if snapshotting failed)."}},"required":["contentHash","flowId","result","versionId"],"title":"FlowEnsureResponse0"},"FlowEnsureResponseOneOf1Result":{"type":"string","enum":["definitionRequired"],"title":"FlowEnsureResponseOneOf1Result"},"FlowEnsureResponse1":{"type":"object","properties":{"result":{"$ref":"#/components/schemas/FlowEnsureResponseOneOf1Result"}},"required":["result"],"title":"FlowEnsureResponse1"},"FlowEnsureResponseOneOf2Changes":{"type":"string","enum":["none","create","update"],"title":"FlowEnsureResponseOneOf2Changes"},"FlowEnsureResponseOneOf2Result":{"type":"string","enum":["plan"],"title":"FlowEnsureResponseOneOf2Result"},"FlowEnsureResponse2":{"type":"object","properties":{"changedKeys":{"type":"array","items":{"type":"string"}},"changes":{"$ref":"#/components/schemas/FlowEnsureResponseOneOf2Changes"},"contentHash":{"type":"string"},"flowId":{"type":"string"},"publishPending":{"type":"boolean","description":"Present when the dry run carried release: \"publish\": whether the converge would re-aim the published version."},"remoteHash":{"type":"string"},"result":{"$ref":"#/components/schemas/FlowEnsureResponseOneOf2Result"}},"required":["changedKeys","changes","contentHash","result"],"title":"FlowEnsureResponse2"},"FlowEnsureResponse":{"oneOf":[{"$ref":"#/components/schemas/FlowEnsureResponse0"},{"$ref":"#/components/schemas/FlowEnsureResponse1"},{"$ref":"#/components/schemas/FlowEnsureResponse2"}],"title":"FlowEnsureResponse"},"FlowEnsureConflictCode":{"type":"string","enum":["external_modification","remote_changed"],"title":"FlowEnsureConflictCode"},"FlowEnsureConflict":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/FlowEnsureConflictCode"},"currentHash":{"type":["string","null"]},"error":{"type":"string"},"lastModifiedSource":{"type":"string"},"modifiedAt":{"type":["string","null"]}},"required":["code","error"],"title":"FlowEnsureConflict"},"FlowEnsureHashMismatchCode":{"type":"string","enum":["content_hash_mismatch"],"title":"FlowEnsureHashMismatchCode"},"FlowEnsureHashMismatch":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/FlowEnsureHashMismatchCode"},"contentHash":{"type":"string","description":"The server-computed canonical hash of the submitted definition."},"error":{"type":"string"}},"required":["code","contentHash","error"],"title":"FlowEnsureHashMismatch"},"FlowPullResponseDefinitionStepsItems":{"type":"object","properties":{"config":{"type":"object","additionalProperties":{"description":"Any type"}},"enabled":{"type":"boolean"},"name":{"type":"string","minLength":1},"order":{"type":"integer"},"type":{"type":"string","minLength":1},"when":{"type":"string"}},"required":["name","type"],"title":"FlowPullResponseDefinitionStepsItems"},"FlowPullResponseDefinition":{"type":"object","properties":{"name":{"type":"string","minLength":1},"steps":{"type":"array","items":{"$ref":"#/components/schemas/FlowPullResponseDefinitionStepsItems"}}},"required":["name","steps"],"title":"FlowPullResponseDefinition"},"FlowPullResponse":{"type":"object","properties":{"contentHash":{"type":"string"},"definition":{"$ref":"#/components/schemas/FlowPullResponseDefinition"},"flowId":{"type":"string"},"lastModifiedSource":{"type":["string","null"]},"updatedAt":{"type":["string","null"]},"versionId":{"type":["string","null"]},"warnings":{"type":"array","items":{"type":"string"},"description":"Present only when a raw tool_… reference could not be emitted as a portable tool:<name> (the tool was deleted, or its name is shadowed by an older same-named tool). Those references are left as raw ids, which the ensure surface rejects; each warning explains how to fix it."}},"required":["contentHash","definition","flowId","lastModifiedSource","updatedAt","versionId"],"title":"FlowPullResponse"},"V1FlowsIdGetResponsesContentApplicationJsonSchemaFlowStepsItems":{"type":"object","properties":{"config":{"type":"object","additionalProperties":{"description":"Any type"}},"enabled":{"type":"boolean"},"id":{"type":"string"},"name":{"type":"string"},"order":{"type":"integer"},"type":{"type":"string"}},"required":["id","type"],"title":"V1FlowsIdGetResponsesContentApplicationJsonSchemaFlowStepsItems"},"V1FlowsIdGetResponsesContentApplicationJsonSchemaInputsItemsType":{"type":"string","enum":["string","number","boolean","object","array"],"description":"Expected value type.","title":"V1FlowsIdGetResponsesContentApplicationJsonSchemaInputsItemsType"},"V1FlowsIdGetResponsesContentApplicationJsonSchemaInputsItems":{"type":"object","properties":{"description":{"type":"string","maxLength":500,"description":"Short explanation of the value."},"name":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9_]*$","minLength":1,"maxLength":128,"description":"Variable name, referenced in steps as {{name}}."},"required":{"type":"boolean","description":"Whether callers must supply it. Stored only; not enforced at run time yet."},"type":{"$ref":"#/components/schemas/V1FlowsIdGetResponsesContentApplicationJsonSchemaInputsItemsType","description":"Expected value type."}},"required":["name"],"title":"V1FlowsIdGetResponsesContentApplicationJsonSchemaInputsItems"},"Flows_getFlowDetails_Response_200":{"type":"object","properties":{"createdAt":{"type":"string"},"dashboardUrl":{"type":"string"},"description":{"type":["string","null"]},"draftVersionId":{"type":["string","null"]},"flowSteps":{"type":"array","items":{"$ref":"#/components/schemas/V1FlowsIdGetResponsesContentApplicationJsonSchemaFlowStepsItems"}},"id":{"type":"string"},"inputs":{"type":"array","items":{"$ref":"#/components/schemas/V1FlowsIdGetResponsesContentApplicationJsonSchemaInputsItems"},"description":"Inputs the flow expects its caller to supply. Absent when none are declared."},"lastModifiedSource":{"type":["string","null"]},"lastRunAt":{"type":["string","null"]},"name":{"type":"string"},"organizationId":{"type":["string","null"]},"publishedVersionId":{"type":["string","null"]},"sampleMetadata":{"type":"object","additionalProperties":{"description":"Any type"}},"stepCount":{"type":"integer"},"updatedAt":{"type":"string"},"userId":{"type":"string"}},"required":["createdAt","flowSteps","id","lastModifiedSource","name","organizationId","updatedAt","userId"],"title":"Flows_getFlowDetails_Response_200"},"V1FlowsIdPutRequestBodyContentApplicationJsonSchemaFlowStepsItemsType":{"type":"string","enum":["prompt","crawl","fetch-url","retrieve-record","get-record","list-records","api-call","transform-data","template","conditional","loop","set-variable","upsert-record","send-email","send-event","send-stream","update-record","search","generate-embedding","vector-search","tool-call","wait-until","paginate-api","store-vector","execute-agent","store-asset","generate-pdf","save-memory","recall-memory","memory-summary","extract"],"title":"V1FlowsIdPutRequestBodyContentApplicationJsonSchemaFlowStepsItemsType"},"V1FlowsIdPutRequestBodyContentApplicationJsonSchemaFlowStepsItems":{"type":"object","properties":{"config":{"description":"Any type"},"enabled":{"type":"boolean","default":true},"id":{"type":"string","pattern":"^[A-Za-z0-9_\\-:.]+$","minLength":1,"maxLength":128},"name":{"type":"string","minLength":1},"order":{"type":"integer","minimum":0},"type":{"$ref":"#/components/schemas/V1FlowsIdPutRequestBodyContentApplicationJsonSchemaFlowStepsItemsType"},"when":{"type":"string","maxLength":500}},"required":["name","type"],"title":"V1FlowsIdPutRequestBodyContentApplicationJsonSchemaFlowStepsItems"},"V1FlowsIdPutRequestBodyContentApplicationJsonSchemaInputsItemsType":{"type":"string","enum":["string","number","boolean","object","array"],"description":"Expected value type.","title":"V1FlowsIdPutRequestBodyContentApplicationJsonSchemaInputsItemsType"},"V1FlowsIdPutRequestBodyContentApplicationJsonSchemaInputsItems":{"type":"object","properties":{"description":{"type":"string","maxLength":500,"description":"Short explanation of the value."},"name":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9_]*$","minLength":1,"maxLength":128,"description":"Variable name, referenced in steps as {{name}}."},"required":{"type":"boolean","description":"Whether callers must supply it. Stored only; not enforced at run time yet."},"type":{"$ref":"#/components/schemas/V1FlowsIdPutRequestBodyContentApplicationJsonSchemaInputsItemsType","description":"Expected value type."}},"required":["name"],"title":"V1FlowsIdPutRequestBodyContentApplicationJsonSchemaInputsItems"},"V1FlowsIdPutResponsesContentApplicationJsonSchemaFlowStepsItems":{"type":"object","properties":{"config":{"type":"object","additionalProperties":{"description":"Any type"}},"enabled":{"type":"boolean"},"id":{"type":"string"},"name":{"type":"string"},"order":{"type":"integer"},"type":{"type":"string"}},"required":["id","type"],"title":"V1FlowsIdPutResponsesContentApplicationJsonSchemaFlowStepsItems"},"V1FlowsIdPutResponsesContentApplicationJsonSchemaInputsItemsType":{"type":"string","enum":["string","number","boolean","object","array"],"description":"Expected value type.","title":"V1FlowsIdPutResponsesContentApplicationJsonSchemaInputsItemsType"},"V1FlowsIdPutResponsesContentApplicationJsonSchemaInputsItems":{"type":"object","properties":{"description":{"type":"string","maxLength":500,"description":"Short explanation of the value."},"name":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9_]*$","minLength":1,"maxLength":128,"description":"Variable name, referenced in steps as {{name}}."},"required":{"type":"boolean","description":"Whether callers must supply it. Stored only; not enforced at run time yet."},"type":{"$ref":"#/components/schemas/V1FlowsIdPutResponsesContentApplicationJsonSchemaInputsItemsType","description":"Expected value type."}},"required":["name"],"title":"V1FlowsIdPutResponsesContentApplicationJsonSchemaInputsItems"},"Flows_updateFlow_Response_200":{"type":"object","properties":{"createdAt":{"type":"string"},"dashboardUrl":{"type":"string"},"description":{"type":["string","null"]},"draftVersionId":{"type":"string"},"flowSteps":{"type":"array","items":{"$ref":"#/components/schemas/V1FlowsIdPutResponsesContentApplicationJsonSchemaFlowStepsItems"}},"id":{"type":"string"},"inputs":{"type":"array","items":{"$ref":"#/components/schemas/V1FlowsIdPutResponsesContentApplicationJsonSchemaInputsItems"},"description":"Inputs the flow expects its caller to supply. Absent when none are declared."},"lastModifiedSource":{"type":["string","null"]},"lastRunAt":{"type":["string","null"]},"name":{"type":"string"},"organizationId":{"type":["string","null"]},"publishedVersionId":{"type":["string","null"]},"sampleMetadata":{"type":"object","additionalProperties":{"description":"Any type"}},"stepCount":{"type":"integer"},"updatedAt":{"type":"string"},"userId":{"type":"string"}},"required":["createdAt","draftVersionId","flowSteps","id","lastModifiedSource","name","organizationId","updatedAt","userId"],"title":"Flows_updateFlow_Response_200"},"V1FlowsIdExportRuntimeGetResponsesContentApplicationJsonSchemaDependencyRefs":{"type":"object","properties":{"agentIds":{"type":"array","items":{"type":"string"}}},"title":"V1FlowsIdExportRuntimeGetResponsesContentApplicationJsonSchemaDependencyRefs"},"Flows_exportFlowForRuntimeLimitedPreview_Response_200":{"type":"object","properties":{"agents":{"type":"object","additionalProperties":{"type":"object","additionalProperties":{"description":"Any type"}}},"dependencyRefs":{"$ref":"#/components/schemas/V1FlowsIdExportRuntimeGetResponsesContentApplicationJsonSchemaDependencyRefs"},"description":{"type":["string","null"]},"hostDependencies":{"type":"array","items":{"$ref":"#/components/schemas/RuntimeHostDependency"}},"id":{"type":"string"},"name":{"type":"string"},"steps":{"type":"array","items":{"type":"object","additionalProperties":{"description":"Any type"}}},"warnings":{"type":"array","items":{"$ref":"#/components/schemas/RuntimeExportWarning"},"description":"Referenced sub-agents, flows and question sets the export could not embed, each with the reason. The export still returns `200`; a tool or capability that names a dropped child is absent from the artifact. Empty when every child was embedded."}},"required":["hostDependencies","id","name","steps","warnings"],"title":"Flows_exportFlowForRuntimeLimitedPreview_Response_200"},"Flows_publishFlow_Response_200":{"type":"object","properties":{"message":{"type":"string"},"publishedVersionId":{"type":"string"},"success":{"type":"boolean"}},"required":["message","publishedVersionId","success"],"title":"Flows_publishFlow_Response_200"},"V1FlowsIdPublishPostResponsesContentApplicationJsonSchemaDetailsItems":{"type":"object","properties":{"code":{"type":"string","description":"Stable Runtype validation code (e.g. MISSING_REQUIRED_FIELD, INVALID_ENUM)."},"message":{"type":"string"},"path":{"type":"string","description":"Dotted JSON path to the offending field."},"suggestion":{"type":"string","description":"Actionable hint (allowed values, accepted range, …)."}},"required":["message"],"title":"V1FlowsIdPublishPostResponsesContentApplicationJsonSchemaDetailsItems"},"PublishFlowRequestConflictError":{"type":"object","properties":{"code":{"type":"string","description":"Stable error code. `insufficient_scope` marks an API key that lacks a scope this request needs."},"details":{"type":"array","items":{"$ref":"#/components/schemas/V1FlowsIdPublishPostResponsesContentApplicationJsonSchemaDetailsItems"}},"error":{"type":"string"},"requiredScopes":{"type":"array","items":{"type":"string"},"description":"On `insufficient_scope`: every API key scope this request needs."}},"required":["code","error"],"title":"PublishFlowRequestConflictError"},"V1FlowsIdRunOnRecordTypePostResponsesContentApplicationJsonSchemaResultsItems":{"type":"object","properties":{"contextSteps":{"type":"integer"},"error":{"type":"string"},"executionId":{"type":"string"},"executionTime":{"type":"number","format":"double"},"promptsExecuted":{"type":"integer"},"recordId":{"type":"string"},"recordName":{"type":["string","null"]},"success":{"type":"boolean"}},"required":["recordId","recordName","success"],"title":"V1FlowsIdRunOnRecordTypePostResponsesContentApplicationJsonSchemaResultsItems"},"V1FlowsIdRunOnRecordTypePostResponsesContentApplicationJsonSchemaStatus":{"type":"string","enum":["scheduled"],"title":"V1FlowsIdRunOnRecordTypePostResponsesContentApplicationJsonSchemaStatus"},"Flows_runFlowOnRecordsOfAType_Response_200":{"type":"object","properties":{"batchId":{"type":"string"},"completedAt":{"type":"string"},"executedImmediately":{"type":"boolean"},"failureCount":{"type":"integer"},"flowId":{"type":"string"},"recordCount":{"type":"integer"},"recordType":{"type":"string"},"results":{"type":"array","items":{"$ref":"#/components/schemas/V1FlowsIdRunOnRecordTypePostResponsesContentApplicationJsonSchemaResultsItems"}},"status":{"$ref":"#/components/schemas/V1FlowsIdRunOnRecordTypePostResponsesContentApplicationJsonSchemaStatus"},"success":{"type":"boolean"},"successCount":{"type":"integer"}},"required":["batchId","completedAt","executedImmediately","failureCount","flowId","recordCount","recordType","results","status","success","successCount"],"title":"Flows_runFlowOnRecordsOfAType_Response_200"},"RunFlowOnRecordsOfATypeRequestBadRequestError":{"type":"object","properties":{"details":{"type":"array","items":{"type":"string"}},"error":{"type":"string"},"recordCount":{"type":"integer"},"recordType":{"type":"string"}},"required":["error"],"title":"RunFlowOnRecordsOfATypeRequestBadRequestError"},"V1FlowsIdRunOnRecordTypePostResponsesContentApplicationJsonSchemaCode":{"type":"string","enum":["RUNTIME_FLOW_UNSUPPORTED"],"title":"V1FlowsIdRunOnRecordTypePostResponsesContentApplicationJsonSchemaCode"},"RunFlowOnRecordsOfATypeRequestUnprocessableEntityError":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/V1FlowsIdRunOnRecordTypePostResponsesContentApplicationJsonSchemaCode"},"error":{"type":"string"},"reasons":{"type":"array","items":{"type":"string"}}},"required":["code","error","reasons"],"title":"RunFlowOnRecordsOfATypeRequestUnprocessableEntityError"},"V1FlowsIdStepResultsGetParametersSortOrder":{"type":"string","enum":["asc","desc"],"title":"V1FlowsIdStepResultsGetParametersSortOrder"},"V1FlowsIdStepResultsGetResponsesContentApplicationJsonSchemaDataItemsExecutionEngine":{"type":"string","enum":["runtime","legacy","external"],"description":"Engine that actually executed this step ('runtime' | 'legacy' | 'external'). Recorded at write time from the committed lane decision; never inferred later. 'external' marks a run a customer executed outside Runtype and reported through ingest. Null for rows written before attribution shipped and for units that never started executing.","title":"V1FlowsIdStepResultsGetResponsesContentApplicationJsonSchemaDataItemsExecutionEngine"},"V1FlowsIdStepResultsGetResponsesContentApplicationJsonSchemaDataItemsSourcesItems":{"type":"object","properties":{"title":{"type":"string"},"url":{"type":"string"}},"required":["url"],"title":"V1FlowsIdStepResultsGetResponsesContentApplicationJsonSchemaDataItemsSourcesItems"},"V1FlowsIdStepResultsGetResponsesContentApplicationJsonSchemaDataItems":{"type":"object","properties":{"batchExecutionId":{"type":["string","null"]},"cacheReadTokens":{"type":["integer","null"]},"cacheWriteTokens":{"type":["integer","null"]},"completedAt":{"type":["string","null"]},"completionTokens":{"type":["integer","null"]},"createdAt":{"type":"string"},"durationMs":{"type":["integer","null"]},"errorMessage":{"type":["string","null"]},"estimatedCost":{"type":["string","null"]},"executionEngine":{"$ref":"#/components/schemas/V1FlowsIdStepResultsGetResponsesContentApplicationJsonSchemaDataItemsExecutionEngine","description":"Engine that actually executed this step ('runtime' | 'legacy' | 'external'). Recorded at write time from the committed lane decision; never inferred later. 'external' marks a run a customer executed outside Runtype and reported through ingest. Null for rows written before attribution shipped and for units that never started executing."},"executionSessionId":{"type":["string","null"]},"flowId":{"type":["string","null"]},"flowVersionId":{"type":["string","null"]},"id":{"type":"string"},"inputVariables":{"description":"Any type"},"modelUsed":{"type":["string","null"]},"order":{"type":["integer","null"]},"organizationId":{"type":["string","null"]},"outputPreview":{"type":["string","null"]},"promptTokens":{"type":["integer","null"]},"reasoningConfig":{"description":"Any type"},"reasoningRejection":{"description":"Any type"},"reasoningRequested":{"description":"Any type"},"reasoningTokens":{"type":["integer","null"]},"recordId":{"type":["string","null"]},"recordMetadata":{"description":"Any type"},"recordName":{"type":["string","null"]},"resolvedPrompt":{"type":["string","null"]},"retryCount":{"type":["integer","null"]},"sources":{"type":["array","null"],"items":{"$ref":"#/components/schemas/V1FlowsIdStepResultsGetResponsesContentApplicationJsonSchemaDataItemsSourcesItems"}},"startedAt":{"type":["string","null"]},"status":{"type":"string"},"stepConfig":{"description":"Any type"},"stepId":{"type":["string","null"]},"stepName":{"type":"string"},"stepType":{"type":"string"},"totalTokens":{"type":["integer","null"]},"userId":{"type":"string"}},"required":["batchExecutionId","completedAt","createdAt","durationMs","executionSessionId","flowId","flowVersionId","id","order","organizationId","outputPreview","recordId","recordName","startedAt","status","stepId","stepName","stepType","userId"],"title":"V1FlowsIdStepResultsGetResponsesContentApplicationJsonSchemaDataItems"},"V1FlowsIdStepResultsGetResponsesContentApplicationJsonSchemaPagination":{"type":"object","properties":{"hasMore":{"type":"boolean"},"limit":{"type":"integer"},"offset":{"type":"integer"},"returned":{"type":"integer"}},"required":["hasMore","limit","offset","returned"],"title":"V1FlowsIdStepResultsGetResponsesContentApplicationJsonSchemaPagination"},"Flows_listFlowStepResults_Response_200":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1FlowsIdStepResultsGetResponsesContentApplicationJsonSchemaDataItems"}},"pagination":{"$ref":"#/components/schemas/V1FlowsIdStepResultsGetResponsesContentApplicationJsonSchemaPagination"}},"required":["data","pagination"],"title":"Flows_listFlowStepResults_Response_200"},"V1IntegrationConfigsGetResponsesContentApplicationJsonSchemaEmail":{"type":"object","properties":{"canUseCustomSender":{"type":"boolean"},"customSenderProviders":{"type":"array","items":{"type":"string"}}},"required":["canUseCustomSender","customSenderProviders"],"title":"V1IntegrationConfigsGetResponsesContentApplicationJsonSchemaEmail"},"Integration_Configs_listIntegrationConfigs_Response_200":{"type":"object","properties":{"daytona":{"type":"boolean"},"elevenlabs":{"type":"boolean"},"email":{"$ref":"#/components/schemas/V1IntegrationConfigsGetResponsesContentApplicationJsonSchemaEmail"},"exa":{"type":"boolean"},"firecrawl":{"type":"boolean"},"massive":{"type":"boolean"},"posthog":{"type":"boolean"},"resend":{"type":"boolean"}},"required":["daytona","elevenlabs","email","exa","firecrawl","massive","posthog","resend"],"title":"Integration Configs_listIntegrationConfigs_Response_200"},"Integration_Configs_getIntegrationConfigStatus_Response_200":{"type":"object","properties":{"configured":{"type":"boolean"}},"required":["configured"],"title":"Integration Configs_getIntegrationConfigStatus_Response_200"},"Integration_Configs_createOrUpdateAnIntegrationConfig_Response_200":{"type":"object","properties":{"success":{"type":"boolean"}},"required":["success"],"title":"Integration Configs_createOrUpdateAnIntegrationConfig_Response_200"},"V1IntegrationConfigsProviderPostResponsesContentApplicationJsonSchemaCode":{"type":"string","enum":["ORGANIZATION_MODEL_CONFIG_MIGRATED"],"title":"V1IntegrationConfigsProviderPostResponsesContentApplicationJsonSchemaCode"},"CreateOrUpdateAnIntegrationConfigRequestConflictError":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/V1IntegrationConfigsProviderPostResponsesContentApplicationJsonSchemaCode"},"configId":{"type":"string"},"details":{"type":"string"},"error":{"type":"string"}},"required":["code","configId","details","error"],"title":"CreateOrUpdateAnIntegrationConfigRequestConflictError"},"Integration_Configs_deleteAnIntegrationConfig_Response_200":{"type":"object","properties":{"success":{"type":"boolean"}},"required":["success"],"title":"Integration Configs_deleteAnIntegrationConfig_Response_200"},"V1IntegrationConfigsProviderDeleteResponsesContentApplicationJsonSchemaCode":{"type":"string","enum":["ORGANIZATION_MODEL_CONFIG_MIGRATED"],"title":"V1IntegrationConfigsProviderDeleteResponsesContentApplicationJsonSchemaCode"},"DeleteAnIntegrationConfigRequestConflictError":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/V1IntegrationConfigsProviderDeleteResponsesContentApplicationJsonSchemaCode"},"configId":{"type":"string"},"details":{"type":"string"},"error":{"type":"string"}},"required":["code","configId","details","error"],"title":"DeleteAnIntegrationConfigRequestConflictError"},"V1IntegrationsGetResponsesContentApplicationJsonSchemaIntegrationsItems":{"type":"object","properties":{"category":{"type":"string"},"description":{"type":"string"},"documentationUrl":{"type":"string"},"icon":{"type":"string"},"id":{"type":"string"},"isConfigured":{"type":"boolean"},"missingCredentials":{"type":"array","items":{"type":"string"}},"name":{"type":"string"},"requiredCredentials":{"type":"array","items":{"type":"string"}},"toolCount":{"type":"number","format":"double"}},"required":["category","description","id","isConfigured","missingCredentials","name","requiredCredentials","toolCount"],"title":"V1IntegrationsGetResponsesContentApplicationJsonSchemaIntegrationsItems"},"Integrations_listIntegrations_Response_200":{"type":"object","properties":{"integrations":{"type":"array","items":{"$ref":"#/components/schemas/V1IntegrationsGetResponsesContentApplicationJsonSchemaIntegrationsItems"}},"total":{"type":"number","format":"double"}},"required":["integrations","total"],"title":"Integrations_listIntegrations_Response_200"},"V1IntegrationsPostRequestBodyContentApplicationJsonSchemaProvider":{"type":"string","enum":["slack","telegram","google"],"title":"V1IntegrationsPostRequestBodyContentApplicationJsonSchemaProvider"},"Integrations_reserveANewIntegration_Response_201":{"type":"object","properties":{"createdAt":{"type":"string"},"expiresAt":{"type":"string"},"id":{"type":"string"},"provider":{"type":"string"},"status":{"type":"string"}},"required":["createdAt","expiresAt","id","provider","status"],"title":"Integrations_reserveANewIntegration_Response_201"},"V1IntegrationsCategoryCategoryGetResponsesContentApplicationJsonSchemaIntegrationsItems":{"type":"object","properties":{"category":{"type":"string"},"description":{"type":"string"},"documentationUrl":{"type":"string"},"icon":{"type":"string"},"id":{"type":"string"},"isConfigured":{"type":"boolean"},"missingCredentials":{"type":"array","items":{"type":"string"}},"name":{"type":"string"},"requiredCredentials":{"type":"array","items":{"type":"string"}},"toolCount":{"type":"number","format":"double"}},"required":["category","description","id","isConfigured","missingCredentials","name","requiredCredentials","toolCount"],"title":"V1IntegrationsCategoryCategoryGetResponsesContentApplicationJsonSchemaIntegrationsItems"},"Integrations_listIntegrationsByCategory_Response_200":{"type":"object","properties":{"integrations":{"type":"array","items":{"$ref":"#/components/schemas/V1IntegrationsCategoryCategoryGetResponsesContentApplicationJsonSchemaIntegrationsItems"}},"total":{"type":"number","format":"double"}},"required":["integrations","total"],"title":"Integrations_listIntegrationsByCategory_Response_200"},"V1IntegrationsConnectionsGetResponsesContentApplicationJsonSchemaConnectionsItemsEnvironment":{"type":"string","enum":["development","production"],"title":"V1IntegrationsConnectionsGetResponsesContentApplicationJsonSchemaConnectionsItemsEnvironment"},"V1IntegrationsConnectionsGetResponsesContentApplicationJsonSchemaConnectionsItems":{"type":"object","properties":{"accountName":{"type":"string"},"createdAt":{"type":"string"},"environment":{"$ref":"#/components/schemas/V1IntegrationsConnectionsGetResponsesContentApplicationJsonSchemaConnectionsItemsEnvironment"},"integrationId":{"type":"string"},"isDefault":{"type":"boolean"},"metadata":{"type":"object","additionalProperties":{"description":"Any type"}},"provider":{"type":"string"},"status":{"type":"string"}},"required":["accountName","createdAt","integrationId","provider","status"],"title":"V1IntegrationsConnectionsGetResponsesContentApplicationJsonSchemaConnectionsItems"},"Integrations_listConnectedIntegrationAccounts_Response_200":{"type":"object","properties":{"connections":{"type":"array","items":{"$ref":"#/components/schemas/V1IntegrationsConnectionsGetResponsesContentApplicationJsonSchemaConnectionsItems"}}},"required":["connections"],"title":"Integrations_listConnectedIntegrationAccounts_Response_200"},"V1IntegrationsCredentialsStatusGetResponsesContentApplicationJsonSchemaIntegrationsItemsEnvironments":{"type":"object","properties":{"all":{"type":"boolean"},"development":{"type":"boolean"},"production":{"type":"boolean"}},"required":["all","development","production"],"title":"V1IntegrationsCredentialsStatusGetResponsesContentApplicationJsonSchemaIntegrationsItemsEnvironments"},"V1IntegrationsCredentialsStatusGetResponsesContentApplicationJsonSchemaIntegrationsItems":{"type":"object","properties":{"description":{"type":"string"},"documentationUrl":{"type":"string"},"environments":{"$ref":"#/components/schemas/V1IntegrationsCredentialsStatusGetResponsesContentApplicationJsonSchemaIntegrationsItemsEnvironments"},"hasPlatformKey":{"type":"boolean"},"hasUserKey":{"type":"boolean"},"id":{"type":"string"},"isConfigured":{"type":"boolean"},"name":{"type":"string"}},"required":["description","environments","id","isConfigured","name"],"title":"V1IntegrationsCredentialsStatusGetResponsesContentApplicationJsonSchemaIntegrationsItems"},"Integrations_getIntegrationCredentialStatus_Response_200":{"type":"object","properties":{"integrations":{"type":"array","items":{"$ref":"#/components/schemas/V1IntegrationsCredentialsStatusGetResponsesContentApplicationJsonSchemaIntegrationsItems"}}},"required":["integrations"],"title":"Integrations_getIntegrationCredentialStatus_Response_200"},"Integrations_installGranolaIntegration_Response_200":{"type":"object","properties":{"created":{"type":"boolean"},"integrationId":{"type":"string"}},"required":["created","integrationId"],"title":"Integrations_installGranolaIntegration_Response_200"},"Integrations_checkSlackAppCreationStatus_Response_200":{"type":"object","properties":{"verified":{"type":"boolean"},"verifiedAt":{"type":"string"}},"required":["verified"],"title":"Integrations_checkSlackAppCreationStatus_Response_200"},"Integrations_installSlackIntegration_Response_200":{"type":"object","properties":{"created":{"type":"boolean"},"integrationId":{"type":"string"}},"required":["created","integrationId"],"title":"Integrations_installSlackIntegration_Response_200"},"V1IntegrationsSlackManifestPostResponsesContentApplicationJsonSchemaConnectHandoffType":{"type":"string","enum":["url"],"title":"V1IntegrationsSlackManifestPostResponsesContentApplicationJsonSchemaConnectHandoffType"},"V1IntegrationsSlackManifestPostResponsesContentApplicationJsonSchemaConnectHandoff":{"type":"object","properties":{"expiresAt":{"type":"string"},"type":{"$ref":"#/components/schemas/V1IntegrationsSlackManifestPostResponsesContentApplicationJsonSchemaConnectHandoffType"},"url":{"type":"string"}},"required":["type","url"],"title":"V1IntegrationsSlackManifestPostResponsesContentApplicationJsonSchemaConnectHandoff"},"Integrations_generateSlackAppManifest_Response_200":{"type":"object","properties":{"connectHandoff":{"$ref":"#/components/schemas/V1IntegrationsSlackManifestPostResponsesContentApplicationJsonSchemaConnectHandoff"},"createAppUrl":{"type":"string"},"eventsWebhookUrl":{"type":"string"},"integrationId":{"type":"string"},"interactivityWebhookUrl":{"type":"string"},"manifestJson":{"type":"string"},"redirectUrl":{"type":"string"},"webhookVerifiedAt":{"type":"string"}},"required":["connectHandoff","createAppUrl","eventsWebhookUrl","integrationId","interactivityWebhookUrl","manifestJson","redirectUrl"],"title":"Integrations_generateSlackAppManifest_Response_200"},"Integrations_rotateSlackCredentials_Response_200":{"type":"object","properties":{"appId":{"type":"string"},"botUserId":{"type":"string"},"integrationId":{"type":"string"},"teamId":{"type":"string"},"teamName":{"type":"string"}},"required":["integrationId"],"title":"Integrations_rotateSlackCredentials_Response_200"},"Integrations_installTelegramIntegration_Response_200":{"type":"object","properties":{"created":{"type":"boolean"},"integrationId":{"type":"string"}},"required":["created","integrationId"],"title":"Integrations_installTelegramIntegration_Response_200"},"Integrations_checkManagedTelegramBotAvailability_Response_200":{"type":"object","properties":{"available":{"type":"boolean"}},"required":["available"],"title":"Integrations_checkManagedTelegramBotAvailability_Response_200"},"V1IntegrationsTelegramManagedInitiatePostRequestBodyContentApplicationJsonSchemaBotCommandsItems":{"type":"object","properties":{"command":{"type":"string","minLength":1,"maxLength":32},"description":{"type":"string","minLength":1,"maxLength":256}},"required":["command","description"],"title":"V1IntegrationsTelegramManagedInitiatePostRequestBodyContentApplicationJsonSchemaBotCommandsItems"},"Integrations_initiateManagedTelegramBotCreation_Response_201":{"type":"object","properties":{"deepLink":{"type":"string"},"expiresAt":{"type":"string"},"integrationId":{"type":"string"},"requestId":{"type":"string"}},"required":["deepLink","expiresAt","integrationId","requestId"],"title":"Integrations_initiateManagedTelegramBotCreation_Response_201"},"Integrations_rotateManagedTelegramBotToken_Response_200":{"type":"object","properties":{"success":{"type":"boolean"}},"required":["success"],"title":"Integrations_rotateManagedTelegramBotToken_Response_200"},"Integrations_cancelManagedTelegramBotRequest_Response_200":{"type":"object","properties":{"ok":{"type":"boolean"}},"required":["ok"],"title":"Integrations_cancelManagedTelegramBotRequest_Response_200"},"Integrations_confirmManagedTelegramBotRename_Response_200":{"type":"object","properties":{"ok":{"type":"boolean"},"outcome":{"type":"string"},"result":{"description":"Any type"}},"required":["ok","outcome"],"title":"Integrations_confirmManagedTelegramBotRename_Response_200"},"Integrations_rejectManagedTelegramBotRename_Response_200":{"type":"object","properties":{"ok":{"type":"boolean"},"outcome":{"type":"string"},"result":{"description":"Any type"}},"required":["ok","outcome"],"title":"Integrations_rejectManagedTelegramBotRename_Response_200"},"V1IntegrationsTelegramManagedRequestIdStatusGetResponsesContentApplicationJsonSchemaDiagnostic":{"type":"string","enum":["manager_webhook_unhealthy"],"description":"Coarse hint set when a pending request looks stuck because the platform's Telegram manager webhook is unhealthy.","title":"V1IntegrationsTelegramManagedRequestIdStatusGetResponsesContentApplicationJsonSchemaDiagnostic"},"Integrations_getManagedTelegramBotRequestStatus_Response_200":{"type":"object","properties":{"diagnostic":{"$ref":"#/components/schemas/V1IntegrationsTelegramManagedRequestIdStatusGetResponsesContentApplicationJsonSchemaDiagnostic","description":"Coarse hint set when a pending request looks stuck because the platform's Telegram manager webhook is unhealthy."},"status":{"type":"string"}},"required":["status"],"title":"Integrations_getManagedTelegramBotRequestStatus_Response_200"},"V1IntegrationsToolsGetResponsesContentApplicationJsonSchemaToolsItems":{"type":"object","properties":{"category":{"type":"string"},"description":{"type":"string"},"integrationId":{"type":"string"},"integrationName":{"type":"string"},"name":{"type":"string"},"toolId":{"type":"string"}},"required":["description","integrationId","integrationName","name","toolId"],"title":"V1IntegrationsToolsGetResponsesContentApplicationJsonSchemaToolsItems"},"Integrations_listConfiguredIntegrationTools_Response_200":{"type":"object","properties":{"tools":{"type":"array","items":{"$ref":"#/components/schemas/V1IntegrationsToolsGetResponsesContentApplicationJsonSchemaToolsItems"}},"total":{"type":"number","format":"double"}},"required":["tools","total"],"title":"Integrations_listConfiguredIntegrationTools_Response_200"},"V1IntegrationsVectorizeGetResponsesContentApplicationJsonSchemaVectorizeConfigsItems":{"type":"object","properties":{"accountId":{"type":"string"},"createdAt":{"type":"string"},"id":{"type":"string"},"indexName":{"type":"string"},"name":{"type":"string"},"timeout":{"type":"number","format":"double"},"updatedAt":{"type":"string"}},"required":["accountId","id","indexName","name"],"title":"V1IntegrationsVectorizeGetResponsesContentApplicationJsonSchemaVectorizeConfigsItems"},"Integrations_listVectorizeConfigurations_Response_200":{"type":"object","properties":{"vectorizeConfigs":{"type":"array","items":{"$ref":"#/components/schemas/V1IntegrationsVectorizeGetResponsesContentApplicationJsonSchemaVectorizeConfigsItems"}}},"required":["vectorizeConfigs"],"title":"Integrations_listVectorizeConfigurations_Response_200"},"V1IntegrationsVectorizePostResponsesContentApplicationJsonSchemaVectorizeConfig":{"type":"object","properties":{"accountId":{"type":"string"},"createdAt":{"type":"string"},"id":{"type":"string"},"indexName":{"type":"string"},"name":{"type":"string"},"timeout":{"type":"number","format":"double"},"updatedAt":{"type":"string"}},"required":["accountId","id","indexName","name"],"title":"V1IntegrationsVectorizePostResponsesContentApplicationJsonSchemaVectorizeConfig"},"Integrations_createVectorizeConfiguration_Response_201":{"type":"object","properties":{"vectorizeConfig":{"$ref":"#/components/schemas/V1IntegrationsVectorizePostResponsesContentApplicationJsonSchemaVectorizeConfig"}},"required":["vectorizeConfig"],"title":"Integrations_createVectorizeConfiguration_Response_201"},"V1IntegrationsVectorizeIndexesCreatePostResponsesContentApplicationJsonSchemaIndex":{"type":"object","properties":{"dimensions":{"type":"number","format":"double"},"metric":{"type":"string"},"name":{"type":"string"},"vectorCount":{"type":"number","format":"double"}},"required":["dimensions","metric","name"],"title":"V1IntegrationsVectorizeIndexesCreatePostResponsesContentApplicationJsonSchemaIndex"},"Integrations_createVectorizeIndex_Response_201":{"type":"object","properties":{"error":{"type":"string"},"index":{"oneOf":[{"$ref":"#/components/schemas/V1IntegrationsVectorizeIndexesCreatePostResponsesContentApplicationJsonSchemaIndex"},{"type":"null"}]},"success":{"type":"boolean"}},"required":["success"],"title":"Integrations_createVectorizeIndex_Response_201"},"V1IntegrationsVectorizeIndexesListPostResponsesContentApplicationJsonSchemaIndexesItems":{"type":"object","properties":{"dimensions":{"type":"number","format":"double"},"metric":{"type":"string"},"name":{"type":"string"},"vectorCount":{"type":"number","format":"double"}},"required":["dimensions","metric","name"],"title":"V1IntegrationsVectorizeIndexesListPostResponsesContentApplicationJsonSchemaIndexesItems"},"Integrations_listVectorizeIndexes_Response_200":{"type":"object","properties":{"error":{"type":"string"},"indexes":{"type":"array","items":{"$ref":"#/components/schemas/V1IntegrationsVectorizeIndexesListPostResponsesContentApplicationJsonSchemaIndexesItems"}},"success":{"type":"boolean"}},"required":["success"],"title":"Integrations_listVectorizeIndexes_Response_200"},"V1IntegrationsVectorizeTestPostResponsesContentApplicationJsonSchemaIndexInfo":{"type":"object","properties":{"dimensions":{"type":"number","format":"double"},"metric":{"type":"string"},"name":{"type":"string"},"vectorCount":{"type":"number","format":"double"}},"required":["dimensions","metric","name"],"title":"V1IntegrationsVectorizeTestPostResponsesContentApplicationJsonSchemaIndexInfo"},"Integrations_testNewVectorizeConfiguration_Response_200":{"type":"object","properties":{"error":{"type":"string"},"indexInfo":{"oneOf":[{"$ref":"#/components/schemas/V1IntegrationsVectorizeTestPostResponsesContentApplicationJsonSchemaIndexInfo"},{"type":"null"}]},"success":{"type":"boolean"}},"required":["success"],"title":"Integrations_testNewVectorizeConfiguration_Response_200"},"V1IntegrationsVectorizeIdGetResponsesContentApplicationJsonSchemaVectorizeConfig":{"type":"object","properties":{"accountId":{"type":"string"},"createdAt":{"type":"string"},"id":{"type":"string"},"indexName":{"type":"string"},"name":{"type":"string"},"timeout":{"type":"number","format":"double"},"updatedAt":{"type":"string"}},"required":["accountId","id","indexName","name"],"title":"V1IntegrationsVectorizeIdGetResponsesContentApplicationJsonSchemaVectorizeConfig"},"Integrations_getVectorizeConfiguration_Response_200":{"type":"object","properties":{"vectorizeConfig":{"$ref":"#/components/schemas/V1IntegrationsVectorizeIdGetResponsesContentApplicationJsonSchemaVectorizeConfig"}},"required":["vectorizeConfig"],"title":"Integrations_getVectorizeConfiguration_Response_200"},"V1IntegrationsVectorizeIdPutResponsesContentApplicationJsonSchemaVectorizeConfig":{"type":"object","properties":{"accountId":{"type":"string"},"createdAt":{"type":"string"},"id":{"type":"string"},"indexName":{"type":"string"},"name":{"type":"string"},"timeout":{"type":"number","format":"double"},"updatedAt":{"type":"string"}},"required":["accountId","id","indexName","name"],"title":"V1IntegrationsVectorizeIdPutResponsesContentApplicationJsonSchemaVectorizeConfig"},"Integrations_updateVectorizeConfiguration_Response_200":{"type":"object","properties":{"vectorizeConfig":{"$ref":"#/components/schemas/V1IntegrationsVectorizeIdPutResponsesContentApplicationJsonSchemaVectorizeConfig"}},"required":["vectorizeConfig"],"title":"Integrations_updateVectorizeConfiguration_Response_200"},"Integrations_deleteVectorizeConfiguration_Response_200":{"type":"object","properties":{"success":{"type":"boolean"}},"required":["success"],"title":"Integrations_deleteVectorizeConfiguration_Response_200"},"V1IntegrationsVectorizeIdTestPostResponsesContentApplicationJsonSchemaIndexInfo":{"type":"object","properties":{"dimensions":{"type":"number","format":"double"},"metric":{"type":"string"},"name":{"type":"string"},"vectorCount":{"type":"number","format":"double"}},"required":["dimensions","metric","name"],"title":"V1IntegrationsVectorizeIdTestPostResponsesContentApplicationJsonSchemaIndexInfo"},"Integrations_testSavedVectorizeConfiguration_Response_200":{"type":"object","properties":{"error":{"type":"string"},"indexInfo":{"oneOf":[{"$ref":"#/components/schemas/V1IntegrationsVectorizeIdTestPostResponsesContentApplicationJsonSchemaIndexInfo"},{"type":"null"}]},"success":{"type":"boolean"}},"required":["success"],"title":"Integrations_testSavedVectorizeConfiguration_Response_200"},"V1IntegrationsWeaviateGetResponsesContentApplicationJsonSchemaWeaviateConfigsItemsSettings":{"type":"object","properties":{"defaultClass":{"type":"string"},"generativeModule":{"type":"string"},"vectorizer":{"type":"string"}},"title":"V1IntegrationsWeaviateGetResponsesContentApplicationJsonSchemaWeaviateConfigsItemsSettings"},"V1IntegrationsWeaviateGetResponsesContentApplicationJsonSchemaWeaviateConfigsItems":{"type":"object","properties":{"headers":{"type":"object","additionalProperties":{"type":"string"}},"id":{"type":"string"},"name":{"type":"string"},"settings":{"$ref":"#/components/schemas/V1IntegrationsWeaviateGetResponsesContentApplicationJsonSchemaWeaviateConfigsItemsSettings"},"url":{"type":"string"}},"required":["id","name","url"],"title":"V1IntegrationsWeaviateGetResponsesContentApplicationJsonSchemaWeaviateConfigsItems"},"Integrations_listWeaviateConfigurations_Response_200":{"type":"object","properties":{"weaviateConfigs":{"type":"array","items":{"$ref":"#/components/schemas/V1IntegrationsWeaviateGetResponsesContentApplicationJsonSchemaWeaviateConfigsItems"}}},"required":["weaviateConfigs"],"title":"Integrations_listWeaviateConfigurations_Response_200"},"V1IntegrationsWeaviatePostRequestBodyContentApplicationJsonSchemaSettings":{"type":"object","properties":{"defaultClass":{"type":"string"},"generativeModule":{"type":"string"},"vectorizer":{"type":"string"}},"title":"V1IntegrationsWeaviatePostRequestBodyContentApplicationJsonSchemaSettings"},"V1IntegrationsWeaviatePostResponsesContentApplicationJsonSchemaWeaviateConfigSettings":{"type":"object","properties":{"defaultClass":{"type":"string"},"generativeModule":{"type":"string"},"vectorizer":{"type":"string"}},"title":"V1IntegrationsWeaviatePostResponsesContentApplicationJsonSchemaWeaviateConfigSettings"},"V1IntegrationsWeaviatePostResponsesContentApplicationJsonSchemaWeaviateConfig":{"type":"object","properties":{"headers":{"type":"object","additionalProperties":{"type":"string"}},"id":{"type":"string"},"name":{"type":"string"},"settings":{"$ref":"#/components/schemas/V1IntegrationsWeaviatePostResponsesContentApplicationJsonSchemaWeaviateConfigSettings"},"url":{"type":"string"}},"required":["id","name","url"],"title":"V1IntegrationsWeaviatePostResponsesContentApplicationJsonSchemaWeaviateConfig"},"Integrations_createWeaviateConfiguration_Response_201":{"type":"object","properties":{"weaviateConfig":{"$ref":"#/components/schemas/V1IntegrationsWeaviatePostResponsesContentApplicationJsonSchemaWeaviateConfig"}},"required":["weaviateConfig"],"title":"Integrations_createWeaviateConfiguration_Response_201"},"V1IntegrationsWeaviateTestPostRequestBodyContentApplicationJsonSchemaSettings":{"type":"object","properties":{"defaultClass":{"type":"string"},"generativeModule":{"type":"string"},"vectorizer":{"type":"string"}},"title":"V1IntegrationsWeaviateTestPostRequestBodyContentApplicationJsonSchemaSettings"},"V1IntegrationsWeaviateTestPostResponsesContentApplicationJsonSchemaSchemaClassesItems":{"type":"object","properties":{"description":{"type":"string"},"name":{"type":"string"},"properties":{"type":"number","format":"double"},"vectorizer":{"type":"string"}},"required":["properties"],"title":"V1IntegrationsWeaviateTestPostResponsesContentApplicationJsonSchemaSchemaClassesItems"},"V1IntegrationsWeaviateTestPostResponsesContentApplicationJsonSchemaSchema":{"type":"object","properties":{"classes":{"type":"array","items":{"$ref":"#/components/schemas/V1IntegrationsWeaviateTestPostResponsesContentApplicationJsonSchemaSchemaClassesItems"}}},"required":["classes"],"title":"V1IntegrationsWeaviateTestPostResponsesContentApplicationJsonSchemaSchema"},"Integrations_testNewWeaviateConfiguration_Response_200":{"type":"object","properties":{"error":{"type":"string"},"schema":{"$ref":"#/components/schemas/V1IntegrationsWeaviateTestPostResponsesContentApplicationJsonSchemaSchema"},"success":{"type":"boolean"}},"required":["success"],"title":"Integrations_testNewWeaviateConfiguration_Response_200"},"TestNewWeaviateConfigurationRequestBadRequestError":{"type":"object","properties":{"error":{"type":"string"},"schema":{"$ref":"#/components/schemas/V1IntegrationsWeaviateTestPostResponsesContentApplicationJsonSchemaSchema"},"success":{"type":"boolean"}},"required":["success"],"title":"TestNewWeaviateConfigurationRequestBadRequestError"},"TestNewWeaviateConfigurationRequestUnauthorizedError":{"type":"object","properties":{"error":{"type":"string"},"schema":{"$ref":"#/components/schemas/V1IntegrationsWeaviateTestPostResponsesContentApplicationJsonSchemaSchema"},"success":{"type":"boolean"}},"required":["success"],"title":"TestNewWeaviateConfigurationRequestUnauthorizedError"},"TestNewWeaviateConfigurationRequestInternalServerError":{"type":"object","properties":{"error":{"type":"string"},"schema":{"$ref":"#/components/schemas/V1IntegrationsWeaviateTestPostResponsesContentApplicationJsonSchemaSchema"},"success":{"type":"boolean"}},"required":["success"],"title":"TestNewWeaviateConfigurationRequestInternalServerError"},"V1IntegrationsWeaviateIdGetResponsesContentApplicationJsonSchemaWeaviateConfigSettings":{"type":"object","properties":{"defaultClass":{"type":"string"},"generativeModule":{"type":"string"},"vectorizer":{"type":"string"}},"title":"V1IntegrationsWeaviateIdGetResponsesContentApplicationJsonSchemaWeaviateConfigSettings"},"V1IntegrationsWeaviateIdGetResponsesContentApplicationJsonSchemaWeaviateConfig":{"type":"object","properties":{"headers":{"type":"object","additionalProperties":{"type":"string"}},"id":{"type":"string"},"name":{"type":"string"},"settings":{"$ref":"#/components/schemas/V1IntegrationsWeaviateIdGetResponsesContentApplicationJsonSchemaWeaviateConfigSettings"},"url":{"type":"string"}},"required":["id","name","url"],"title":"V1IntegrationsWeaviateIdGetResponsesContentApplicationJsonSchemaWeaviateConfig"},"Integrations_getWeaviateConfiguration_Response_200":{"type":"object","properties":{"weaviateConfig":{"$ref":"#/components/schemas/V1IntegrationsWeaviateIdGetResponsesContentApplicationJsonSchemaWeaviateConfig"}},"required":["weaviateConfig"],"title":"Integrations_getWeaviateConfiguration_Response_200"},"V1IntegrationsWeaviateIdPutRequestBodyContentApplicationJsonSchemaSettings":{"type":"object","properties":{"defaultClass":{"type":"string"},"generativeModule":{"type":"string"},"vectorizer":{"type":"string"}},"title":"V1IntegrationsWeaviateIdPutRequestBodyContentApplicationJsonSchemaSettings"},"V1IntegrationsWeaviateIdPutResponsesContentApplicationJsonSchemaWeaviateConfigSettings":{"type":"object","properties":{"defaultClass":{"type":"string"},"generativeModule":{"type":"string"},"vectorizer":{"type":"string"}},"title":"V1IntegrationsWeaviateIdPutResponsesContentApplicationJsonSchemaWeaviateConfigSettings"},"V1IntegrationsWeaviateIdPutResponsesContentApplicationJsonSchemaWeaviateConfig":{"type":"object","properties":{"headers":{"type":"object","additionalProperties":{"type":"string"}},"id":{"type":"string"},"name":{"type":"string"},"settings":{"$ref":"#/components/schemas/V1IntegrationsWeaviateIdPutResponsesContentApplicationJsonSchemaWeaviateConfigSettings"},"url":{"type":"string"}},"required":["id","name","url"],"title":"V1IntegrationsWeaviateIdPutResponsesContentApplicationJsonSchemaWeaviateConfig"},"Integrations_updateWeaviateConfiguration_Response_200":{"type":"object","properties":{"weaviateConfig":{"$ref":"#/components/schemas/V1IntegrationsWeaviateIdPutResponsesContentApplicationJsonSchemaWeaviateConfig"}},"required":["weaviateConfig"],"title":"Integrations_updateWeaviateConfiguration_Response_200"},"Integrations_deleteWeaviateConfiguration_Response_200":{"type":"object","properties":{"success":{"type":"boolean"}},"required":["success"],"title":"Integrations_deleteWeaviateConfiguration_Response_200"},"V1IntegrationsWeaviateIdClassesPostResponsesContentApplicationJsonSchemaClassesItems":{"type":"object","properties":{"description":{"type":"string"},"dimensions":{"type":"number","format":"double"},"name":{"type":"string"},"propertyCount":{"type":"number","format":"double"},"vectorizer":{"type":"string"}},"required":["propertyCount","vectorizer"],"title":"V1IntegrationsWeaviateIdClassesPostResponsesContentApplicationJsonSchemaClassesItems"},"Integrations_listWeaviateCollections_Response_200":{"type":"object","properties":{"classes":{"type":"array","items":{"$ref":"#/components/schemas/V1IntegrationsWeaviateIdClassesPostResponsesContentApplicationJsonSchemaClassesItems"}},"error":{"type":"string"},"success":{"type":"boolean"}},"required":["success"],"title":"Integrations_listWeaviateCollections_Response_200"},"ListWeaviateCollectionsRequestBadRequestError":{"type":"object","properties":{"classes":{"type":"array","items":{"$ref":"#/components/schemas/V1IntegrationsWeaviateIdClassesPostResponsesContentApplicationJsonSchemaClassesItems"}},"error":{"type":"string"},"success":{"type":"boolean"}},"required":["success"],"title":"ListWeaviateCollectionsRequestBadRequestError"},"ListWeaviateCollectionsRequestUnauthorizedError":{"type":"object","properties":{"classes":{"type":"array","items":{"$ref":"#/components/schemas/V1IntegrationsWeaviateIdClassesPostResponsesContentApplicationJsonSchemaClassesItems"}},"error":{"type":"string"},"success":{"type":"boolean"}},"required":["success"],"title":"ListWeaviateCollectionsRequestUnauthorizedError"},"ListWeaviateCollectionsRequestInternalServerError":{"type":"object","properties":{"classes":{"type":"array","items":{"$ref":"#/components/schemas/V1IntegrationsWeaviateIdClassesPostResponsesContentApplicationJsonSchemaClassesItems"}},"error":{"type":"string"},"success":{"type":"boolean"}},"required":["success"],"title":"ListWeaviateCollectionsRequestInternalServerError"},"V1IntegrationsWeaviateIdTestPostResponsesContentApplicationJsonSchemaSchemaClassesItems":{"type":"object","properties":{"description":{"type":"string"},"name":{"type":"string"},"properties":{"type":"number","format":"double"},"vectorizer":{"type":"string"}},"required":["properties"],"title":"V1IntegrationsWeaviateIdTestPostResponsesContentApplicationJsonSchemaSchemaClassesItems"},"V1IntegrationsWeaviateIdTestPostResponsesContentApplicationJsonSchemaSchema":{"type":"object","properties":{"classes":{"type":"array","items":{"$ref":"#/components/schemas/V1IntegrationsWeaviateIdTestPostResponsesContentApplicationJsonSchemaSchemaClassesItems"}}},"required":["classes"],"title":"V1IntegrationsWeaviateIdTestPostResponsesContentApplicationJsonSchemaSchema"},"Integrations_testWeaviateConnection_Response_200":{"type":"object","properties":{"error":{"type":"string"},"schema":{"$ref":"#/components/schemas/V1IntegrationsWeaviateIdTestPostResponsesContentApplicationJsonSchemaSchema"},"success":{"type":"boolean"}},"required":["success"],"title":"Integrations_testWeaviateConnection_Response_200"},"TestWeaviateConnectionRequestBadRequestError":{"type":"object","properties":{"error":{"type":"string"},"schema":{"$ref":"#/components/schemas/V1IntegrationsWeaviateIdTestPostResponsesContentApplicationJsonSchemaSchema"},"success":{"type":"boolean"}},"required":["success"],"title":"TestWeaviateConnectionRequestBadRequestError"},"TestWeaviateConnectionRequestUnauthorizedError":{"type":"object","properties":{"error":{"type":"string"},"schema":{"$ref":"#/components/schemas/V1IntegrationsWeaviateIdTestPostResponsesContentApplicationJsonSchemaSchema"},"success":{"type":"boolean"}},"required":["success"],"title":"TestWeaviateConnectionRequestUnauthorizedError"},"TestWeaviateConnectionRequestInternalServerError":{"type":"object","properties":{"error":{"type":"string"},"schema":{"$ref":"#/components/schemas/V1IntegrationsWeaviateIdTestPostResponsesContentApplicationJsonSchemaSchema"},"success":{"type":"boolean"}},"required":["success"],"title":"TestWeaviateConnectionRequestInternalServerError"},"V1IntegrationsIntegrationIdGetResponsesContentApplicationJsonSchemaToolsItems":{"type":"object","properties":{"description":{"type":"string"},"name":{"type":"string"},"toolId":{"type":"string"}},"required":["description","name","toolId"],"title":"V1IntegrationsIntegrationIdGetResponsesContentApplicationJsonSchemaToolsItems"},"Integrations_getIntegrationDetails_Response_200":{"type":"object","properties":{"category":{"type":"string"},"description":{"type":"string"},"documentationUrl":{"type":"string"},"icon":{"type":"string"},"id":{"type":"string"},"isConfigured":{"type":"boolean"},"missingCredentials":{"type":"array","items":{"type":"string"}},"name":{"type":"string"},"requiredCredentials":{"type":"array","items":{"type":"string"}},"tools":{"type":"array","items":{"$ref":"#/components/schemas/V1IntegrationsIntegrationIdGetResponsesContentApplicationJsonSchemaToolsItems"}}},"required":["category","description","id","isConfigured","missingCredentials","name","requiredCredentials","tools"],"title":"Integrations_getIntegrationDetails_Response_200"},"Integrations_saveIntegrationCredentials_Response_200":{"type":"object","properties":{"environment":{"type":["string","null"]},"integrationId":{"type":"string"},"message":{"type":"string"},"success":{"type":"boolean"}},"required":["environment","integrationId","message","success"],"title":"Integrations_saveIntegrationCredentials_Response_200"},"V1IntegrationsIntegrationIdCredentialsPostResponsesContentApplicationJsonSchemaAuthorityType":{"type":"string","enum":["connection","policy"],"title":"V1IntegrationsIntegrationIdCredentialsPostResponsesContentApplicationJsonSchemaAuthorityType"},"V1IntegrationsIntegrationIdCredentialsPostResponsesContentApplicationJsonSchemaCode":{"type":"string","enum":["ORGANIZATION_CONNECTION_MIGRATED"],"title":"V1IntegrationsIntegrationIdCredentialsPostResponsesContentApplicationJsonSchemaCode"},"SaveIntegrationCredentialsRequestConflictError":{"type":"object","properties":{"authorityId":{"type":"string"},"authorityType":{"$ref":"#/components/schemas/V1IntegrationsIntegrationIdCredentialsPostResponsesContentApplicationJsonSchemaAuthorityType"},"code":{"$ref":"#/components/schemas/V1IntegrationsIntegrationIdCredentialsPostResponsesContentApplicationJsonSchemaCode"},"error":{"type":"string"}},"required":["authorityId","authorityType","code","error"],"title":"SaveIntegrationCredentialsRequestConflictError"},"Integrations_deleteIntegrationCredentials_Response_200":{"type":"object","properties":{"environment":{"type":["string","null"]},"integrationId":{"type":"string"},"message":{"type":"string"},"success":{"type":"boolean"}},"required":["environment","integrationId","message","success"],"title":"Integrations_deleteIntegrationCredentials_Response_200"},"V1IntegrationsIntegrationIdCredentialsDeleteResponsesContentApplicationJsonSchemaAuthorityType":{"type":"string","enum":["connection","policy"],"title":"V1IntegrationsIntegrationIdCredentialsDeleteResponsesContentApplicationJsonSchemaAuthorityType"},"V1IntegrationsIntegrationIdCredentialsDeleteResponsesContentApplicationJsonSchemaCode":{"type":"string","enum":["ORGANIZATION_CONNECTION_MIGRATED"],"title":"V1IntegrationsIntegrationIdCredentialsDeleteResponsesContentApplicationJsonSchemaCode"},"DeleteIntegrationCredentialsRequestConflictError":{"type":"object","properties":{"authorityId":{"type":"string"},"authorityType":{"$ref":"#/components/schemas/V1IntegrationsIntegrationIdCredentialsDeleteResponsesContentApplicationJsonSchemaAuthorityType"},"code":{"$ref":"#/components/schemas/V1IntegrationsIntegrationIdCredentialsDeleteResponsesContentApplicationJsonSchemaCode"},"error":{"type":"string"}},"required":["authorityId","authorityType","code","error"],"title":"DeleteIntegrationCredentialsRequestConflictError"},"V1IntegrationsIntegrationIdToolsGetResponsesContentApplicationJsonSchemaToolsItems":{"type":"object","properties":{"description":{"type":"string"},"name":{"type":"string"},"parameters":{"description":"Any type"},"toolId":{"type":"string"}},"required":["description","name","toolId"],"title":"V1IntegrationsIntegrationIdToolsGetResponsesContentApplicationJsonSchemaToolsItems"},"Integrations_listToolsForAnIntegration_Response_200":{"type":"object","properties":{"tools":{"type":"array","items":{"$ref":"#/components/schemas/V1IntegrationsIntegrationIdToolsGetResponsesContentApplicationJsonSchemaToolsItems"}},"total":{"type":"number","format":"double"}},"required":["tools","total"],"title":"Integrations_listToolsForAnIntegration_Response_200"},"Integrations_getAnIntegrationTool_Response_200":{"type":"object","properties":{"description":{"type":"string"},"name":{"type":"string"},"parameters":{"description":"Any type"},"toolId":{"type":"string"}},"required":["description","name","toolId"],"title":"Integrations_getAnIntegrationTool_Response_200"},"V1LogsGetResponsesContentApplicationJsonSchemaDataEntriesItems":{"type":"object","properties":{},"title":"V1LogsGetResponsesContentApplicationJsonSchemaDataEntriesItems"},"V1LogsGetResponsesContentApplicationJsonSchemaDataLiveReason":{"type":"string","enum":["hot_tier_failed","outside_window"],"title":"V1LogsGetResponsesContentApplicationJsonSchemaDataLiveReason"},"V1LogsGetResponsesContentApplicationJsonSchemaDataLive":{"type":"object","properties":{"cutline":{"type":"string","description":"Entries at or below this instant came from the span store; newer ones from the live tier."},"reason":{"$ref":"#/components/schemas/V1LogsGetResponsesContentApplicationJsonSchemaDataLiveReason"},"served":{"type":"boolean"}},"required":["cutline","served"],"description":"Present only when the page was served from the span store. Runs still in progress appear once they finish; the minutes above the cut-line come from the live tier when it answers in time. Absent otherwise.","title":"V1LogsGetResponsesContentApplicationJsonSchemaDataLive"},"V1LogsGetResponsesContentApplicationJsonSchemaDataPagination":{"type":"object","properties":{"cursor":{"type":["string","null"]},"cursorReset":{"type":"boolean","description":"True when the supplied cursor could not be honoured and the read restarted at page one. A paging client must stop rather than follow the fresh cursor. Absent otherwise."},"hasMore":{"type":"boolean"}},"required":["cursor","hasMore"],"title":"V1LogsGetResponsesContentApplicationJsonSchemaDataPagination"},"V1LogsGetResponsesContentApplicationJsonSchemaData":{"type":"object","properties":{"degraded":{"type":"boolean","description":"True when the live overlay or the audit plane could not be read, so entries from that source are missing. Absent on healthy responses."},"entries":{"type":"array","items":{"$ref":"#/components/schemas/V1LogsGetResponsesContentApplicationJsonSchemaDataEntriesItems"}},"live":{"$ref":"#/components/schemas/V1LogsGetResponsesContentApplicationJsonSchemaDataLive","description":"Present only when the page was served from the span store. Runs still in progress appear once they finish; the minutes above the cut-line come from the live tier when it answers in time. Absent otherwise."},"pagination":{"$ref":"#/components/schemas/V1LogsGetResponsesContentApplicationJsonSchemaDataPagination"}},"required":["entries","pagination"],"title":"V1LogsGetResponsesContentApplicationJsonSchemaData"},"V1LogsGetResponsesContentApplicationJsonSchemaWindow":{"type":"object","properties":{"from":{"type":"string","description":"Resolved start timestamp the query actually used"},"to":{"type":"string","description":"Resolved end timestamp the query actually used"}},"required":["from","to"],"description":"The time window the query resolved to, after defaults and from/to aliases.","title":"V1LogsGetResponsesContentApplicationJsonSchemaWindow"},"Logs_queryCustomerLogs_Response_200":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/V1LogsGetResponsesContentApplicationJsonSchemaData"},"success":{"type":"boolean"},"window":{"$ref":"#/components/schemas/V1LogsGetResponsesContentApplicationJsonSchemaWindow","description":"The time window the query resolved to, after defaults and from/to aliases."}},"required":["data","success","window"],"title":"Logs_queryCustomerLogs_Response_200"},"QueryCustomerLogsRequestPaymentRequiredError":{"type":"object","properties":{"code":{"type":"string"},"error":{"type":"string"},"message":{"type":"string"}},"required":["code","error","message"],"title":"QueryCustomerLogsRequestPaymentRequiredError"},"ContextManifestEntryCategory":{"type":"string","enum":["toolDefinitions","systemPrompt","recordContext","conversationHistory","toolResults","currentUserMessage"],"title":"ContextManifestEntryCategory"},"ContextManifestEntryFlagsItems":{"type":"string","enum":["current","secret_scrubbed","unsized"],"title":"ContextManifestEntryFlagsItems"},"ContextManifestEntryKind":{"type":"string","enum":["instructions","record","tool_definition","user_message","assistant_message","assistant_tool_call","reasoning","attachment","tool_result"],"title":"ContextManifestEntryKind"},"ContextManifestEntryRole":{"type":"string","enum":["system","user","assistant","tool"],"title":"ContextManifestEntryRole"},"ContextManifestEntry":{"type":"object","properties":{"category":{"$ref":"#/components/schemas/ContextManifestEntryCategory"},"chars":{"type":"number","format":"double"},"estimatedTokens":{"type":"number","format":"double","description":"chars / 4, never calibrated in storage."},"firstSeenSeq":{"type":"number","format":"double","description":"The snapshot where this entry entered the window."},"flags":{"type":"array","items":{"$ref":"#/components/schemas/ContextManifestEntryFlagsItems"}},"hash":{"type":"string","description":"Content address of the block: 16 hex chars of its SHA-256."},"kind":{"$ref":"#/components/schemas/ContextManifestEntryKind"},"role":{"$ref":"#/components/schemas/ContextManifestEntryRole"},"toolCallId":{"type":"string"},"toolName":{"type":"string"}},"required":["category","chars","estimatedTokens","firstSeenSeq","flags","hash","kind","role"],"title":"ContextManifestEntry"},"ContextSnapshotRemovedSincePreviousItemsReason":{"type":"string","enum":["pruned","compacted","reasoning_dropped","tool_item_dropped"],"title":"ContextSnapshotRemovedSincePreviousItemsReason"},"ContextSnapshotRemovedSincePreviousItems":{"type":"object","properties":{"entry":{"$ref":"#/components/schemas/ContextManifestEntry"},"reason":{"$ref":"#/components/schemas/ContextSnapshotRemovedSincePreviousItemsReason"}},"required":["entry","reason"],"title":"ContextSnapshotRemovedSincePreviousItems"},"ContextSnapshotReported":{"type":"object","properties":{"cacheReadTokens":{"type":"number","format":"double"},"cacheWriteTokens":{"type":"number","format":"double"},"inputTokens":{"type":"number","format":"double"}},"required":["cacheReadTokens","cacheWriteTokens","inputTokens"],"title":"ContextSnapshotReported"},"ContextSnapshot":{"type":"object","properties":{"cacheBreakpoints":{"type":"array","items":{"type":"number","format":"double"}},"contentCaptured":{"type":"boolean","description":"The run stored block text, readable from the blocks route. False under logging policy `redact`, and for runs recorded before block text was captured."},"entries":{"type":"array","items":{"$ref":"#/components/schemas/ContextManifestEntry"}},"iteration":{"type":["number","null"],"format":"double"},"model":{"type":["string","null"]},"modelRequestSpanId":{"type":"string"},"removedSincePrevious":{"type":"array","items":{"$ref":"#/components/schemas/ContextSnapshotRemovedSincePreviousItems"}},"reported":{"oneOf":[{"$ref":"#/components/schemas/ContextSnapshotReported"},{"type":"null"}]},"requestIndex":{"type":["number","null"],"format":"double"},"seq":{"type":"number","format":"double","description":"Execution-wide request order; the key."},"startedAt":{"type":"string"},"stepId":{"type":["string","null"]},"turnId":{"type":["string","null"]}},"required":["cacheBreakpoints","contentCaptured","entries","iteration","model","modelRequestSpanId","removedSincePrevious","reported","requestIndex","seq","startedAt","stepId","turnId"],"title":"ContextSnapshot"},"ContextSnapshots":{"type":"object","properties":{"executionId":{"type":"string"},"snapshots":{"type":"array","items":{"$ref":"#/components/schemas/ContextSnapshot"}},"truncated":{"type":"boolean","description":"The execution exceeded the span read ceiling; later requests are omitted."}},"required":["executionId","snapshots","truncated"],"title":"ContextSnapshots"},"Logs_contextSnapshotsForAnExecution_Response_200":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/ContextSnapshots"},"success":{"type":"boolean"}},"required":["data","success"],"title":"Logs_contextSnapshotsForAnExecution_Response_200"},"ContextBlocksBlocksItems":{"type":"object","properties":{"content":{"type":"string","description":"The block text, scrubbed of secrets."},"hash":{"type":"string","description":"The manifest entry hash this text belongs to."},"truncated":{"type":"boolean","description":"The block was cut at capture; `content` holds its head and tail."}},"required":["content","hash","truncated"],"title":"ContextBlocksBlocksItems"},"ContextBlocks":{"type":"object","properties":{"blocks":{"type":"array","items":{"$ref":"#/components/schemas/ContextBlocksBlocksItems"}},"executionId":{"type":"string"}},"required":["blocks","executionId"],"title":"ContextBlocks"},"Logs_capturedTextOfContextBlocks_Response_200":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/ContextBlocks"},"success":{"type":"boolean"}},"required":["data","success"],"title":"Logs_capturedTextOfContextBlocks_Response_200"},"V1LogsEntryGetResponsesContentApplicationJsonSchemaDataEntry":{"type":"object","properties":{},"title":"V1LogsEntryGetResponsesContentApplicationJsonSchemaDataEntry"},"V1LogsEntryGetResponsesContentApplicationJsonSchemaData":{"type":"object","properties":{"entry":{"oneOf":[{"$ref":"#/components/schemas/V1LogsEntryGetResponsesContentApplicationJsonSchemaDataEntry"},{"type":"null"}]}},"required":["entry"],"title":"V1LogsEntryGetResponsesContentApplicationJsonSchemaData"},"Logs_readOneLogEntryInFull_Response_200":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/V1LogsEntryGetResponsesContentApplicationJsonSchemaData"},"success":{"type":"boolean"}},"required":["data","success"],"title":"Logs_readOneLogEntryInFull_Response_200"},"V1LogsStatsGetResponsesContentApplicationJsonSchemaDataHistogramItems":{"type":"object","properties":{"bucket":{"type":"string"},"count":{"type":"number","format":"double"},"errors":{"type":"number","format":"double"}},"required":["bucket","count","errors"],"title":"V1LogsStatsGetResponsesContentApplicationJsonSchemaDataHistogramItems"},"V1LogsStatsGetResponsesContentApplicationJsonSchemaDataStatsSource":{"type":"string","enum":["store","legacy","mixed"],"description":"Which tier answered these counts. Always store today; the field exists so a granularity discontinuity is a labeled one rather than an unexplained drop in total.","title":"V1LogsStatsGetResponsesContentApplicationJsonSchemaDataStatsSource"},"V1LogsStatsGetResponsesContentApplicationJsonSchemaData":{"type":"object","properties":{"byCategory":{"type":"object","additionalProperties":{"type":"number","format":"double"}},"byLevel":{"type":"object","additionalProperties":{"type":"number","format":"double"}},"byStatus":{"type":"object","additionalProperties":{"type":"number","format":"double"}},"byType":{"type":"object","additionalProperties":{"type":"number","format":"double"}},"coveredFrom":{"type":["string","null"],"description":"The span plane’s earliest certified hour for this organization (ISO 8601). Counts before it are not in the store. Null when no hour is certified yet."},"degraded":{"type":"boolean","description":"True when the live overlay or the audit plane could not be read, so counts are partial. Absent on healthy responses, which are the only ones cached."},"histogram":{"type":"array","items":{"$ref":"#/components/schemas/V1LogsStatsGetResponsesContentApplicationJsonSchemaDataHistogramItems"}},"statsSource":{"$ref":"#/components/schemas/V1LogsStatsGetResponsesContentApplicationJsonSchemaDataStatsSource","description":"Which tier answered these counts. Always store today; the field exists so a granularity discontinuity is a labeled one rather than an unexplained drop in total."},"total":{"type":"number","format":"double"}},"required":["byCategory","byLevel","byStatus","byType","histogram","total"],"title":"V1LogsStatsGetResponsesContentApplicationJsonSchemaData"},"V1LogsStatsGetResponsesContentApplicationJsonSchemaWindow":{"type":"object","properties":{"from":{"type":"string","description":"Resolved start timestamp the query actually used"},"to":{"type":"string","description":"Resolved end timestamp the query actually used"}},"required":["from","to"],"description":"The time window the query resolved to, after defaults and from/to aliases.","title":"V1LogsStatsGetResponsesContentApplicationJsonSchemaWindow"},"Logs_getAggregatedLogStats_Response_200":{"type":"object","properties":{"cachedAt":{"type":["string","null"],"description":"When the response was served from cache, the cache write time. Null for fresh responses."},"data":{"$ref":"#/components/schemas/V1LogsStatsGetResponsesContentApplicationJsonSchemaData"},"success":{"type":"boolean"},"window":{"$ref":"#/components/schemas/V1LogsStatsGetResponsesContentApplicationJsonSchemaWindow","description":"The time window the query resolved to, after defaults and from/to aliases."}},"required":["data","success","window"],"title":"Logs_getAggregatedLogStats_Response_200"},"GetAggregatedLogStatsRequestPaymentRequiredError":{"type":"object","properties":{"code":{"type":"string"},"error":{"type":"string"},"message":{"type":"string"}},"required":["code","error","message"],"title":"GetAggregatedLogStatsRequestPaymentRequiredError"},"TraceCompareRequestLeft0":{"type":"object","properties":{"executionId":{"type":"string"}},"required":["executionId"],"title":"TraceCompareRequestLeft0"},"TraceCompareRequestLeftOneOf1FiltersSource":{"type":"string","enum":["hosted","ingested"],"title":"TraceCompareRequestLeftOneOf1FiltersSource"},"TraceCompareRequestLeftOneOf1FiltersStatus":{"type":"string","enum":["running","completed","failed"],"title":"TraceCompareRequestLeftOneOf1FiltersStatus"},"TraceCompareRequestLeftOneOf1Filters":{"type":"object","properties":{"agentIds":{"type":"array","items":{"type":"string"}},"agentVersionIds":{"type":"array","items":{"type":"string"},"description":"Hosted runs carry no agentVersionId on the trace header yet, so this filter matches ingested runs only."},"flowIds":{"type":"array","items":{"type":"string"}},"includeChildren":{"type":"boolean","description":"Count subagent and nested-flow runs too; unscoped reads fold them by default."},"model":{"type":"string","description":"Runs with any model call to this model. Reads spans, so the window is capped at 7 days."},"signal":{"type":"string","description":"Runs where this signal fired: `key` or `key:value`."},"source":{"$ref":"#/components/schemas/TraceCompareRequestLeftOneOf1FiltersSource"},"status":{"$ref":"#/components/schemas/TraceCompareRequestLeftOneOf1FiltersStatus"},"stopReason":{"type":"string"},"surfaceId":{"type":"string"}},"title":"TraceCompareRequestLeftOneOf1Filters"},"TraceCompareRequestLeft1":{"type":"object","properties":{"filters":{"$ref":"#/components/schemas/TraceCompareRequestLeftOneOf1Filters"}},"required":["filters"],"title":"TraceCompareRequestLeft1"},"TraceCompareRequestLeft":{"oneOf":[{"$ref":"#/components/schemas/TraceCompareRequestLeft0"},{"$ref":"#/components/schemas/TraceCompareRequestLeft1"}],"title":"TraceCompareRequestLeft"},"TraceCompareRequestRight0":{"type":"object","properties":{"executionId":{"type":"string"}},"required":["executionId"],"title":"TraceCompareRequestRight0"},"TraceCompareRequestRightOneOf1FiltersSource":{"type":"string","enum":["hosted","ingested"],"title":"TraceCompareRequestRightOneOf1FiltersSource"},"TraceCompareRequestRightOneOf1FiltersStatus":{"type":"string","enum":["running","completed","failed"],"title":"TraceCompareRequestRightOneOf1FiltersStatus"},"TraceCompareRequestRightOneOf1Filters":{"type":"object","properties":{"agentIds":{"type":"array","items":{"type":"string"}},"agentVersionIds":{"type":"array","items":{"type":"string"},"description":"Hosted runs carry no agentVersionId on the trace header yet, so this filter matches ingested runs only."},"flowIds":{"type":"array","items":{"type":"string"}},"includeChildren":{"type":"boolean","description":"Count subagent and nested-flow runs too; unscoped reads fold them by default."},"model":{"type":"string","description":"Runs with any model call to this model. Reads spans, so the window is capped at 7 days."},"signal":{"type":"string","description":"Runs where this signal fired: `key` or `key:value`."},"source":{"$ref":"#/components/schemas/TraceCompareRequestRightOneOf1FiltersSource"},"status":{"$ref":"#/components/schemas/TraceCompareRequestRightOneOf1FiltersStatus"},"stopReason":{"type":"string"},"surfaceId":{"type":"string"}},"title":"TraceCompareRequestRightOneOf1Filters"},"TraceCompareRequestRight1":{"type":"object","properties":{"filters":{"$ref":"#/components/schemas/TraceCompareRequestRightOneOf1Filters"}},"required":["filters"],"title":"TraceCompareRequestRight1"},"TraceCompareRequestRight":{"oneOf":[{"$ref":"#/components/schemas/TraceCompareRequestRight0"},{"$ref":"#/components/schemas/TraceCompareRequestRight1"}],"title":"TraceCompareRequestRight"},"TraceCompareRequest":{"type":"object","properties":{"from":{"type":"string"},"left":{"$ref":"#/components/schemas/TraceCompareRequestLeft"},"right":{"$ref":"#/components/schemas/TraceCompareRequestRight"},"sampleSize":{"type":"integer","minimum":1,"maximum":50},"to":{"type":"string"}},"required":["left","right"],"title":"TraceCompareRequest"},"TraceCompareOneOf0AlignmentItemsOp":{"type":"string","enum":["match","left_only","right_only","reordered"],"title":"TraceCompareOneOf0AlignmentItemsOp"},"TraceCompareOneOf0AlignmentItems":{"type":"object","properties":{"argDrift":{"type":["number","null"],"format":"double"},"driftedKeys":{"type":"array","items":{"type":"string"}},"leftIndex":{"type":["number","null"],"format":"double"},"op":{"$ref":"#/components/schemas/TraceCompareOneOf0AlignmentItemsOp"},"rightIndex":{"type":["number","null"],"format":"double"},"tool":{"type":"string"}},"required":["argDrift","leftIndex","op","rightIndex","tool"],"title":"TraceCompareOneOf0AlignmentItems"},"TraceCompareOneOf0Divergence":{"type":"object","properties":{"alignmentIndex":{"type":"number","format":"double"},"description":{"type":"string"},"leftIndex":{"type":["number","null"],"format":"double"},"rightIndex":{"type":["number","null"],"format":"double"}},"required":["alignmentIndex","description","leftIndex","rightIndex"],"title":"TraceCompareOneOf0Divergence"},"TraceCompareOneOf0Left":{"type":"object","properties":{"cost":{"type":["number","null"],"format":"double"},"durationMs":{"type":["number","null"],"format":"double"},"executionId":{"type":"string"},"inputTokens":{"type":["number","null"],"format":"double"},"outputTokens":{"type":["number","null"],"format":"double"},"source":{"type":"string"},"status":{"type":["string","null"]},"stopReason":{"type":["string","null"]},"toolCalls":{"type":"number","format":"double"},"turns":{"type":["number","null"],"format":"double"}},"required":["cost","durationMs","executionId","inputTokens","outputTokens","source","status","stopReason","toolCalls","turns"],"title":"TraceCompareOneOf0Left"},"TraceCompareOneOf0Mode":{"type":"string","enum":["executions"],"title":"TraceCompareOneOf0Mode"},"TraceCompareOneOf0PerToolItems":{"type":"object","properties":{"argDrift":{"type":["number","null"],"format":"double"},"leftCalls":{"type":"number","format":"double"},"leftErrors":{"type":"number","format":"double"},"rightCalls":{"type":"number","format":"double"},"rightErrors":{"type":"number","format":"double"},"tool":{"type":"string"}},"required":["argDrift","leftCalls","leftErrors","rightCalls","rightErrors","tool"],"title":"TraceCompareOneOf0PerToolItems"},"TraceCompareOneOf0Right":{"type":"object","properties":{"cost":{"type":["number","null"],"format":"double"},"durationMs":{"type":["number","null"],"format":"double"},"executionId":{"type":"string"},"inputTokens":{"type":["number","null"],"format":"double"},"outputTokens":{"type":["number","null"],"format":"double"},"source":{"type":"string"},"status":{"type":["string","null"]},"stopReason":{"type":["string","null"]},"toolCalls":{"type":"number","format":"double"},"turns":{"type":["number","null"],"format":"double"}},"required":["cost","durationMs","executionId","inputTokens","outputTokens","source","status","stopReason","toolCalls","turns"],"title":"TraceCompareOneOf0Right"},"TraceCompareOneOf0Truncated":{"type":"object","properties":{"left":{"type":"boolean"},"right":{"type":"boolean"}},"required":["left","right"],"title":"TraceCompareOneOf0Truncated"},"TraceCompare0":{"type":"object","properties":{"alignment":{"type":"array","items":{"$ref":"#/components/schemas/TraceCompareOneOf0AlignmentItems"}},"divergence":{"oneOf":[{"$ref":"#/components/schemas/TraceCompareOneOf0Divergence"},{"type":"null"}]},"left":{"$ref":"#/components/schemas/TraceCompareOneOf0Left"},"mode":{"$ref":"#/components/schemas/TraceCompareOneOf0Mode"},"perTool":{"type":"array","items":{"$ref":"#/components/schemas/TraceCompareOneOf0PerToolItems"}},"right":{"$ref":"#/components/schemas/TraceCompareOneOf0Right"},"truncated":{"$ref":"#/components/schemas/TraceCompareOneOf0Truncated"}},"required":["alignment","divergence","left","mode","perTool","right","truncated"],"title":"TraceCompare0"},"TraceCompareOneOf1LeftSignalRatesFiltered":{"type":"object","properties":{"evaluated":{"type":"number","format":"double"},"fired":{"type":"number","format":"double"},"rate":{"type":["number","null"],"format":"double"}},"required":["evaluated","fired","rate"],"title":"TraceCompareOneOf1LeftSignalRatesFiltered"},"TraceCompareOneOf1LeftSignalRatesUniform":{"type":"object","properties":{"evaluated":{"type":"number","format":"double"},"fired":{"type":"number","format":"double"},"rate":{"type":["number","null"],"format":"double"}},"required":["evaluated","fired","rate"],"title":"TraceCompareOneOf1LeftSignalRatesUniform"},"TraceCompareOneOf1LeftSignalRates":{"type":"object","properties":{"filtered":{"$ref":"#/components/schemas/TraceCompareOneOf1LeftSignalRatesFiltered"},"uniform":{"$ref":"#/components/schemas/TraceCompareOneOf1LeftSignalRatesUniform"}},"required":["filtered","uniform"],"title":"TraceCompareOneOf1LeftSignalRates"},"TraceCompareOneOf1LeftToolUsageItems":{"type":"object","properties":{"calls":{"type":"number","format":"double"},"callsPerRun":{"type":"number","format":"double"},"errors":{"type":"number","format":"double"},"runsUsing":{"type":"number","format":"double"},"shareOfRuns":{"type":"number","format":"double"},"tool":{"type":"string"}},"required":["calls","callsPerRun","errors","runsUsing","shareOfRuns","tool"],"title":"TraceCompareOneOf1LeftToolUsageItems"},"TraceCompareOneOf1Left":{"type":"object","properties":{"executionIds":{"type":"array","items":{"type":"string"}},"failureRate":{"type":["number","null"],"format":"double"},"sampleLimit":{"type":"number","format":"double"},"sampled":{"type":"number","format":"double"},"signalRates":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/TraceCompareOneOf1LeftSignalRates"}},"stopReasons":{"type":"object","additionalProperties":{"type":"number","format":"double"}},"toolUsage":{"type":"array","items":{"$ref":"#/components/schemas/TraceCompareOneOf1LeftToolUsageItems"}}},"required":["executionIds","failureRate","sampleLimit","sampled","signalRates","stopReasons","toolUsage"],"title":"TraceCompareOneOf1Left"},"TraceCompareOneOf1Mode":{"type":"string","enum":["cohorts"],"title":"TraceCompareOneOf1Mode"},"TraceCompareOneOf1RightSignalRatesFiltered":{"type":"object","properties":{"evaluated":{"type":"number","format":"double"},"fired":{"type":"number","format":"double"},"rate":{"type":["number","null"],"format":"double"}},"required":["evaluated","fired","rate"],"title":"TraceCompareOneOf1RightSignalRatesFiltered"},"TraceCompareOneOf1RightSignalRatesUniform":{"type":"object","properties":{"evaluated":{"type":"number","format":"double"},"fired":{"type":"number","format":"double"},"rate":{"type":["number","null"],"format":"double"}},"required":["evaluated","fired","rate"],"title":"TraceCompareOneOf1RightSignalRatesUniform"},"TraceCompareOneOf1RightSignalRates":{"type":"object","properties":{"filtered":{"$ref":"#/components/schemas/TraceCompareOneOf1RightSignalRatesFiltered"},"uniform":{"$ref":"#/components/schemas/TraceCompareOneOf1RightSignalRatesUniform"}},"required":["filtered","uniform"],"title":"TraceCompareOneOf1RightSignalRates"},"TraceCompareOneOf1RightToolUsageItems":{"type":"object","properties":{"calls":{"type":"number","format":"double"},"callsPerRun":{"type":"number","format":"double"},"errors":{"type":"number","format":"double"},"runsUsing":{"type":"number","format":"double"},"shareOfRuns":{"type":"number","format":"double"},"tool":{"type":"string"}},"required":["calls","callsPerRun","errors","runsUsing","shareOfRuns","tool"],"title":"TraceCompareOneOf1RightToolUsageItems"},"TraceCompareOneOf1Right":{"type":"object","properties":{"executionIds":{"type":"array","items":{"type":"string"}},"failureRate":{"type":["number","null"],"format":"double"},"sampleLimit":{"type":"number","format":"double"},"sampled":{"type":"number","format":"double"},"signalRates":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/TraceCompareOneOf1RightSignalRates"}},"stopReasons":{"type":"object","additionalProperties":{"type":"number","format":"double"}},"toolUsage":{"type":"array","items":{"$ref":"#/components/schemas/TraceCompareOneOf1RightToolUsageItems"}}},"required":["executionIds","failureRate","sampleLimit","sampled","signalRates","stopReasons","toolUsage"],"title":"TraceCompareOneOf1Right"},"TraceCompareOneOf1ToolShareDeltaItems":{"type":"object","properties":{"delta":{"type":"number","format":"double"},"left":{"type":"number","format":"double"},"right":{"type":"number","format":"double"},"tool":{"type":"string"}},"required":["delta","left","right","tool"],"title":"TraceCompareOneOf1ToolShareDeltaItems"},"TraceCompareOneOf1Window":{"type":"object","properties":{"from":{"type":"string"},"to":{"type":"string"}},"required":["from","to"],"title":"TraceCompareOneOf1Window"},"TraceCompare1":{"type":"object","properties":{"left":{"$ref":"#/components/schemas/TraceCompareOneOf1Left"},"mode":{"$ref":"#/components/schemas/TraceCompareOneOf1Mode"},"right":{"$ref":"#/components/schemas/TraceCompareOneOf1Right"},"toolShareDelta":{"type":"array","items":{"$ref":"#/components/schemas/TraceCompareOneOf1ToolShareDeltaItems"}},"window":{"$ref":"#/components/schemas/TraceCompareOneOf1Window"}},"required":["left","mode","right","toolShareDelta","window"],"title":"TraceCompare1"},"TraceCompare":{"oneOf":[{"$ref":"#/components/schemas/TraceCompare0"},{"$ref":"#/components/schemas/TraceCompare1"}],"title":"TraceCompare"},"Logs_compareTraces_Response_200":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/TraceCompare"},"success":{"type":"boolean"}},"required":["data","success"],"title":"Logs_compareTraces_Response_200"},"TraceTreeAvailabilityReason":{"type":"string","enum":["json_ingest_compatibility_path"],"title":"TraceTreeAvailabilityReason"},"TraceTreeAvailability":{"type":"object","properties":{"available":{"type":"boolean"},"message":{"type":"string"},"reason":{"$ref":"#/components/schemas/TraceTreeAvailabilityReason"}},"required":["available","message","reason"],"title":"TraceTreeAvailability"},"TraceTreeChildTruncationReason":{"type":"string","enum":["child_limit"],"title":"TraceTreeChildTruncationReason"},"TraceTreeChildTruncation":{"type":"object","properties":{"limit":{"type":"number","format":"double"},"message":{"type":"string"},"reason":{"$ref":"#/components/schemas/TraceTreeChildTruncationReason"}},"required":["limit","message","reason"],"description":"Present only when the child-run read hit its per-parent ceiling, so later child runs are not grafted and their tool-call spans carry no `childExecutionId`. Absent otherwise.","title":"TraceTreeChildTruncation"},"TraceProducedBySource":{"type":"string","enum":["native","external"],"title":"TraceProducedBySource"},"TraceProducedBy":{"type":"object","properties":{"adapterName":{"type":["string","null"]},"adapterVersion":{"type":["string","null"]},"agentId":{"type":["string","null"]},"agentName":{"type":["string","null"]},"agentVersionId":{"type":["string","null"]},"agentVersionLabel":{"type":["string","null"]},"callable":{"type":"boolean"},"fidelityTier":{"type":["string","null"]},"flowId":{"type":["string","null"]},"flowName":{"type":["string","null"]},"flowVersionId":{"type":["string","null"]},"productId":{"type":["string","null"]},"productName":{"type":["string","null"]},"source":{"$ref":"#/components/schemas/TraceProducedBySource"},"surfaceType":{"type":["string","null"]}},"required":["source"],"title":"TraceProducedBy"},"TraceLogEntryEstimatedContextBreakdownCategories":{"type":"object","properties":{"chars":{"type":"number","format":"double"},"estimatedTokens":{"type":"number","format":"double"}},"required":["chars","estimatedTokens"],"title":"TraceLogEntryEstimatedContextBreakdownCategories"},"TraceLogEntryEstimatedContextBreakdown":{"type":"object","properties":{"categories":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/TraceLogEntryEstimatedContextBreakdownCategories"}},"contextWindowSize":{"type":"number","format":"double"},"estimatedTotalTokens":{"type":"number","format":"double"},"estimatedUtilizationPercent":{"type":"number","format":"double"}},"required":["categories","estimatedTotalTokens"],"title":"TraceLogEntryEstimatedContextBreakdown"},"TraceLogEntryEstimatedCost":{"oneOf":[{"type":"number","format":"double"},{"type":"string"}],"description":"Observed cost. Absent or null means unknown, never zero.","title":"TraceLogEntryEstimatedCost"},"TraceLogEntryLevel":{"type":"string","enum":["debug","info","warn","error"],"title":"TraceLogEntryLevel"},"TraceLogEntryLoggingPolicy":{"type":"string","enum":["off"],"title":"TraceLogEntryLoggingPolicy"},"TraceLogEntryOtlpIncompleteActivity":{"type":"string","enum":["invoke_agent","chat","execute_tool"],"title":"TraceLogEntryOtlpIncompleteActivity"},"TraceLogEntryOtlpInstrumentationWarning":{"type":"string","enum":["span_not_ended"],"title":"TraceLogEntryOtlpInstrumentationWarning"},"TraceLogEntryOtlpRecordKind":{"type":"string","enum":["span","span_event","log_record"],"title":"TraceLogEntryOtlpRecordKind"},"TraceLogEntryStatus":{"type":"string","enum":["running","completed","failed","queued","cancelled","unknown"],"title":"TraceLogEntryStatus"},"TraceLogEntryType":{"type":"string","enum":["flow","step","tool","batch","system","agent","model","schedule","audit"],"title":"TraceLogEntryType"},"TraceLogEntry":{"type":"object","properties":{"agentId":{"type":["string","null"]},"agentName":{"type":["string","null"]},"batchExecutionId":{"type":["string","null"]},"cacheReadTokens":{"type":["number","null"],"format":"double"},"cacheWriteTokens":{"type":["number","null"],"format":"double"},"completionTokens":{"type":["number","null"],"format":"double"},"configuredModel":{"type":["string","null"]},"conversationId":{"type":["string","null"]},"description":{"type":"string"},"durationMs":{"type":["number","null"],"format":"double"},"error":{"type":["string","null"]},"errorStack":{"type":["string","null"]},"estimatedContextBreakdown":{"oneOf":[{"$ref":"#/components/schemas/TraceLogEntryEstimatedContextBreakdown"},{"type":"null"}]},"estimatedCost":{"oneOf":[{"$ref":"#/components/schemas/TraceLogEntryEstimatedCost"},{"type":"null"}],"description":"Observed cost. Absent or null means unknown, never zero."},"eventName":{"type":["string","null"]},"executionSessionId":{"type":["string","null"]},"fallbackModel":{"type":["string","null"]},"flowId":{"type":["string","null"]},"flowName":{"type":["string","null"]},"id":{"type":"string"},"input":{"description":"Arbitrary JSON; shape varies by producer."},"inputSummary":{"type":["string","null"]},"isStreaming":{"type":"boolean"},"iteration":{"type":["number","null"],"format":"double"},"level":{"$ref":"#/components/schemas/TraceLogEntryLevel"},"loggingPolicy":{"$ref":"#/components/schemas/TraceLogEntryLoggingPolicy"},"metadata":{"type":"object","additionalProperties":{"description":"Any type"},"description":"Producer bag. Span-store reads carry spanKind, completeness, logicalParentId, otlpAttributes, otlpSpanEvents, systemInstructions, artifacts and state here."},"modelUsed":{"type":["string","null"]},"otlpIncompleteActivity":{"$ref":"#/components/schemas/TraceLogEntryOtlpIncompleteActivity"},"otlpInstrumentationWarning":{"$ref":"#/components/schemas/TraceLogEntryOtlpInstrumentationWarning"},"otlpOperationName":{"type":["string","null"]},"otlpParentSpanId":{"type":["string","null"]},"otlpRecordHash":{"type":["string","null"]},"otlpRecordKind":{"$ref":"#/components/schemas/TraceLogEntryOtlpRecordKind"},"otlpRetentionScope":{"type":["string","null"]},"otlpSpanEventIndex":{"type":["number","null"],"format":"double"},"otlpSpanId":{"type":["string","null"]},"output":{"description":"Arbitrary JSON; shape varies by producer."},"outputSummary":{"type":["string","null"]},"promptTokens":{"type":["number","null"],"format":"double"},"providerErrorClass":{"type":["string","null"]},"providerHost":{"type":["string","null"]},"providerHttpMethod":{"type":["string","null"]},"providerHttpStatus":{"type":["number","null"],"format":"double"},"providerRateLimitHeaders":{"type":["object","null"],"additionalProperties":{"type":"string"}},"reasoningTokens":{"type":["number","null"],"format":"double"},"recordId":{"type":["string","null"]},"recordName":{"type":["string","null"]},"requestId":{"type":["string","null"]},"resolvedModel":{"type":["string","null"]},"seq":{"type":"number","format":"double"},"status":{"$ref":"#/components/schemas/TraceLogEntryStatus"},"stepId":{"type":["string","null"]},"stepName":{"type":["string","null"]},"stepType":{"type":["string","null"]},"stopReason":{"type":["string","null"]},"streamContent":{"type":"string"},"subtitle":{"type":"string"},"surfaceId":{"type":["string","null"]},"surfaceType":{"type":["string","null"]},"timestamp":{"type":"string"},"title":{"type":"string"},"toolCallId":{"type":["string","null"]},"toolName":{"type":["string","null"]},"toolType":{"type":["string","null"]},"totalTokens":{"type":["number","null"],"format":"double"},"turnId":{"type":["string","null"]},"type":{"$ref":"#/components/schemas/TraceLogEntryType"},"usedFallback":{"type":["boolean","null"]}},"required":["id","level","status","timestamp","title","type"],"title":"TraceLogEntry"},"TraceNodeLifecycle":{"type":"string","enum":["single","paired","start-only","complete-only"],"title":"TraceNodeLifecycle"},"TraceNodeNodeType":{"type":"string","enum":["root","iteration","model","tool","step","system"],"title":"TraceNodeNodeType"},"SignalAnswerBand":{"type":"string","enum":["act","review","low"],"title":"SignalAnswerBand"},"SignalSource":{"type":"object","properties":{"end":{"type":"integer","minimum":0},"field":{"type":"string"},"spanId":{"type":"string"},"start":{"type":"integer","minimum":0}},"required":["end","field","spanId","start"],"title":"SignalSource"},"SignalAnswer":{"type":"object","properties":{"band":{"$ref":"#/components/schemas/SignalAnswerBand"},"confidence":{"type":"number","format":"double","minimum":0,"maximum":1},"distribution":{"type":"object","additionalProperties":{"type":"number","format":"double"}},"fired":{"type":"boolean"},"pNull":{"type":"number","format":"double"},"refused":{"type":"boolean"},"source":{"$ref":"#/components/schemas/SignalSource"},"sources":{"type":"array","items":{"$ref":"#/components/schemas/SignalSource"}},"value":{"description":"Any type"}},"required":["band"],"title":"SignalAnswer"},"SignalResultSample":{"type":"string","enum":["uniform","filtered"],"title":"SignalResultSample"},"SignalResultSignalSet":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"version":{"type":"integer"}},"required":["id","name","version"],"title":"SignalResultSignalSet"},"SignalResultStatus":{"type":"string","enum":["complete","failed","skipped_budget","skipped_policy","skipped_billing"],"title":"SignalResultStatus"},"SignalResultTarget":{"type":"object","properties":{"executionId":{"type":"string"},"spanId":{"type":["string","null"]},"turnIndex":{"type":["integer","null"]}},"required":["executionId","spanId","turnIndex"],"title":"SignalResultTarget"},"SignalResultUnit":{"type":"string","enum":["turn","conversation","run"],"title":"SignalResultUnit"},"SignalResult":{"type":"object","properties":{"answers":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/SignalAnswer"}},"bindingId":{"type":"string"},"computedAt":{"type":"string"},"error":{"type":"string"},"fired":{"type":"array","items":{"type":"string"}},"sample":{"$ref":"#/components/schemas/SignalResultSample"},"signalSet":{"$ref":"#/components/schemas/SignalResultSignalSet"},"status":{"$ref":"#/components/schemas/SignalResultStatus"},"target":{"$ref":"#/components/schemas/SignalResultTarget"},"unit":{"$ref":"#/components/schemas/SignalResultUnit"},"values":{"type":"object","additionalProperties":{"description":"Any type"}}},"required":["answers","bindingId","computedAt","fired","sample","signalSet","status","target","unit","values"],"title":"SignalResult"},"TraceNodeSignals":{"type":"object","properties":{"fired":{"type":"array","items":{"type":"string"}},"results":{"type":"array","items":{"$ref":"#/components/schemas/SignalResult"}}},"required":["fired","results"],"description":"Signal results that target this span. Omitted until the organization binds a signal set.","title":"TraceNodeSignals"},"TraceNode":{"type":"object","properties":{"childExecutionId":{"type":["string","null"]},"children":{"type":"array","items":{"$ref":"#/components/schemas/TraceNode"}},"depth":{"type":"number","format":"double"},"endOffsetMs":{"type":["number","null"],"format":"double"},"endedAt":{"type":["string","null"]},"entry":{"$ref":"#/components/schemas/TraceLogEntry"},"failed":{"type":"boolean"},"lifecycle":{"$ref":"#/components/schemas/TraceNodeLifecycle"},"nodeType":{"$ref":"#/components/schemas/TraceNodeNodeType"},"recorded":{"type":"boolean"},"signals":{"$ref":"#/components/schemas/TraceNodeSignals","description":"Signal results that target this span. Omitted until the organization binds a signal set."},"startEntry":{"$ref":"#/components/schemas/TraceLogEntry"},"startOffsetMs":{"type":["number","null"],"format":"double"},"startedAt":{"type":["string","null"]},"synthetic":{"type":"boolean"}},"required":["children","depth","entry","nodeType"],"title":"TraceNode"},"SignalsBlockStatus":{"type":"string","enum":["complete","pending","partial","none","unavailable"],"title":"SignalsBlockStatus"},"SignalsBlock":{"type":"object","properties":{"fired":{"type":"array","items":{"type":"string"}},"results":{"type":"array","items":{"$ref":"#/components/schemas/SignalResult"}},"status":{"$ref":"#/components/schemas/SignalsBlockStatus"}},"required":["fired","results","status"],"description":"Typed signals read from this trace by the signal sets bound to its agent. Omitted entirely until the organization binds a signal set; once it has, `status` is `none` on a trace no binding matched.","title":"SignalsBlock"},"TraceTreeSource":{"type":"string","enum":["logs","records","logs+records"],"title":"TraceTreeSource"},"TraceTreeTotalsSource":{"type":"string","enum":["execution","partial"],"title":"TraceTreeTotalsSource"},"TraceTreeTruncationReason":{"type":"string","enum":["record_limit"],"title":"TraceTreeTruncationReason"},"TraceTreeTruncation":{"type":"object","properties":{"limit":{"type":"number","format":"double"},"message":{"type":"string"},"reason":{"$ref":"#/components/schemas/TraceTreeTruncationReason"}},"required":["limit","message","reason"],"title":"TraceTreeTruncation"},"TraceTree":{"type":"object","properties":{"availability":{"$ref":"#/components/schemas/TraceTreeAvailability"},"childTruncation":{"$ref":"#/components/schemas/TraceTreeChildTruncation","description":"Present only when the child-run read hit its per-parent ceiling, so later child runs are not grafted and their tool-call spans carry no `childExecutionId`. Absent otherwise."},"contentUnavailable":{"type":"boolean","description":"A span with spilled content could not be read back; those spans carry previews."},"failedCount":{"type":"number","format":"double"},"nodeCount":{"type":"number","format":"double"},"producedBy":{"$ref":"#/components/schemas/TraceProducedBy"},"root":{"oneOf":[{"$ref":"#/components/schemas/TraceNode"},{"type":"null"}]},"runFailed":{"type":"boolean","description":"The run itself failed, as opposed to a span inside a run that completed."},"signals":{"$ref":"#/components/schemas/SignalsBlock"},"source":{"$ref":"#/components/schemas/TraceTreeSource"},"startedAt":{"type":["string","null"]},"toolTimeMs":{"type":["number","null"],"format":"double"},"toolTimeOverlapped":{"type":"boolean"},"totalCost":{"type":["number","null"],"format":"double"},"totalDuration":{"type":["number","null"],"format":"double"},"totalTokens":{"type":["number","null"],"format":"double"},"totalsSource":{"$ref":"#/components/schemas/TraceTreeTotalsSource"},"truncation":{"$ref":"#/components/schemas/TraceTreeTruncation"}},"required":["nodeCount","root","totalCost","totalDuration","totalTokens"],"title":"TraceTree"},"ConversationTraceExecutionsItems":{"type":"object","properties":{"executionId":{"type":"string"},"timestamp":{"type":"string"},"tree":{"$ref":"#/components/schemas/TraceTree"}},"required":["executionId","timestamp","tree"],"title":"ConversationTraceExecutionsItems"},"ConversationTraceProducedBySource":{"type":"string","enum":["native","external"],"title":"ConversationTraceProducedBySource"},"ConversationTraceProducedBy":{"type":"object","properties":{"adapterName":{"type":["string","null"]},"adapterVersion":{"type":["string","null"]},"agentId":{"type":["string","null"]},"agentName":{"type":["string","null"]},"agentVersionId":{"type":["string","null"]},"agentVersionLabel":{"type":["string","null"]},"callable":{"type":"boolean"},"fidelityTier":{"type":["string","null"]},"flowId":{"type":["string","null"]},"flowName":{"type":["string","null"]},"flowVersionId":{"type":["string","null"]},"productId":{"type":["string","null"]},"productName":{"type":["string","null"]},"source":{"$ref":"#/components/schemas/ConversationTraceProducedBySource"},"surfaceType":{"type":["string","null"]}},"required":["source"],"description":"What authored the conversation as a whole; absent when unresolved.","title":"ConversationTraceProducedBy"},"ConversationTraceSignalsStatus":{"type":"string","enum":["complete","pending","partial","none","unavailable"],"title":"ConversationTraceSignalsStatus"},"ConversationTraceSignals":{"type":"object","properties":{"fired":{"type":"array","items":{"type":"string"}},"results":{"type":"array","items":{"$ref":"#/components/schemas/SignalResult"}},"status":{"$ref":"#/components/schemas/ConversationTraceSignalsStatus"}},"required":["fired","results","status"],"description":"Conversation-level signals: the union of what fired across the turns. Each turn also carries its own block on its tree. Omitted until the organization binds a signal set.","title":"ConversationTraceSignals"},"ConversationTraceTruncationReason":{"type":"string","enum":["record_limit"],"title":"ConversationTraceTruncationReason"},"ConversationTraceTruncation":{"type":"object","properties":{"limit":{"type":"number","format":"double"},"message":{"type":"string"},"reason":{"$ref":"#/components/schemas/ConversationTraceTruncationReason"}},"required":["limit","message","reason"],"title":"ConversationTraceTruncation"},"ConversationTrace":{"type":"object","properties":{"conversationId":{"type":"string"},"executions":{"type":"array","items":{"$ref":"#/components/schemas/ConversationTraceExecutionsItems"}},"producedBy":{"$ref":"#/components/schemas/ConversationTraceProducedBy","description":"What authored the conversation as a whole; absent when unresolved."},"signals":{"$ref":"#/components/schemas/ConversationTraceSignals","description":"Conversation-level signals: the union of what fired across the turns. Each turn also carries its own block on its tree. Omitted until the organization binds a signal set."},"totalExecutions":{"type":"number","format":"double"},"truncation":{"$ref":"#/components/schemas/ConversationTraceTruncation"}},"required":["conversationId","executions","totalExecutions"],"title":"ConversationTrace"},"Logs_traceAConversation_Response_200":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/ConversationTrace"},"success":{"type":"boolean"}},"required":["data","success"],"title":"Logs_traceAConversation_Response_200"},"Logs_traceAnExecution_Response_200":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/TraceTree"},"success":{"type":"boolean"}},"required":["data","success"],"title":"Logs_traceAnExecution_Response_200"},"V1LogsTraceExecutionExecutionIdChildrenGetResponsesContentApplicationJsonSchemaDataItems":{"type":"object","properties":{"completedAt":{"type":["string","null"]},"executionId":{"type":"string"},"parentToolCallId":{"type":["string","null"]},"signals":{"$ref":"#/components/schemas/SignalsBlock"},"startedAt":{"type":["string","null"]},"status":{"type":"string"}},"required":["completedAt","executionId","parentToolCallId","startedAt","status"],"title":"V1LogsTraceExecutionExecutionIdChildrenGetResponsesContentApplicationJsonSchemaDataItems"},"Logs_listChildExecutionsOfARun_Response_200":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1LogsTraceExecutionExecutionIdChildrenGetResponsesContentApplicationJsonSchemaDataItems"}},"success":{"type":"boolean"},"truncated":{"type":"boolean","description":"Present and true only when the span-store leg of this read hit its per-parent ceiling, so later children it holds are not listed. Absent otherwise."}},"required":["data","success"],"title":"Logs_listChildExecutionsOfARun_Response_200"},"V1LogsTraceExecutionExecutionIdExplainPostResponsesContentApplicationJsonSchemaDataAnalysisHypothesesItems":{"type":"object","properties":{"eventIds":{"type":"array","items":{"type":"string","minLength":1,"maxLength":256}},"text":{"type":"string","minLength":1,"maxLength":700}},"required":["eventIds","text"],"title":"V1LogsTraceExecutionExecutionIdExplainPostResponsesContentApplicationJsonSchemaDataAnalysisHypothesesItems"},"V1LogsTraceExecutionExecutionIdExplainPostResponsesContentApplicationJsonSchemaDataAnalysisNextStepsItems":{"type":"object","properties":{"eventIds":{"type":"array","items":{"type":"string","minLength":1,"maxLength":256}},"text":{"type":"string","minLength":1,"maxLength":700}},"required":["eventIds","text"],"title":"V1LogsTraceExecutionExecutionIdExplainPostResponsesContentApplicationJsonSchemaDataAnalysisNextStepsItems"},"V1LogsTraceExecutionExecutionIdExplainPostResponsesContentApplicationJsonSchemaDataAnalysisObservationsItems":{"type":"object","properties":{"eventIds":{"type":"array","items":{"type":"string","minLength":1,"maxLength":256}},"text":{"type":"string","minLength":1,"maxLength":700}},"required":["eventIds","text"],"title":"V1LogsTraceExecutionExecutionIdExplainPostResponsesContentApplicationJsonSchemaDataAnalysisObservationsItems"},"V1LogsTraceExecutionExecutionIdExplainPostResponsesContentApplicationJsonSchemaDataAnalysisOverview":{"type":"object","properties":{"eventIds":{"type":"array","items":{"type":"string","minLength":1,"maxLength":256}},"text":{"type":"string","minLength":1,"maxLength":700}},"required":["eventIds","text"],"title":"V1LogsTraceExecutionExecutionIdExplainPostResponsesContentApplicationJsonSchemaDataAnalysisOverview"},"V1LogsTraceExecutionExecutionIdExplainPostResponsesContentApplicationJsonSchemaDataAnalysis":{"type":"object","properties":{"hypotheses":{"type":"array","items":{"$ref":"#/components/schemas/V1LogsTraceExecutionExecutionIdExplainPostResponsesContentApplicationJsonSchemaDataAnalysisHypothesesItems"}},"limitations":{"type":"array","items":{"type":"string","minLength":1,"maxLength":400}},"nextSteps":{"type":"array","items":{"$ref":"#/components/schemas/V1LogsTraceExecutionExecutionIdExplainPostResponsesContentApplicationJsonSchemaDataAnalysisNextStepsItems"}},"observations":{"type":"array","items":{"$ref":"#/components/schemas/V1LogsTraceExecutionExecutionIdExplainPostResponsesContentApplicationJsonSchemaDataAnalysisObservationsItems"}},"overview":{"$ref":"#/components/schemas/V1LogsTraceExecutionExecutionIdExplainPostResponsesContentApplicationJsonSchemaDataAnalysisOverview"}},"required":["hypotheses","limitations","nextSteps","observations","overview"],"title":"V1LogsTraceExecutionExecutionIdExplainPostResponsesContentApplicationJsonSchemaDataAnalysis"},"V1LogsTraceExecutionExecutionIdExplainPostResponsesContentApplicationJsonSchemaDataQualityAssessment":{"type":"string","enum":["not_assessed"],"title":"V1LogsTraceExecutionExecutionIdExplainPostResponsesContentApplicationJsonSchemaDataQualityAssessment"},"V1LogsTraceExecutionExecutionIdExplainPostResponsesContentApplicationJsonSchemaData":{"type":"object","properties":{"analysis":{"$ref":"#/components/schemas/V1LogsTraceExecutionExecutionIdExplainPostResponsesContentApplicationJsonSchemaDataAnalysis"},"analysisExecutionId":{"type":"string"},"analyzerVersion":{"type":"integer"},"coverageWarnings":{"type":"array","items":{"type":"string"}},"evidenceCount":{"type":"integer","minimum":0},"executionId":{"type":"string"},"generatedAt":{"type":"string"},"qualityAssessment":{"$ref":"#/components/schemas/V1LogsTraceExecutionExecutionIdExplainPostResponsesContentApplicationJsonSchemaDataQualityAssessment"}},"required":["analysis","analysisExecutionId","analyzerVersion","coverageWarnings","evidenceCount","executionId","generatedAt","qualityAssessment"],"title":"V1LogsTraceExecutionExecutionIdExplainPostResponsesContentApplicationJsonSchemaData"},"Logs_explainARunUsingRetainedTraceEvidence_Response_200":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/V1LogsTraceExecutionExecutionIdExplainPostResponsesContentApplicationJsonSchemaData"},"success":{"type":"boolean"}},"required":["data","success"],"title":"Logs_explainARunUsingRetainedTraceEvidence_Response_200"},"V1LogsTraceExecutionExecutionIdSliceGetParametersKind":{"type":"string","enum":["model","tool","step"],"title":"V1LogsTraceExecutionExecutionIdSliceGetParametersKind"},"V1LogsTraceExecutionExecutionIdSliceGetParametersIncludeContent":{"type":"string","enum":["true","false"],"description":"Load full content for the selected spans only, under maxContentBytes.","title":"V1LogsTraceExecutionExecutionIdSliceGetParametersIncludeContent"},"TraceSliceContentCutItems":{"type":"object","properties":{"bytes":{"type":"number","format":"double"},"field":{"type":"string"},"returnedBytes":{"type":"number","format":"double"},"spanId":{"type":"string"}},"required":["bytes","field","returnedBytes","spanId"],"title":"TraceSliceContentCutItems"},"TraceSliceContent":{"type":"object","properties":{"cut":{"type":"array","items":{"$ref":"#/components/schemas/TraceSliceContentCutItems"}},"limitBytes":{"type":"number","format":"double"},"loaded":{"type":"boolean"},"unavailable":{"type":"array","items":{"type":"string"}},"usedBytes":{"type":"number","format":"double"}},"required":["cut","limitBytes","loaded","unavailable","usedBytes"],"title":"TraceSliceContent"},"TraceSliceSelectionMode":{"type":"string","enum":["range","around_first_failure"],"title":"TraceSliceSelectionMode"},"TraceSliceSelection":{"type":"object","properties":{"firstFailedIndex":{"type":["number","null"],"format":"double"},"from":{"type":"number","format":"double"},"mode":{"$ref":"#/components/schemas/TraceSliceSelectionMode"},"to":{"type":"number","format":"double"}},"required":["firstFailedIndex","from","mode","to"],"title":"TraceSliceSelection"},"TraceSliceSpansItems":{"type":"object","properties":{"content":{"type":"object","additionalProperties":{"description":"Any type"}},"cost":{"type":["number","null"],"format":"double"},"durationMs":{"type":["number","null"],"format":"double"},"error":{"type":["string","null"]},"index":{"type":"number","format":"double"},"inputPreview":{"type":["string","null"]},"inputTokens":{"type":["number","null"],"format":"double"},"kind":{"type":["string","null"]},"model":{"type":["string","null"]},"name":{"type":"string"},"outputPreview":{"type":["string","null"]},"outputTokens":{"type":["number","null"],"format":"double"},"parentSpanId":{"type":["string","null"]},"spanId":{"type":["string","null"]},"startedAt":{"type":"string"},"status":{"type":"string"},"stopReason":{"type":["string","null"]},"toolName":{"type":["string","null"]}},"required":["cost","durationMs","error","index","inputPreview","inputTokens","kind","model","name","outputPreview","outputTokens","parentSpanId","spanId","startedAt","status","stopReason","toolName"],"title":"TraceSliceSpansItems"},"TraceSlice":{"type":"object","properties":{"content":{"$ref":"#/components/schemas/TraceSliceContent"},"executionId":{"type":"string"},"matchedSpans":{"type":"number","format":"double"},"selection":{"$ref":"#/components/schemas/TraceSliceSelection"},"source":{"type":"string"},"spans":{"type":"array","items":{"$ref":"#/components/schemas/TraceSliceSpansItems"}},"totalSpans":{"type":"number","format":"double"},"traceId":{"type":"string"},"traceTruncated":{"type":"boolean","description":"The trace exceeded the span read ceiling."},"truncated":{"type":"boolean","description":"More spans matched than were returned."}},"required":["content","executionId","matchedSpans","selection","source","spans","totalSpans","traceId","traceTruncated","truncated"],"title":"TraceSlice"},"Logs_readATraceSlice_Response_200":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/TraceSlice"},"success":{"type":"boolean"}},"required":["data","success"],"title":"Logs_readATraceSlice_Response_200"},"TraceQueryRequestGroupByItems":{"type":"string","enum":["agent","agent_version","flow","surface","model","source","status","stop_reason","day"],"title":"TraceQueryRequestGroupByItems"},"TraceQueryRequestSource":{"type":"string","enum":["hosted","ingested"],"title":"TraceQueryRequestSource"},"TraceQueryRequestStatus":{"type":"string","enum":["running","completed","failed"],"title":"TraceQueryRequestStatus"},"TraceQueryRequest":{"type":"object","properties":{"agentIds":{"type":"array","items":{"type":"string"}},"agentVersionIds":{"type":"array","items":{"type":"string"},"description":"Hosted runs carry no agentVersionId on the trace header yet, so this filter matches ingested runs only."},"cursor":{"type":"string"},"flowIds":{"type":"array","items":{"type":"string"}},"from":{"type":"string","description":"ISO 8601; default 7 days before `to`."},"groupBy":{"type":"array","items":{"$ref":"#/components/schemas/TraceQueryRequestGroupByItems"}},"includeChildren":{"type":"boolean","description":"Count subagent and nested-flow runs too; unscoped reads fold them by default."},"includeToolCalls":{"type":"boolean","description":"Tool-call percentiles per group. Reads spans, so the window is capped at 7 days. Default false."},"limit":{"type":"integer","minimum":1,"maximum":200},"model":{"type":"string","description":"Runs with any model call to this model. Reads spans, so the window is capped at 7 days."},"signal":{"type":"string","description":"Runs where this signal fired: `key` or `key:value`."},"signalRate":{"type":"string","description":"Fire rate of this signal (`key` or `key:value`) per group; uniform and filtered samples are reported apart."},"source":{"$ref":"#/components/schemas/TraceQueryRequestSource"},"status":{"$ref":"#/components/schemas/TraceQueryRequestStatus"},"stopReason":{"type":"string"},"surfaceId":{"type":"string"},"to":{"type":"string","description":"ISO 8601; default now. Windows over 30 days are refused."}},"title":"TraceQueryRequest"},"TraceQueryResultGroupByItems":{"type":"string","enum":["agent","agent_version","flow","surface","model","source","status","stop_reason","day"],"title":"TraceQueryResultGroupByItems"},"TraceQueryResultGroupsItemsCost":{"type":"object","properties":{"p50":{"type":["number","null"],"format":"double"},"p95":{"type":["number","null"],"format":"double"},"pricedRuns":{"type":"number","format":"double"},"sum":{"type":["number","null"],"format":"double"},"unpricedRuns":{"type":"number","format":"double"}},"required":["p50","p95","pricedRuns","sum","unpricedRuns"],"title":"TraceQueryResultGroupsItemsCost"},"TraceQueryResultGroupsItemsDurationMs":{"type":"object","properties":{"p50":{"type":["number","null"],"format":"double"},"p95":{"type":["number","null"],"format":"double"}},"required":["p50","p95"],"title":"TraceQueryResultGroupsItemsDurationMs"},"TraceQueryResultGroupsItemsSignalRateFiltered":{"type":"object","properties":{"evaluated":{"type":"number","format":"double"},"fired":{"type":"number","format":"double"},"rate":{"type":["number","null"],"format":"double"}},"required":["evaluated","fired","rate"],"title":"TraceQueryResultGroupsItemsSignalRateFiltered"},"TraceQueryResultGroupsItemsSignalRateUniform":{"type":"object","properties":{"evaluated":{"type":"number","format":"double"},"fired":{"type":"number","format":"double"},"rate":{"type":["number","null"],"format":"double"}},"required":["evaluated","fired","rate"],"title":"TraceQueryResultGroupsItemsSignalRateUniform"},"TraceQueryResultGroupsItemsSignalRate":{"type":"object","properties":{"filtered":{"$ref":"#/components/schemas/TraceQueryResultGroupsItemsSignalRateFiltered"},"uniform":{"$ref":"#/components/schemas/TraceQueryResultGroupsItemsSignalRateUniform"}},"required":["filtered","uniform"],"title":"TraceQueryResultGroupsItemsSignalRate"},"TraceQueryResultGroupsItemsTokens":{"type":"object","properties":{"p50":{"type":["number","null"],"format":"double"},"p95":{"type":["number","null"],"format":"double"},"reportedRuns":{"type":"number","format":"double"},"sum":{"type":["number","null"],"format":"double"}},"required":["p50","p95","reportedRuns","sum"],"title":"TraceQueryResultGroupsItemsTokens"},"TraceQueryResultGroupsItemsToolCalls":{"type":"object","properties":{"p50":{"type":["number","null"],"format":"double"},"p95":{"type":["number","null"],"format":"double"}},"required":["p50","p95"],"title":"TraceQueryResultGroupsItemsToolCalls"},"TraceQueryResultGroupsItems":{"type":"object","properties":{"cost":{"$ref":"#/components/schemas/TraceQueryResultGroupsItemsCost"},"count":{"type":"number","format":"double"},"durationMs":{"$ref":"#/components/schemas/TraceQueryResultGroupsItemsDurationMs"},"failed":{"type":"number","format":"double"},"failureRate":{"type":["number","null"],"format":"double"},"key":{"type":"object","additionalProperties":{"type":["string","null"]}},"sampleExecutionIds":{"type":"array","items":{"type":"string"}},"signalRate":{"$ref":"#/components/schemas/TraceQueryResultGroupsItemsSignalRate"},"tokens":{"$ref":"#/components/schemas/TraceQueryResultGroupsItemsTokens"},"toolCalls":{"oneOf":[{"$ref":"#/components/schemas/TraceQueryResultGroupsItemsToolCalls"},{"type":"null"}]}},"required":["cost","count","durationMs","failed","failureRate","key","sampleExecutionIds","tokens","toolCalls"],"title":"TraceQueryResultGroupsItems"},"TraceQueryResultTotalsCost":{"type":"object","properties":{"p50":{"type":["number","null"],"format":"double"},"p95":{"type":["number","null"],"format":"double"},"pricedRuns":{"type":"number","format":"double"},"sum":{"type":["number","null"],"format":"double"},"unpricedRuns":{"type":"number","format":"double"}},"required":["p50","p95","pricedRuns","sum","unpricedRuns"],"title":"TraceQueryResultTotalsCost"},"TraceQueryResultTotalsDurationMs":{"type":"object","properties":{"p50":{"type":["number","null"],"format":"double"},"p95":{"type":["number","null"],"format":"double"}},"required":["p50","p95"],"title":"TraceQueryResultTotalsDurationMs"},"TraceQueryResultTotalsSignalRateFiltered":{"type":"object","properties":{"evaluated":{"type":"number","format":"double"},"fired":{"type":"number","format":"double"},"rate":{"type":["number","null"],"format":"double"}},"required":["evaluated","fired","rate"],"title":"TraceQueryResultTotalsSignalRateFiltered"},"TraceQueryResultTotalsSignalRateUniform":{"type":"object","properties":{"evaluated":{"type":"number","format":"double"},"fired":{"type":"number","format":"double"},"rate":{"type":["number","null"],"format":"double"}},"required":["evaluated","fired","rate"],"title":"TraceQueryResultTotalsSignalRateUniform"},"TraceQueryResultTotalsSignalRate":{"type":"object","properties":{"filtered":{"$ref":"#/components/schemas/TraceQueryResultTotalsSignalRateFiltered"},"uniform":{"$ref":"#/components/schemas/TraceQueryResultTotalsSignalRateUniform"}},"required":["filtered","uniform"],"title":"TraceQueryResultTotalsSignalRate"},"TraceQueryResultTotalsTokens":{"type":"object","properties":{"p50":{"type":["number","null"],"format":"double"},"p95":{"type":["number","null"],"format":"double"},"reportedRuns":{"type":"number","format":"double"},"sum":{"type":["number","null"],"format":"double"}},"required":["p50","p95","reportedRuns","sum"],"title":"TraceQueryResultTotalsTokens"},"TraceQueryResultTotalsToolCalls":{"type":"object","properties":{"p50":{"type":["number","null"],"format":"double"},"p95":{"type":["number","null"],"format":"double"}},"required":["p50","p95"],"title":"TraceQueryResultTotalsToolCalls"},"TraceQueryResultTotals":{"type":"object","properties":{"cost":{"$ref":"#/components/schemas/TraceQueryResultTotalsCost"},"count":{"type":"number","format":"double"},"durationMs":{"$ref":"#/components/schemas/TraceQueryResultTotalsDurationMs"},"failed":{"type":"number","format":"double"},"failureRate":{"type":["number","null"],"format":"double"},"signalRate":{"$ref":"#/components/schemas/TraceQueryResultTotalsSignalRate"},"tokens":{"$ref":"#/components/schemas/TraceQueryResultTotalsTokens"},"toolCalls":{"oneOf":[{"$ref":"#/components/schemas/TraceQueryResultTotalsToolCalls"},{"type":"null"}]}},"required":["cost","count","durationMs","failed","failureRate","tokens","toolCalls"],"title":"TraceQueryResultTotals"},"TraceQueryResultWarningsItems":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"],"title":"TraceQueryResultWarningsItems"},"TraceQueryResultWindow":{"type":"object","properties":{"from":{"type":"string"},"to":{"type":"string"}},"required":["from","to"],"title":"TraceQueryResultWindow"},"TraceQueryResult":{"type":"object","properties":{"groupBy":{"type":"array","items":{"$ref":"#/components/schemas/TraceQueryResultGroupByItems"}},"groups":{"type":"array","items":{"$ref":"#/components/schemas/TraceQueryResultGroupsItems"}},"nextCursor":{"type":["string","null"]},"totals":{"$ref":"#/components/schemas/TraceQueryResultTotals"},"truncated":{"type":"boolean"},"warnings":{"type":"array","items":{"$ref":"#/components/schemas/TraceQueryResultWarningsItems"}},"window":{"$ref":"#/components/schemas/TraceQueryResultWindow"}},"required":["groupBy","groups","nextCursor","totals","truncated","warnings","window"],"title":"TraceQueryResult"},"Logs_queryTraces_Response_200":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/TraceQueryResult"},"success":{"type":"boolean"}},"required":["data","success"],"title":"Logs_queryTraces_Response_200"},"V1MessagingConversationsGetResponsesContentApplicationJsonSchemaDataItems":{"type":"object","properties":{"agentMode":{"type":"string"},"createdAt":{"type":"string"},"externalParticipantId":{"type":["string","null"]},"externalThreadId":{"type":["string","null"]},"id":{"type":"string"},"lastMessageAt":{"type":["string","null"]},"messageCount":{"type":"number","format":"double"},"participantEmail":{"type":["string","null"]},"participantName":{"type":["string","null"]},"status":{"type":"string"},"subject":{"type":["string","null"]},"surfaceId":{"type":"string"},"takeoverActorId":{"type":["string","null"]},"takeoverActorType":{"type":["string","null"]},"takeoverAt":{"type":["string","null"]},"takeoverReason":{"type":["string","null"]},"timezone":{"type":["string","null"]},"updatedAt":{"type":"string"}},"required":["agentMode","createdAt","externalParticipantId","externalThreadId","id","lastMessageAt","messageCount","participantEmail","participantName","status","subject","surfaceId","takeoverActorId","takeoverActorType","takeoverAt","takeoverReason","timezone","updatedAt"],"title":"V1MessagingConversationsGetResponsesContentApplicationJsonSchemaDataItems"},"Messaging_Conversations_listConversations_Response_200":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1MessagingConversationsGetResponsesContentApplicationJsonSchemaDataItems"}},"pagination":{"$ref":"#/components/schemas/Pagination"}},"required":["data","pagination"],"title":"Messaging Conversations_listConversations_Response_200"},"V1MessagingConversationsPostRequestBodyContentApplicationJsonSchemaContext":{"type":"object","properties":{"recordId":{"type":"string"},"sessionId":{"type":"string"},"variables":{"type":"object","additionalProperties":{"description":"Any type"}}},"title":"V1MessagingConversationsPostRequestBodyContentApplicationJsonSchemaContext"},"V1MessagingConversationsPostRequestBodyContentApplicationJsonSchemaStatus":{"type":"string","enum":["open","closed","archived"],"title":"V1MessagingConversationsPostRequestBodyContentApplicationJsonSchemaStatus"},"V1MessagingConversationsPostResponsesContentApplicationJsonSchemaSurface":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":["string","null"]},"type":{"type":["string","null"]}},"required":["id","name","type"],"title":"V1MessagingConversationsPostResponsesContentApplicationJsonSchemaSurface"},"Messaging_Conversations_createConversation_Response_201":{"type":"object","properties":{"agentMode":{"type":"string"},"context":{"type":"object","additionalProperties":{"description":"Any type"}},"createdAt":{"type":"string"},"externalParticipantId":{"type":["string","null"]},"externalThreadId":{"type":["string","null"]},"id":{"type":"string"},"lastMessageAt":{"type":["string","null"]},"messageCount":{"type":"number","format":"double"},"participantEmail":{"type":["string","null"]},"participantMetadata":{"type":"object","additionalProperties":{"description":"Any type"}},"participantName":{"type":["string","null"]},"status":{"type":"string"},"subject":{"type":["string","null"]},"surface":{"$ref":"#/components/schemas/V1MessagingConversationsPostResponsesContentApplicationJsonSchemaSurface"},"surfaceId":{"type":"string"},"takeoverActorId":{"type":["string","null"]},"takeoverActorType":{"type":["string","null"]},"takeoverAt":{"type":["string","null"]},"takeoverReason":{"type":["string","null"]},"timezone":{"type":["string","null"]},"updatedAt":{"type":"string"}},"required":["agentMode","createdAt","externalParticipantId","externalThreadId","id","lastMessageAt","messageCount","participantEmail","participantName","status","subject","surfaceId","takeoverActorId","takeoverActorType","takeoverAt","takeoverReason","timezone","updatedAt"],"title":"Messaging Conversations_createConversation_Response_201"},"V1MessagingConversationsIdGetResponsesContentApplicationJsonSchemaSurface":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":["string","null"]},"type":{"type":["string","null"]}},"required":["id","name","type"],"title":"V1MessagingConversationsIdGetResponsesContentApplicationJsonSchemaSurface"},"Messaging_Conversations_getConversation_Response_200":{"type":"object","properties":{"agentMode":{"type":"string"},"context":{"type":"object","additionalProperties":{"description":"Any type"}},"createdAt":{"type":"string"},"externalParticipantId":{"type":["string","null"]},"externalThreadId":{"type":["string","null"]},"id":{"type":"string"},"lastMessageAt":{"type":["string","null"]},"messageCount":{"type":"number","format":"double"},"participantEmail":{"type":["string","null"]},"participantMetadata":{"type":"object","additionalProperties":{"description":"Any type"}},"participantName":{"type":["string","null"]},"status":{"type":"string"},"subject":{"type":["string","null"]},"surface":{"$ref":"#/components/schemas/V1MessagingConversationsIdGetResponsesContentApplicationJsonSchemaSurface"},"surfaceId":{"type":"string"},"takeoverActorId":{"type":["string","null"]},"takeoverActorType":{"type":["string","null"]},"takeoverAt":{"type":["string","null"]},"takeoverReason":{"type":["string","null"]},"timezone":{"type":["string","null"]},"updatedAt":{"type":"string"}},"required":["agentMode","createdAt","externalParticipantId","externalThreadId","id","lastMessageAt","messageCount","participantEmail","participantName","status","subject","surfaceId","takeoverActorId","takeoverActorType","takeoverAt","takeoverReason","timezone","updatedAt"],"title":"Messaging Conversations_getConversation_Response_200"},"V1MessagingConversationsIdPutRequestBodyContentApplicationJsonSchemaContext":{"type":"object","properties":{"recordId":{"type":"string"},"sessionId":{"type":"string"},"variables":{"type":"object","additionalProperties":{"description":"Any type"}}},"title":"V1MessagingConversationsIdPutRequestBodyContentApplicationJsonSchemaContext"},"V1MessagingConversationsIdPutRequestBodyContentApplicationJsonSchemaStatus":{"type":"string","enum":["open","closed","archived"],"title":"V1MessagingConversationsIdPutRequestBodyContentApplicationJsonSchemaStatus"},"V1MessagingConversationsIdPutResponsesContentApplicationJsonSchemaSurface":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":["string","null"]},"type":{"type":["string","null"]}},"required":["id","name","type"],"title":"V1MessagingConversationsIdPutResponsesContentApplicationJsonSchemaSurface"},"Messaging_Conversations_updateConversation_Response_200":{"type":"object","properties":{"agentMode":{"type":"string"},"context":{"type":"object","additionalProperties":{"description":"Any type"}},"createdAt":{"type":"string"},"externalParticipantId":{"type":["string","null"]},"externalThreadId":{"type":["string","null"]},"id":{"type":"string"},"lastMessageAt":{"type":["string","null"]},"messageCount":{"type":"number","format":"double"},"participantEmail":{"type":["string","null"]},"participantMetadata":{"type":"object","additionalProperties":{"description":"Any type"}},"participantName":{"type":["string","null"]},"status":{"type":"string"},"subject":{"type":["string","null"]},"surface":{"$ref":"#/components/schemas/V1MessagingConversationsIdPutResponsesContentApplicationJsonSchemaSurface"},"surfaceId":{"type":"string"},"takeoverActorId":{"type":["string","null"]},"takeoverActorType":{"type":["string","null"]},"takeoverAt":{"type":["string","null"]},"takeoverReason":{"type":["string","null"]},"timezone":{"type":["string","null"]},"updatedAt":{"type":"string"}},"required":["agentMode","createdAt","externalParticipantId","externalThreadId","id","lastMessageAt","messageCount","participantEmail","participantName","status","subject","surfaceId","takeoverActorId","takeoverActorType","takeoverAt","takeoverReason","timezone","updatedAt"],"title":"Messaging Conversations_updateConversation_Response_200"},"Messaging_Conversations_deleteConversation_Response_200":{"type":"object","properties":{"success":{"type":"boolean"}},"required":["success"],"title":"Messaging Conversations_deleteConversation_Response_200"},"V1MessagingConversationsIdMessagesGetResponsesContentApplicationJsonSchemaDataItems":{"type":"object","properties":{"content":{"type":"string"},"conversationId":{"type":"string"},"createdAt":{"type":"string"},"direction":{"type":["string","null"]},"externalMessageId":{"type":["string","null"]},"flowStepResultId":{"type":["string","null"]},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{"description":"Any type"}},"role":{"type":"string"}},"required":["content","conversationId","createdAt","direction","externalMessageId","flowStepResultId","id","metadata","role"],"title":"V1MessagingConversationsIdMessagesGetResponsesContentApplicationJsonSchemaDataItems"},"Messaging_Conversations_listMessages_Response_200":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1MessagingConversationsIdMessagesGetResponsesContentApplicationJsonSchemaDataItems"}},"totalCount":{"type":"number","format":"double","description":"Messages in the conversation, not in this page"}},"required":["data","totalCount"],"title":"Messaging Conversations_listMessages_Response_200"},"V1MessagingConversationsIdMessagesPostRequestBodyContentApplicationJsonSchemaDirection":{"type":"string","enum":["inbound","outbound"],"title":"V1MessagingConversationsIdMessagesPostRequestBodyContentApplicationJsonSchemaDirection"},"V1MessagingConversationsIdMessagesPostRequestBodyContentApplicationJsonSchemaMetadataAttachmentsItems":{"type":"object","properties":{"contentType":{"type":"string"},"name":{"type":"string"},"size":{"type":"number","format":"double"},"url":{"type":"string"}},"required":["contentType","name","size"],"title":"V1MessagingConversationsIdMessagesPostRequestBodyContentApplicationJsonSchemaMetadataAttachmentsItems"},"V1MessagingConversationsIdMessagesPostRequestBodyContentApplicationJsonSchemaMetadataDeliveryStatus":{"type":"string","enum":["pending","sent","delivered","failed","bounced"],"title":"V1MessagingConversationsIdMessagesPostRequestBodyContentApplicationJsonSchemaMetadataDeliveryStatus"},"V1MessagingConversationsIdMessagesPostRequestBodyContentApplicationJsonSchemaMetadata":{"type":"object","properties":{"attachments":{"type":"array","items":{"$ref":"#/components/schemas/V1MessagingConversationsIdMessagesPostRequestBodyContentApplicationJsonSchemaMetadataAttachmentsItems"}},"deliveryError":{"type":"string"},"deliveryStatus":{"$ref":"#/components/schemas/V1MessagingConversationsIdMessagesPostRequestBodyContentApplicationJsonSchemaMetadataDeliveryStatus"},"externalTimestamp":{"type":"string"},"headers":{"type":"object","additionalProperties":{"type":"string"}}},"title":"V1MessagingConversationsIdMessagesPostRequestBodyContentApplicationJsonSchemaMetadata"},"V1MessagingConversationsIdMessagesPostRequestBodyContentApplicationJsonSchemaRole":{"type":"string","enum":["user","assistant","system"],"title":"V1MessagingConversationsIdMessagesPostRequestBodyContentApplicationJsonSchemaRole"},"Messaging_Conversations_createMessage_Response_201":{"type":"object","properties":{"content":{"type":"string"},"conversationId":{"type":"string"},"createdAt":{"type":"string"},"direction":{"type":["string","null"]},"externalMessageId":{"type":["string","null"]},"flowStepResultId":{"type":["string","null"]},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{"description":"Any type"}},"role":{"type":"string"}},"required":["content","conversationId","createdAt","direction","externalMessageId","flowStepResultId","id","metadata","role"],"title":"Messaging Conversations_createMessage_Response_201"},"Messaging_Conversations_resumeAgentHandling_Response_200":{"type":"object","properties":{"agentMode":{"type":"string"},"id":{"type":"string"},"takeoverActorId":{"type":["string","null"]},"takeoverActorType":{"type":["string","null"]},"takeoverAt":{"type":["string","null"]},"takeoverReason":{"type":["string","null"]},"updatedAt":{"type":"string"}},"required":["agentMode","id","takeoverActorId","takeoverActorType","takeoverAt","takeoverReason","updatedAt"],"title":"Messaging Conversations_resumeAgentHandling_Response_200"},"MessagingConversationConflictErrorCode":{"type":"string","enum":["ALREADY_HUMAN_MODE","ALREADY_AUTO_MODE","STATE_CHANGED"],"description":"Machine-readable conflict reason. STATE_CHANGED is retryable.","title":"MessagingConversationConflictErrorCode"},"MessagingConversationConflictErrorDetailsItems":{"type":"object","properties":{"code":{"type":"string","description":"Stable Runtype validation code (e.g. MISSING_REQUIRED_FIELD, INVALID_ENUM)."},"message":{"type":"string"},"path":{"type":"string","description":"Dotted JSON path to the offending field."},"suggestion":{"type":"string","description":"Actionable hint (allowed values, accepted range, …)."}},"required":["message"],"title":"MessagingConversationConflictErrorDetailsItems"},"MessagingConversationConflictError":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/MessagingConversationConflictErrorCode","description":"Machine-readable conflict reason. STATE_CHANGED is retryable."},"details":{"type":"array","items":{"$ref":"#/components/schemas/MessagingConversationConflictErrorDetailsItems"}},"error":{"type":"string"},"requiredScopes":{"type":"array","items":{"type":"string"},"description":"On `insufficient_scope`: every API key scope this request needs."},"takeoverActorId":{"type":["string","null"],"description":"Actor holding the conversation, when one does."},"takeoverAt":{"type":["string","null"]}},"required":["code","error"],"title":"MessagingConversationConflictError"},"V1MessagingConversationsIdSendPostRequestBodyContentApplicationJsonSchemaMetadataAttachmentsItems":{"type":"object","properties":{"contentType":{"type":"string"},"name":{"type":"string"},"size":{"type":"number","format":"double"},"url":{"type":"string"}},"required":["contentType","name","size"],"title":"V1MessagingConversationsIdSendPostRequestBodyContentApplicationJsonSchemaMetadataAttachmentsItems"},"V1MessagingConversationsIdSendPostRequestBodyContentApplicationJsonSchemaMetadata":{"type":"object","properties":{"attachments":{"type":"array","items":{"$ref":"#/components/schemas/V1MessagingConversationsIdSendPostRequestBodyContentApplicationJsonSchemaMetadataAttachmentsItems"}},"externalTimestamp":{"type":"string"},"headers":{"type":"object","additionalProperties":{"type":"string"}}},"title":"V1MessagingConversationsIdSendPostRequestBodyContentApplicationJsonSchemaMetadata"},"V1MessagingConversationsIdSendPostResponsesContentApplicationJsonSchemaDeliveryResult":{"type":"object","properties":{"deliveryStatus":{"type":"string"},"externalMessageId":{"type":["string","null"]}},"required":["deliveryStatus","externalMessageId"],"title":"V1MessagingConversationsIdSendPostResponsesContentApplicationJsonSchemaDeliveryResult"},"V1MessagingConversationsIdSendPostResponsesContentApplicationJsonSchemaMessage":{"type":"object","properties":{"content":{"type":"string"},"conversationId":{"type":"string"},"createdAt":{"type":"string"},"direction":{"type":["string","null"]},"externalMessageId":{"type":["string","null"]},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{"description":"Any type"}},"role":{"type":"string"}},"required":["content","conversationId","createdAt","direction","externalMessageId","metadata","role"],"title":"V1MessagingConversationsIdSendPostResponsesContentApplicationJsonSchemaMessage"},"Messaging_Conversations_sendHumanAuthoredMessage_Response_201":{"type":"object","properties":{"deliveryResult":{"$ref":"#/components/schemas/V1MessagingConversationsIdSendPostResponsesContentApplicationJsonSchemaDeliveryResult"},"message":{"$ref":"#/components/schemas/V1MessagingConversationsIdSendPostResponsesContentApplicationJsonSchemaMessage"}},"required":["deliveryResult","message"],"title":"Messaging Conversations_sendHumanAuthoredMessage_Response_201"},"MessagingSendUndeliverableErrorDetailsItems":{"type":"object","properties":{"code":{"type":"string","description":"Stable Runtype validation code (e.g. MISSING_REQUIRED_FIELD, INVALID_ENUM)."},"message":{"type":"string"},"path":{"type":"string","description":"Dotted JSON path to the offending field."},"suggestion":{"type":"string","description":"Actionable hint (allowed values, accepted range, …)."}},"required":["message"],"title":"MessagingSendUndeliverableErrorDetailsItems"},"MessagingSendUndeliverableError":{"type":"object","properties":{"code":{"type":"string","description":"Stable error code, when applicable (e.g. UNSUPPORTED_SURFACE_TYPE)."},"details":{"type":"array","items":{"$ref":"#/components/schemas/MessagingSendUndeliverableErrorDetailsItems"}},"error":{"type":"string"},"requiredScopes":{"type":"array","items":{"type":"string"},"description":"On `insufficient_scope`: every API key scope this request needs."}},"required":["error"],"title":"MessagingSendUndeliverableError"},"Messaging_Conversations_takeOverConversation_Response_200":{"type":"object","properties":{"agentMode":{"type":"string"},"id":{"type":"string"},"takeoverActorId":{"type":["string","null"]},"takeoverActorType":{"type":["string","null"]},"takeoverAt":{"type":["string","null"]},"takeoverReason":{"type":["string","null"]},"updatedAt":{"type":"string"}},"required":["agentMode","id","takeoverActorId","takeoverActorType","takeoverAt","takeoverReason","updatedAt"],"title":"Messaging Conversations_takeOverConversation_Response_200"},"Email___IMAP_triggerAnImmediateImapPoll_Response_200":{"type":"object","properties":{"success":{"type":"boolean"}},"required":["success"],"title":"Email / IMAP_triggerAnImmediateImapPoll_Response_200"},"V1MessagingImapSurfaceIdPollNowPostResponsesContentApplicationJsonSchemaError":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"],"title":"V1MessagingImapSurfaceIdPollNowPostResponsesContentApplicationJsonSchemaError"},"TriggerAnImmediateImapPollRequestForbiddenError":{"type":"object","properties":{"error":{"$ref":"#/components/schemas/V1MessagingImapSurfaceIdPollNowPostResponsesContentApplicationJsonSchemaError"}},"required":["error"],"title":"TriggerAnImmediateImapPollRequestForbiddenError"},"Email___IMAP_startImapPolling_Response_200":{"type":"object","properties":{"success":{"type":"boolean"}},"required":["success"],"title":"Email / IMAP_startImapPolling_Response_200"},"V1MessagingImapSurfaceIdStartPostResponsesContentApplicationJsonSchemaError":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"],"title":"V1MessagingImapSurfaceIdStartPostResponsesContentApplicationJsonSchemaError"},"StartImapPollingRequestForbiddenError":{"type":"object","properties":{"error":{"$ref":"#/components/schemas/V1MessagingImapSurfaceIdStartPostResponsesContentApplicationJsonSchemaError"}},"required":["error"],"title":"StartImapPollingRequestForbiddenError"},"V1MessagingImapSurfaceIdStatusGetResponsesContentApplicationJsonSchemaConfig":{"type":"object","properties":{"host":{"description":"Any type"},"mailbox":{"description":"Any type"},"pollIntervalMinutes":{"description":"Any type"},"pollingEnabled":{"description":"Any type"},"port":{"description":"Any type"},"provider":{"description":"Any type"},"secure":{"description":"Any type"},"username":{"description":"Any type"}},"title":"V1MessagingImapSurfaceIdStatusGetResponsesContentApplicationJsonSchemaConfig"},"V1MessagingImapSurfaceIdStatusGetResponsesContentApplicationJsonSchemaPollStatus":{"type":"string","enum":["idle","active","paused","error","polling"],"title":"V1MessagingImapSurfaceIdStatusGetResponsesContentApplicationJsonSchemaPollStatus"},"Email___IMAP_getImapPollingStatus_Response_200":{"type":"object","properties":{"active":{"type":"boolean"},"config":{"$ref":"#/components/schemas/V1MessagingImapSurfaceIdStatusGetResponsesContentApplicationJsonSchemaConfig"},"consecutiveErrors":{"type":"integer"},"lastError":{"type":["string","null"]},"lastPollAt":{"type":["string","null"]},"lastUid":{"type":"integer"},"mailbox":{"type":"string"},"messagesProcessed":{"type":"integer"},"nextPollAt":{"type":["string","null"]},"pollIntervalMinutes":{"type":"integer"},"pollStatus":{"$ref":"#/components/schemas/V1MessagingImapSurfaceIdStatusGetResponsesContentApplicationJsonSchemaPollStatus"}},"required":["active","config","consecutiveErrors","lastError","lastPollAt","lastUid","mailbox","messagesProcessed","nextPollAt","pollIntervalMinutes","pollStatus"],"title":"Email / IMAP_getImapPollingStatus_Response_200"},"V1MessagingImapSurfaceIdStatusGetResponsesContentApplicationJsonSchemaError":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"],"title":"V1MessagingImapSurfaceIdStatusGetResponsesContentApplicationJsonSchemaError"},"GetImapPollingStatusRequestForbiddenError":{"type":"object","properties":{"error":{"$ref":"#/components/schemas/V1MessagingImapSurfaceIdStatusGetResponsesContentApplicationJsonSchemaError"}},"required":["error"],"title":"GetImapPollingStatusRequestForbiddenError"},"Email___IMAP_stopImapPolling_Response_200":{"type":"object","properties":{"success":{"type":"boolean"}},"required":["success"],"title":"Email / IMAP_stopImapPolling_Response_200"},"V1MessagingImapSurfaceIdStopPostResponsesContentApplicationJsonSchemaError":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"],"title":"V1MessagingImapSurfaceIdStopPostResponsesContentApplicationJsonSchemaError"},"StopImapPollingRequestForbiddenError":{"type":"object","properties":{"error":{"$ref":"#/components/schemas/V1MessagingImapSurfaceIdStopPostResponsesContentApplicationJsonSchemaError"}},"required":["error"],"title":"StopImapPollingRequestForbiddenError"},"Email___IMAP_sendATestEmailViaSmtp_Response_200":{"type":"object","properties":{"messageId":{"type":"string"},"success":{"type":"boolean"}},"required":["success"],"title":"Email / IMAP_sendATestEmailViaSmtp_Response_200"},"V1MessagingImapSurfaceIdTestSendPostResponsesContentApplicationJsonSchemaError":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"],"title":"V1MessagingImapSurfaceIdTestSendPostResponsesContentApplicationJsonSchemaError"},"SendATestEmailViaSmtpRequestForbiddenError":{"type":"object","properties":{"error":{"$ref":"#/components/schemas/V1MessagingImapSurfaceIdTestSendPostResponsesContentApplicationJsonSchemaError"}},"required":["error"],"title":"SendATestEmailViaSmtpRequestForbiddenError"},"SendATestEmailViaSmtpRequestInternalServerError0":{"type":"object","properties":{"error":{"type":"string","description":"The SMTP rejection, e.g. an authentication or relay refusal."},"success":{"type":"boolean"}},"required":["error","success"],"title":"SendATestEmailViaSmtpRequestInternalServerError0"},"SendATestEmailViaSmtpRequestInternalServerError":{"oneOf":[{"$ref":"#/components/schemas/SendATestEmailViaSmtpRequestInternalServerError0"},{"$ref":"#/components/schemas/InternalError"}],"title":"SendATestEmailViaSmtpRequestInternalServerError"},"V1MessagingImapSurfaceIdVerifyPostResponsesContentApplicationJsonSchemaImap":{"type":"object","properties":{"error":{"type":"string"},"success":{"type":"boolean"}},"required":["success"],"title":"V1MessagingImapSurfaceIdVerifyPostResponsesContentApplicationJsonSchemaImap"},"V1MessagingImapSurfaceIdVerifyPostResponsesContentApplicationJsonSchemaSmtp":{"type":"object","properties":{"error":{"type":"string"},"success":{"type":"boolean"}},"required":["success"],"title":"V1MessagingImapSurfaceIdVerifyPostResponsesContentApplicationJsonSchemaSmtp"},"Email___IMAP_verifyImapSmtpConnection_Response_200":{"type":"object","properties":{"imap":{"$ref":"#/components/schemas/V1MessagingImapSurfaceIdVerifyPostResponsesContentApplicationJsonSchemaImap"},"smtp":{"$ref":"#/components/schemas/V1MessagingImapSurfaceIdVerifyPostResponsesContentApplicationJsonSchemaSmtp"}},"required":["imap","smtp"],"title":"Email / IMAP_verifyImapSmtpConnection_Response_200"},"V1MessagingImapSurfaceIdVerifyPostResponsesContentApplicationJsonSchemaError":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"],"title":"V1MessagingImapSurfaceIdVerifyPostResponsesContentApplicationJsonSchemaError"},"VerifyImapSmtpConnectionRequestForbiddenError":{"type":"object","properties":{"error":{"$ref":"#/components/schemas/V1MessagingImapSurfaceIdVerifyPostResponsesContentApplicationJsonSchemaError"}},"required":["error"],"title":"VerifyImapSmtpConnectionRequestForbiddenError"},"Messaging_Validations_validateSlackBotTokenDeprecated_Response_200":{"type":"object","properties":{"valid":{"type":"boolean"}},"required":["valid"],"title":"Messaging Validations_validateSlackBotTokenDeprecated_Response_200"},"Messaging_Validations_validateTelegramBotTokenDeprecated_Response_200":{"type":"object","properties":{"valid":{"type":"boolean"}},"required":["valid"],"title":"Messaging Validations_validateTelegramBotTokenDeprecated_Response_200"},"Messaging_Validations_validateChannelCredentials_Response_200":{"type":"object","properties":{"error":{"type":"string"},"metadata":{"type":"object","additionalProperties":{"description":"Any type"}},"valid":{"type":"boolean"}},"required":["valid"],"title":"Messaging Validations_validateChannelCredentials_Response_200"},"ValidateChannelCredentialsRequestBadRequestError":{"type":"object","properties":{"error":{"type":"string"},"metadata":{"type":"object","additionalProperties":{"description":"Any type"}},"valid":{"type":"boolean"}},"required":["valid"],"title":"ValidateChannelCredentialsRequestBadRequestError"},"ValidateChannelCredentialsRequestNotFoundError":{"type":"object","properties":{"error":{"type":"string"},"metadata":{"type":"object","additionalProperties":{"description":"Any type"}},"valid":{"type":"boolean"}},"required":["valid"],"title":"ValidateChannelCredentialsRequestNotFoundError"},"Messaging_Validations_sendEchoMessage_Response_200":{"type":"object","properties":{"error":{"type":"string"},"metadata":{"type":"object","additionalProperties":{"description":"Any type"}},"valid":{"type":"boolean"}},"required":["valid"],"title":"Messaging Validations_sendEchoMessage_Response_200"},"SendEchoMessageRequestNotImplementedError":{"type":"object","properties":{"error":{"type":"string"},"metadata":{"type":"object","additionalProperties":{"description":"Any type"}},"valid":{"type":"boolean"}},"required":["valid"],"title":"SendEchoMessageRequestNotImplementedError"},"V1ModelConfigsGetResponsesContentApplicationJsonSchemaCredentialPolicyMode":{"type":"string","enum":["byok_only","mixed","platform"],"description":"`byok_only`: the organization requires its own model keys; only `byokProviders` serve calls and Runtype platform keys are never used. `mixed`: some providers run on the account credentials and others on platform keys. `platform`: the account has connected no provider credentials.","title":"V1ModelConfigsGetResponsesContentApplicationJsonSchemaCredentialPolicyMode"},"V1ModelConfigsGetResponsesContentApplicationJsonSchemaCredentialPolicy":{"type":"object","properties":{"blockedProviders":{"type":"array","items":{"type":"string"},"description":"Providers organization policy refuses until a credential is connected."},"byokProviders":{"type":"array","items":{"type":"string"},"description":"Providers served by the account own credentials. `generic-openai` is its custom inference endpoint."},"mode":{"$ref":"#/components/schemas/V1ModelConfigsGetResponsesContentApplicationJsonSchemaCredentialPolicyMode","description":"`byok_only`: the organization requires its own model keys; only `byokProviders` serve calls and Runtype platform keys are never used. `mixed`: some providers run on the account credentials and others on platform keys. `platform`: the account has connected no provider credentials."},"platformProviders":{"type":"array","items":{"type":"string"},"description":"Providers served by Runtype platform keys."},"summary":{"type":"string","description":"Plain-language statement of the same facts."}},"required":["blockedProviders","byokProviders","mode","platformProviders","summary"],"description":"Which providers may serve a model call for this account. A model whose `keyStatus` is `needs_setup` is refused at execution.","title":"V1ModelConfigsGetResponsesContentApplicationJsonSchemaCredentialPolicy"},"V1ModelConfigsGetResponsesContentApplicationJsonSchemaDataItemsConfigurationStatus":{"type":"string","enum":["ready","needs_configuration"],"description":"Organization configuration readiness. `needs_configuration` means conflicting legacy teammate settings were preserved and execution fails closed until an authorized actor deliberately updates the canonical row.","title":"V1ModelConfigsGetResponsesContentApplicationJsonSchemaDataItemsConfigurationStatus"},"V1ModelConfigsGetResponsesContentApplicationJsonSchemaDataItemsKeyStatus":{"type":"string","enum":["platform","custom","needs_setup"],"title":"V1ModelConfigsGetResponsesContentApplicationJsonSchemaDataItemsKeyStatus"},"V1ModelConfigsGetResponsesContentApplicationJsonSchemaDataItemsReasoningCapabilityAnthropicThinkingMode":{"type":"string","enum":["adaptive","enabled"],"description":"Anthropic only: the thinking request shape sent. adaptive (Claude 4.6 and later, including the Claude 5 family) accepts effort and rejects budgetTokens; enabled is the legacy budgetTokens form.","title":"V1ModelConfigsGetResponsesContentApplicationJsonSchemaDataItemsReasoningCapabilityAnthropicThinkingMode"},"V1ModelConfigsGetResponsesContentApplicationJsonSchemaDataItemsReasoningCapabilityGoogleThinkingMode":{"type":"string","enum":["budget","level"],"title":"V1ModelConfigsGetResponsesContentApplicationJsonSchemaDataItemsReasoningCapabilityGoogleThinkingMode"},"V1ModelConfigsGetResponsesContentApplicationJsonSchemaDataItemsReasoningCapabilityOptionsBudgetTokens":{"type":"object","properties":{"max":{"type":"number","format":"double"},"min":{"type":"number","format":"double"}},"title":"V1ModelConfigsGetResponsesContentApplicationJsonSchemaDataItemsReasoningCapabilityOptionsBudgetTokens"},"V1ModelConfigsGetResponsesContentApplicationJsonSchemaDataItemsReasoningCapabilityOptions":{"type":"object","properties":{"budgetTokens":{"$ref":"#/components/schemas/V1ModelConfigsGetResponsesContentApplicationJsonSchemaDataItemsReasoningCapabilityOptionsBudgetTokens"},"effort":{"type":"array","items":{"type":"string"}},"toggle":{"type":"boolean"}},"description":"Which reasoning knobs this model's API accepts (catalog-sourced from models.dev reasoning_options). Absent when the catalog has no claim for the model.","title":"V1ModelConfigsGetResponsesContentApplicationJsonSchemaDataItemsReasoningCapabilityOptions"},"V1ModelConfigsGetResponsesContentApplicationJsonSchemaDataItemsReasoningCapability":{"type":"object","properties":{"anthropicThinkingMode":{"$ref":"#/components/schemas/V1ModelConfigsGetResponsesContentApplicationJsonSchemaDataItemsReasoningCapabilityAnthropicThinkingMode","description":"Anthropic only: the thinking request shape sent. adaptive (Claude 4.6 and later, including the Claude 5 family) accepts effort and rejects budgetTokens; enabled is the legacy budgetTokens form."},"builtInReasoning":{"type":"boolean","description":"The model always reasons (GPT-5 / o-series); disabling is an effort floor, not off."},"googleThinkingMode":{"$ref":"#/components/schemas/V1ModelConfigsGetResponsesContentApplicationJsonSchemaDataItemsReasoningCapabilityGoogleThinkingMode"},"options":{"$ref":"#/components/schemas/V1ModelConfigsGetResponsesContentApplicationJsonSchemaDataItemsReasoningCapabilityOptions","description":"Which reasoning knobs this model's API accepts (catalog-sourced from models.dev reasoning_options). Absent when the catalog has no claim for the model."},"provider":{"type":"string"},"supported":{"type":"boolean"},"supportsReasoningSummary":{"type":"boolean"}},"required":["supported"],"title":"V1ModelConfigsGetResponsesContentApplicationJsonSchemaDataItemsReasoningCapability"},"V1ModelConfigsGetResponsesContentApplicationJsonSchemaDataItems":{"type":"object","properties":{"configScope":{"type":"string","description":"`personal` or `organization` for a stored configuration. `organization_connection` marks a model an organization custom inference endpoint declares that the caller has no stored configuration for: it is runnable, and its `id` cannot be updated, toggled, or deleted (change the connection model list instead)."},"configurationStatus":{"$ref":"#/components/schemas/V1ModelConfigsGetResponsesContentApplicationJsonSchemaDataItemsConfigurationStatus","description":"Organization configuration readiness. `needs_configuration` means conflicting legacy teammate settings were preserved and execution fails closed until an authorized actor deliberately updates the canonical row."},"costPer1kTokens":{"type":"number","format":"double"},"createdAt":{"type":"string"},"createdByUserId":{"type":["string","null"],"description":"Nullable creation provenance for organization-owned model configurations; never authorization or execution authority."},"creator":{"type":"string"},"creatorDisplayName":{"type":["string","null"]},"creditPromoLabel":{"type":["string","null"],"description":"Plain-language discount callout for this model, e.g. \"90% off\". null when undiscounted."},"creditPromoMultiplier":{"type":"number","format":"double","description":"Factor platform-key spend on this model is billed at while a credit promo is active (0.1 = 90% off). 1 when no discount applies."},"displayName":{"type":"string"},"id":{"type":"string"},"inputCostPer1kTokens":{"type":"number","format":"double"},"isAvailable":{"type":"boolean","description":"Read-only inference availability under workspace policy; does not change persisted isEnabled."},"isDefault":{"type":"boolean"},"isEnabled":{"type":"boolean"},"keyStatus":{"$ref":"#/components/schemas/V1ModelConfigsGetResponsesContentApplicationJsonSchemaDataItemsKeyStatus"},"maxOutputTokens":{"type":"number","format":"double"},"migrationCandidateCount":{"type":"integer","minimum":0,"description":"Number of preserved legacy candidates considered during organization migration. Candidate settings remain internal."},"modelId":{"type":"string"},"organizationConnectionId":{"type":["string","null"],"description":"Normalized organization-owned connection reference. Null for platform selection, personal credentials, and providers that have not migrated."},"organizationId":{"type":["string","null"]},"outputCostPer1kTokens":{"type":"number","format":"double"},"provider":{"type":"string"},"providerKeyId":{"type":["string","null"],"description":"Previous-Worker-compatible provider-key alias. Updated organization clients should use organizationConnectionId; platform selection is null."},"reasoningCapability":{"$ref":"#/components/schemas/V1ModelConfigsGetResponsesContentApplicationJsonSchemaDataItemsReasoningCapability"},"settings":{"type":"object","additionalProperties":{"description":"Any type"}},"supportedResponseFormats":{"type":"array","items":{"type":"string"}},"supportsCustomKey":{"type":"boolean"},"supportsSearch":{"type":"boolean"},"supportsStreaming":{"type":"boolean"},"supportsToolUse":{"type":"boolean","description":"True when the model catalog lists the model as supporting tool calls; absent otherwise."},"updatedAt":{"type":"string"},"userId":{"type":["string","null"],"description":"Legacy actor owner for personal/compatibility rows. Null for organization-owned model configurations."}},"required":["createdAt","id","isDefault","isEnabled","modelId","organizationId","provider","providerKeyId","settings","updatedAt","userId"],"title":"V1ModelConfigsGetResponsesContentApplicationJsonSchemaDataItems"},"Model_Configs_listModelConfigurations_Response_200":{"type":"object","properties":{"credentialPolicy":{"$ref":"#/components/schemas/V1ModelConfigsGetResponsesContentApplicationJsonSchemaCredentialPolicy","description":"Which providers may serve a model call for this account. A model whose `keyStatus` is `needs_setup` is refused at execution."},"data":{"type":"array","items":{"$ref":"#/components/schemas/V1ModelConfigsGetResponsesContentApplicationJsonSchemaDataItems"}},"total":{"type":"integer"}},"required":["data","total"],"title":"Model Configs_listModelConfigurations_Response_200"},"V1ModelConfigsPostRequestBodyContentApplicationJsonSchemaProvider":{"type":"string","enum":["model","runtype","mock","modelsocket","mixlayer","openai","anthropic","google","xai","vertex","vertex-anthropic","bedrock","tinfoil","vercel","generic-openai"],"title":"V1ModelConfigsPostRequestBodyContentApplicationJsonSchemaProvider"},"V1ModelConfigsPostRequestBodyContentApplicationJsonSchemaSettingsCustomModelExecutorConfig":{"type":"object","properties":{"baseURL":{"type":"string","format":"uri"},"modelMapping":{"type":"string"}},"title":"V1ModelConfigsPostRequestBodyContentApplicationJsonSchemaSettingsCustomModelExecutorConfig"},"V1ModelConfigsPostRequestBodyContentApplicationJsonSchemaSettingsCustomModelExecutorProvider":{"type":"string","enum":["openai","anthropic","google","xai","vertex","vertex-anthropic","bedrock","tinfoil","vercel","generic-openai"],"title":"V1ModelConfigsPostRequestBodyContentApplicationJsonSchemaSettingsCustomModelExecutorProvider"},"V1ModelConfigsPostRequestBodyContentApplicationJsonSchemaSettingsCustomModelMidConversationSystemMessages":{"type":"string","enum":["preserve","hoist"],"description":"Where a system message that follows a conversation turn lands on this endpoint. Omitted keeps it at its position (Mistral- and Gemma-family ids fold it into the leading prompt); \"hoist\" folds it for any endpoint whose chat template rejects a non-leading system role.","title":"V1ModelConfigsPostRequestBodyContentApplicationJsonSchemaSettingsCustomModelMidConversationSystemMessages"},"V1ModelConfigsPostRequestBodyContentApplicationJsonSchemaSettingsCustomModelReasoning":{"type":"object","properties":{"defaultEffort":{"type":"string","minLength":1,"maxLength":32},"supported":{"type":"boolean"}},"required":["supported"],"title":"V1ModelConfigsPostRequestBodyContentApplicationJsonSchemaSettingsCustomModelReasoning"},"V1ModelConfigsPostRequestBodyContentApplicationJsonSchemaSettingsCustomModel":{"type":"object","properties":{"displayName":{"type":"string","minLength":1},"executorConfig":{"$ref":"#/components/schemas/V1ModelConfigsPostRequestBodyContentApplicationJsonSchemaSettingsCustomModelExecutorConfig"},"executorProvider":{"$ref":"#/components/schemas/V1ModelConfigsPostRequestBodyContentApplicationJsonSchemaSettingsCustomModelExecutorProvider"},"inputCostPer1kTokens":{"type":"number","format":"double","minimum":0},"maxOutputTokens":{"type":"integer","exclusiveMinimum":0,"default":32768},"midConversationSystemMessages":{"$ref":"#/components/schemas/V1ModelConfigsPostRequestBodyContentApplicationJsonSchemaSettingsCustomModelMidConversationSystemMessages","description":"Where a system message that follows a conversation turn lands on this endpoint. Omitted keeps it at its position (Mistral- and Gemma-family ids fold it into the leading prompt); \"hoist\" folds it for any endpoint whose chat template rejects a non-leading system role."},"outputCostPer1kTokens":{"type":"number","format":"double","minimum":0},"reasoning":{"$ref":"#/components/schemas/V1ModelConfigsPostRequestBodyContentApplicationJsonSchemaSettingsCustomModelReasoning"},"supportedResponseFormats":{"type":"array","items":{"type":"string"},"default":["text","JSON"]},"supportsStreaming":{"type":"boolean","default":true}},"required":["displayName","inputCostPer1kTokens","outputCostPer1kTokens"],"title":"V1ModelConfigsPostRequestBodyContentApplicationJsonSchemaSettingsCustomModel"},"V1ModelConfigsPostRequestBodyContentApplicationJsonSchemaSettings":{"type":"object","properties":{"customModel":{"$ref":"#/components/schemas/V1ModelConfigsPostRequestBodyContentApplicationJsonSchemaSettingsCustomModel"},"maxTokens":{"type":"integer","exclusiveMinimum":0},"temperature":{"type":"number","format":"double","minimum":0,"maximum":2}},"title":"V1ModelConfigsPostRequestBodyContentApplicationJsonSchemaSettings"},"V1ModelConfigsPostResponsesContentApplicationJsonSchemaConfigurationStatus":{"type":"string","enum":["ready","needs_configuration"],"description":"Organization configuration readiness. `needs_configuration` means conflicting legacy teammate settings were preserved and execution fails closed until an authorized actor deliberately updates the canonical row.","title":"V1ModelConfigsPostResponsesContentApplicationJsonSchemaConfigurationStatus"},"V1ModelConfigsPostResponsesContentApplicationJsonSchemaKeyStatus":{"type":"string","enum":["platform","custom","needs_setup"],"title":"V1ModelConfigsPostResponsesContentApplicationJsonSchemaKeyStatus"},"V1ModelConfigsPostResponsesContentApplicationJsonSchemaReasoningCapabilityAnthropicThinkingMode":{"type":"string","enum":["adaptive","enabled"],"description":"Anthropic only: the thinking request shape sent. adaptive (Claude 4.6 and later, including the Claude 5 family) accepts effort and rejects budgetTokens; enabled is the legacy budgetTokens form.","title":"V1ModelConfigsPostResponsesContentApplicationJsonSchemaReasoningCapabilityAnthropicThinkingMode"},"V1ModelConfigsPostResponsesContentApplicationJsonSchemaReasoningCapabilityGoogleThinkingMode":{"type":"string","enum":["budget","level"],"title":"V1ModelConfigsPostResponsesContentApplicationJsonSchemaReasoningCapabilityGoogleThinkingMode"},"V1ModelConfigsPostResponsesContentApplicationJsonSchemaReasoningCapabilityOptionsBudgetTokens":{"type":"object","properties":{"max":{"type":"number","format":"double"},"min":{"type":"number","format":"double"}},"title":"V1ModelConfigsPostResponsesContentApplicationJsonSchemaReasoningCapabilityOptionsBudgetTokens"},"V1ModelConfigsPostResponsesContentApplicationJsonSchemaReasoningCapabilityOptions":{"type":"object","properties":{"budgetTokens":{"$ref":"#/components/schemas/V1ModelConfigsPostResponsesContentApplicationJsonSchemaReasoningCapabilityOptionsBudgetTokens"},"effort":{"type":"array","items":{"type":"string"}},"toggle":{"type":"boolean"}},"description":"Which reasoning knobs this model's API accepts (catalog-sourced from models.dev reasoning_options). Absent when the catalog has no claim for the model.","title":"V1ModelConfigsPostResponsesContentApplicationJsonSchemaReasoningCapabilityOptions"},"V1ModelConfigsPostResponsesContentApplicationJsonSchemaReasoningCapability":{"type":"object","properties":{"anthropicThinkingMode":{"$ref":"#/components/schemas/V1ModelConfigsPostResponsesContentApplicationJsonSchemaReasoningCapabilityAnthropicThinkingMode","description":"Anthropic only: the thinking request shape sent. adaptive (Claude 4.6 and later, including the Claude 5 family) accepts effort and rejects budgetTokens; enabled is the legacy budgetTokens form."},"builtInReasoning":{"type":"boolean","description":"The model always reasons (GPT-5 / o-series); disabling is an effort floor, not off."},"googleThinkingMode":{"$ref":"#/components/schemas/V1ModelConfigsPostResponsesContentApplicationJsonSchemaReasoningCapabilityGoogleThinkingMode"},"options":{"$ref":"#/components/schemas/V1ModelConfigsPostResponsesContentApplicationJsonSchemaReasoningCapabilityOptions","description":"Which reasoning knobs this model's API accepts (catalog-sourced from models.dev reasoning_options). Absent when the catalog has no claim for the model."},"provider":{"type":"string"},"supported":{"type":"boolean"},"supportsReasoningSummary":{"type":"boolean"}},"required":["supported"],"title":"V1ModelConfigsPostResponsesContentApplicationJsonSchemaReasoningCapability"},"Model_Configs_createModelConfiguration_Response_201":{"type":"object","properties":{"configScope":{"type":"string","description":"`personal` or `organization` for a stored configuration. `organization_connection` marks a model an organization custom inference endpoint declares that the caller has no stored configuration for: it is runnable, and its `id` cannot be updated, toggled, or deleted (change the connection model list instead)."},"configurationStatus":{"$ref":"#/components/schemas/V1ModelConfigsPostResponsesContentApplicationJsonSchemaConfigurationStatus","description":"Organization configuration readiness. `needs_configuration` means conflicting legacy teammate settings were preserved and execution fails closed until an authorized actor deliberately updates the canonical row."},"costPer1kTokens":{"type":"number","format":"double"},"createdAt":{"type":"string"},"createdByUserId":{"type":["string","null"],"description":"Nullable creation provenance for organization-owned model configurations; never authorization or execution authority."},"creator":{"type":"string"},"creatorDisplayName":{"type":["string","null"]},"creditPromoLabel":{"type":["string","null"],"description":"Plain-language discount callout for this model, e.g. \"90% off\". null when undiscounted."},"creditPromoMultiplier":{"type":"number","format":"double","description":"Factor platform-key spend on this model is billed at while a credit promo is active (0.1 = 90% off). 1 when no discount applies."},"displayName":{"type":"string"},"id":{"type":"string"},"inputCostPer1kTokens":{"type":"number","format":"double"},"isAvailable":{"type":"boolean","description":"Read-only inference availability under workspace policy; does not change persisted isEnabled."},"isDefault":{"type":"boolean"},"isEnabled":{"type":"boolean"},"keyStatus":{"$ref":"#/components/schemas/V1ModelConfigsPostResponsesContentApplicationJsonSchemaKeyStatus"},"maxOutputTokens":{"type":"number","format":"double"},"migrationCandidateCount":{"type":"integer","minimum":0,"description":"Number of preserved legacy candidates considered during organization migration. Candidate settings remain internal."},"modelId":{"type":"string"},"organizationConnectionId":{"type":["string","null"],"description":"Normalized organization-owned connection reference. Null for platform selection, personal credentials, and providers that have not migrated."},"organizationId":{"type":["string","null"]},"outputCostPer1kTokens":{"type":"number","format":"double"},"provider":{"type":"string"},"providerKeyId":{"type":["string","null"],"description":"Previous-Worker-compatible provider-key alias. Updated organization clients should use organizationConnectionId; platform selection is null."},"reasoningCapability":{"$ref":"#/components/schemas/V1ModelConfigsPostResponsesContentApplicationJsonSchemaReasoningCapability"},"settings":{"type":"object","additionalProperties":{"description":"Any type"}},"supportedResponseFormats":{"type":"array","items":{"type":"string"}},"supportsCustomKey":{"type":"boolean"},"supportsSearch":{"type":"boolean"},"supportsStreaming":{"type":"boolean"},"supportsToolUse":{"type":"boolean","description":"True when the model catalog lists the model as supporting tool calls; absent otherwise."},"updatedAt":{"type":"string"},"userId":{"type":["string","null"],"description":"Legacy actor owner for personal/compatibility rows. Null for organization-owned model configurations."}},"required":["createdAt","id","isDefault","isEnabled","modelId","organizationId","provider","providerKeyId","settings","updatedAt","userId"],"title":"Model Configs_createModelConfiguration_Response_201"},"V1ModelConfigsPostResponsesContentApplicationJsonSchemaOneOf0Code":{"type":"string","enum":["ORGANIZATION_MODEL_CONFIG_MIGRATED"],"title":"V1ModelConfigsPostResponsesContentApplicationJsonSchemaOneOf0Code"},"CreateModelConfigurationRequestConflictError0":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/V1ModelConfigsPostResponsesContentApplicationJsonSchemaOneOf0Code"},"configId":{"type":"string"},"details":{"type":"string"},"error":{"type":"string"}},"required":["code","configId","details","error"],"title":"CreateModelConfigurationRequestConflictError0"},"V1ModelConfigsPostResponsesContentApplicationJsonSchemaOneOf1Code":{"type":"string","enum":["ORGANIZATION_MODEL_CONFIG_NEEDS_CONFIGURATION"],"title":"V1ModelConfigsPostResponsesContentApplicationJsonSchemaOneOf1Code"},"CreateModelConfigurationRequestConflictError1":{"type":"object","properties":{"candidateCount":{"type":"integer","exclusiveMinimum":0},"code":{"$ref":"#/components/schemas/V1ModelConfigsPostResponsesContentApplicationJsonSchemaOneOf1Code"},"configId":{"type":"string"},"details":{"type":"string"},"error":{"type":"string"},"modelId":{"type":"string"},"provider":{"type":"string"}},"required":["candidateCount","code","configId","details","error","modelId","provider"],"title":"CreateModelConfigurationRequestConflictError1"},"CreateModelConfigurationRequestConflictError":{"oneOf":[{"$ref":"#/components/schemas/CreateModelConfigurationRequestConflictError0"},{"$ref":"#/components/schemas/CreateModelConfigurationRequestConflictError1"}],"title":"CreateModelConfigurationRequestConflictError"},"V1ModelConfigsAvailableGetResponsesContentApplicationJsonSchemaCredentialPolicyMode":{"type":"string","enum":["byok_only","mixed","platform"],"description":"`byok_only`: the organization requires its own model keys; only `byokProviders` serve calls and Runtype platform keys are never used. `mixed`: some providers run on the account credentials and others on platform keys. `platform`: the account has connected no provider credentials.","title":"V1ModelConfigsAvailableGetResponsesContentApplicationJsonSchemaCredentialPolicyMode"},"V1ModelConfigsAvailableGetResponsesContentApplicationJsonSchemaCredentialPolicy":{"type":"object","properties":{"blockedProviders":{"type":"array","items":{"type":"string"},"description":"Providers organization policy refuses until a credential is connected."},"byokProviders":{"type":"array","items":{"type":"string"},"description":"Providers served by the account own credentials. `generic-openai` is its custom inference endpoint."},"mode":{"$ref":"#/components/schemas/V1ModelConfigsAvailableGetResponsesContentApplicationJsonSchemaCredentialPolicyMode","description":"`byok_only`: the organization requires its own model keys; only `byokProviders` serve calls and Runtype platform keys are never used. `mixed`: some providers run on the account credentials and others on platform keys. `platform`: the account has connected no provider credentials."},"platformProviders":{"type":"array","items":{"type":"string"},"description":"Providers served by Runtype platform keys."},"summary":{"type":"string","description":"Plain-language statement of the same facts."}},"required":["blockedProviders","byokProviders","mode","platformProviders","summary"],"description":"Which providers may serve a model call for this account. A model whose `keyStatus` is `needs_setup` is refused at execution.","title":"V1ModelConfigsAvailableGetResponsesContentApplicationJsonSchemaCredentialPolicy"},"V1ModelConfigsAvailableGetResponsesContentApplicationJsonSchemaDataItemsKeyStatus":{"type":"string","enum":["platform","custom","needs_setup"],"title":"V1ModelConfigsAvailableGetResponsesContentApplicationJsonSchemaDataItemsKeyStatus"},"V1ModelConfigsAvailableGetResponsesContentApplicationJsonSchemaDataItems":{"type":"object","properties":{"contextLength":{"type":"number","format":"double"},"costPer1kTokens":{"type":"number","format":"double"},"creditPromoLabel":{"type":["string","null"],"description":"Plain-language discount callout, e.g. \"90% off\". null when undiscounted."},"creditPromoMultiplier":{"type":"number","format":"double","description":"Factor platform-key spend on this model is billed at (0.1 = 90% off); 1 when undiscounted."},"displayName":{"type":"string"},"id":{"description":"Any type"},"isConfigured":{"type":"boolean"},"isDefault":{"type":"boolean"},"isEnabled":{"type":"boolean"},"keyStatus":{"$ref":"#/components/schemas/V1ModelConfigsAvailableGetResponsesContentApplicationJsonSchemaDataItemsKeyStatus"},"maxOutputTokens":{"type":"number","format":"double"},"modelId":{"type":"string"},"provider":{"type":"string"},"supportedResponseFormats":{"type":"array","items":{"type":"string"}},"supportsCustomKey":{"type":"boolean"},"supportsSearch":{"type":"boolean"},"supportsStreaming":{"type":"boolean"},"tags":{"type":"array","items":{"type":"string"}},"uiCategory":{"type":"string"},"uiPriority":{"type":"number","format":"double"}},"required":["costPer1kTokens","displayName","id","isConfigured","isDefault","isEnabled","keyStatus","modelId","provider","supportsCustomKey","supportsSearch"],"title":"V1ModelConfigsAvailableGetResponsesContentApplicationJsonSchemaDataItems"},"V1ModelConfigsAvailableGetResponsesContentApplicationJsonSchemaStats":{"type":"object","properties":{"configured":{"type":"integer"},"popular":{"type":"integer"},"totalAvailable":{"type":"integer"},"uiVisible":{"type":"integer"}},"required":["configured","popular","totalAvailable","uiVisible"],"title":"V1ModelConfigsAvailableGetResponsesContentApplicationJsonSchemaStats"},"Model_Configs_listAvailableModels_Response_200":{"type":"object","properties":{"credentialPolicy":{"$ref":"#/components/schemas/V1ModelConfigsAvailableGetResponsesContentApplicationJsonSchemaCredentialPolicy","description":"Which providers may serve a model call for this account. A model whose `keyStatus` is `needs_setup` is refused at execution."},"data":{"type":"array","items":{"$ref":"#/components/schemas/V1ModelConfigsAvailableGetResponsesContentApplicationJsonSchemaDataItems"}},"stats":{"$ref":"#/components/schemas/V1ModelConfigsAvailableGetResponsesContentApplicationJsonSchemaStats"},"total":{"type":"integer"}},"required":["data","stats","total"],"title":"Model Configs_listAvailableModels_Response_200"},"V1ModelConfigsGroupedGetResponsesContentApplicationJsonSchemaCredentialPolicyMode":{"type":"string","enum":["byok_only","mixed","platform"],"description":"`byok_only`: the organization requires its own model keys; only `byokProviders` serve calls and Runtype platform keys are never used. `mixed`: some providers run on the account credentials and others on platform keys. `platform`: the account has connected no provider credentials.","title":"V1ModelConfigsGroupedGetResponsesContentApplicationJsonSchemaCredentialPolicyMode"},"V1ModelConfigsGroupedGetResponsesContentApplicationJsonSchemaCredentialPolicy":{"type":"object","properties":{"blockedProviders":{"type":"array","items":{"type":"string"},"description":"Providers organization policy refuses until a credential is connected."},"byokProviders":{"type":"array","items":{"type":"string"},"description":"Providers served by the account own credentials. `generic-openai` is its custom inference endpoint."},"mode":{"$ref":"#/components/schemas/V1ModelConfigsGroupedGetResponsesContentApplicationJsonSchemaCredentialPolicyMode","description":"`byok_only`: the organization requires its own model keys; only `byokProviders` serve calls and Runtype platform keys are never used. `mixed`: some providers run on the account credentials and others on platform keys. `platform`: the account has connected no provider credentials."},"platformProviders":{"type":"array","items":{"type":"string"},"description":"Providers served by Runtype platform keys."},"summary":{"type":"string","description":"Plain-language statement of the same facts."}},"required":["blockedProviders","byokProviders","mode","platformProviders","summary"],"description":"Which providers may serve a model call for this account. A model whose `keyStatus` is `needs_setup` is refused at execution.","title":"V1ModelConfigsGroupedGetResponsesContentApplicationJsonSchemaCredentialPolicy"},"V1ModelConfigsGroupedGetResponsesContentApplicationJsonSchemaDataItemsConfiguredConfigsItems":{"type":"object","properties":{"id":{"type":"string"},"modelId":{"type":"string"},"provider":{"type":"string"}},"required":["id","modelId","provider"],"title":"V1ModelConfigsGroupedGetResponsesContentApplicationJsonSchemaDataItemsConfiguredConfigsItems"},"V1ModelConfigsGroupedGetResponsesContentApplicationJsonSchemaDataItemsProvidersItemsKeyStatus":{"type":"string","enum":["platform","custom","needs_setup"],"title":"V1ModelConfigsGroupedGetResponsesContentApplicationJsonSchemaDataItemsProvidersItemsKeyStatus"},"V1ModelConfigsGroupedGetResponsesContentApplicationJsonSchemaDataItemsProvidersItems":{"type":"object","properties":{"costPer1kTokens":{"type":"number","format":"double"},"creditPromoLabel":{"type":["string","null"],"description":"Plain-language discount callout, e.g. \"90% off\". null when undiscounted."},"creditPromoMultiplier":{"type":"number","format":"double","description":"Factor platform-key spend on this listing is billed at (0.1 = 90% off); 1 when undiscounted."},"hasPlatformKey":{"type":"boolean"},"inputCostPer1kTokens":{"type":"number","format":"double"},"keyStatus":{"$ref":"#/components/schemas/V1ModelConfigsGroupedGetResponsesContentApplicationJsonSchemaDataItemsProvidersItemsKeyStatus"},"modelId":{"type":"string"},"outputCostPer1kTokens":{"type":"number","format":"double"},"provider":{"type":"string"},"providerDisplayName":{"type":"string"}},"required":["costPer1kTokens","hasPlatformKey","inputCostPer1kTokens","modelId","outputCostPer1kTokens","provider","providerDisplayName"],"title":"V1ModelConfigsGroupedGetResponsesContentApplicationJsonSchemaDataItemsProvidersItems"},"V1ModelConfigsGroupedGetResponsesContentApplicationJsonSchemaDataItemsReasoningCapabilityAnthropicThinkingMode":{"type":"string","enum":["adaptive","enabled"],"description":"Anthropic only: the thinking request shape sent. adaptive (Claude 4.6 and later, including the Claude 5 family) accepts effort and rejects budgetTokens; enabled is the legacy budgetTokens form.","title":"V1ModelConfigsGroupedGetResponsesContentApplicationJsonSchemaDataItemsReasoningCapabilityAnthropicThinkingMode"},"V1ModelConfigsGroupedGetResponsesContentApplicationJsonSchemaDataItemsReasoningCapabilityGoogleThinkingMode":{"type":"string","enum":["budget","level"],"title":"V1ModelConfigsGroupedGetResponsesContentApplicationJsonSchemaDataItemsReasoningCapabilityGoogleThinkingMode"},"V1ModelConfigsGroupedGetResponsesContentApplicationJsonSchemaDataItemsReasoningCapabilityOptionsBudgetTokens":{"type":"object","properties":{"max":{"type":"number","format":"double"},"min":{"type":"number","format":"double"}},"title":"V1ModelConfigsGroupedGetResponsesContentApplicationJsonSchemaDataItemsReasoningCapabilityOptionsBudgetTokens"},"V1ModelConfigsGroupedGetResponsesContentApplicationJsonSchemaDataItemsReasoningCapabilityOptions":{"type":"object","properties":{"budgetTokens":{"$ref":"#/components/schemas/V1ModelConfigsGroupedGetResponsesContentApplicationJsonSchemaDataItemsReasoningCapabilityOptionsBudgetTokens"},"effort":{"type":"array","items":{"type":"string"}},"toggle":{"type":"boolean"}},"description":"Which reasoning knobs this model's API accepts (catalog-sourced from models.dev reasoning_options). Absent when the catalog has no claim for the model.","title":"V1ModelConfigsGroupedGetResponsesContentApplicationJsonSchemaDataItemsReasoningCapabilityOptions"},"V1ModelConfigsGroupedGetResponsesContentApplicationJsonSchemaDataItemsReasoningCapability":{"type":"object","properties":{"anthropicThinkingMode":{"$ref":"#/components/schemas/V1ModelConfigsGroupedGetResponsesContentApplicationJsonSchemaDataItemsReasoningCapabilityAnthropicThinkingMode","description":"Anthropic only: the thinking request shape sent. adaptive (Claude 4.6 and later, including the Claude 5 family) accepts effort and rejects budgetTokens; enabled is the legacy budgetTokens form."},"builtInReasoning":{"type":"boolean","description":"The model always reasons (GPT-5 / o-series); disabling is an effort floor, not off."},"googleThinkingMode":{"$ref":"#/components/schemas/V1ModelConfigsGroupedGetResponsesContentApplicationJsonSchemaDataItemsReasoningCapabilityGoogleThinkingMode"},"options":{"$ref":"#/components/schemas/V1ModelConfigsGroupedGetResponsesContentApplicationJsonSchemaDataItemsReasoningCapabilityOptions","description":"Which reasoning knobs this model's API accepts (catalog-sourced from models.dev reasoning_options). Absent when the catalog has no claim for the model."},"provider":{"type":"string"},"supported":{"type":"boolean"},"supportsReasoningSummary":{"type":"boolean"}},"required":["supported"],"title":"V1ModelConfigsGroupedGetResponsesContentApplicationJsonSchemaDataItemsReasoningCapability"},"V1ModelConfigsGroupedGetResponsesContentApplicationJsonSchemaDataItems":{"type":"object","properties":{"baseModel":{"type":"string"},"configuredConfigs":{"type":"array","items":{"$ref":"#/components/schemas/V1ModelConfigsGroupedGetResponsesContentApplicationJsonSchemaDataItemsConfiguredConfigsItems"}},"configuredProviders":{"type":"array","items":{"type":"string"}},"contextLength":{"type":"number","format":"double"},"creator":{"type":"string"},"creatorDisplayName":{"type":"string"},"creditPromoLabel":{"type":["string","null"],"description":"Plain-language discount callout for the family, e.g. \"90% off\". null when undiscounted."},"creditPromoMultiplier":{"type":"number","format":"double","description":"Factor platform-key spend on this model family is billed at while a credit promo is active (0.1 = 90% off). Follows the routed primary provider (a same-model failover onto another provider bills at that provider nominal price, undiscounted); 1 when undiscounted."},"displayName":{"type":"string"},"isConfigured":{"type":"boolean"},"isCustom":{"type":"boolean","description":"True for a model the account declared itself that the platform catalog does not list. `baseModel` is then the exact model id to run."},"lowestCost":{"type":"number","format":"double"},"maxOutputTokens":{"type":"number","format":"double"},"providers":{"type":"array","items":{"$ref":"#/components/schemas/V1ModelConfigsGroupedGetResponsesContentApplicationJsonSchemaDataItemsProvidersItems"}},"reasoningCapability":{"$ref":"#/components/schemas/V1ModelConfigsGroupedGetResponsesContentApplicationJsonSchemaDataItemsReasoningCapability"},"supportsReasoning":{"type":"boolean","description":"True when any provider entry supports extended reasoning"},"supportsToolUse":{"type":"boolean","description":"True when any provider entry supports tool/function calling"},"supportsVision":{"type":"boolean","description":"True when any provider entry supports image input"},"tags":{"type":"array","items":{"type":"string"}},"uiCategory":{"type":"string"},"uiPriority":{"type":"number","format":"double"}},"required":["baseModel","configuredConfigs","configuredProviders","contextLength","creator","creatorDisplayName","displayName","isConfigured","lowestCost","maxOutputTokens","providers","tags"],"title":"V1ModelConfigsGroupedGetResponsesContentApplicationJsonSchemaDataItems"},"V1ModelConfigsGroupedGetResponsesContentApplicationJsonSchemaStats":{"type":"object","properties":{"providersWithPlatformKeys":{"type":"array","items":{"type":"string"}},"totalModels":{"type":"integer"},"uniqueBaseModels":{"type":"integer"}},"required":["providersWithPlatformKeys","totalModels","uniqueBaseModels"],"title":"V1ModelConfigsGroupedGetResponsesContentApplicationJsonSchemaStats"},"Model_Configs_getGroupedModels_Response_200":{"type":"object","properties":{"credentialPolicy":{"$ref":"#/components/schemas/V1ModelConfigsGroupedGetResponsesContentApplicationJsonSchemaCredentialPolicy","description":"Which providers may serve a model call for this account. A model whose `keyStatus` is `needs_setup` is refused at execution."},"data":{"type":"array","items":{"$ref":"#/components/schemas/V1ModelConfigsGroupedGetResponsesContentApplicationJsonSchemaDataItems"}},"stats":{"$ref":"#/components/schemas/V1ModelConfigsGroupedGetResponsesContentApplicationJsonSchemaStats"},"total":{"type":"integer"}},"required":["data","stats","total"],"title":"Model Configs_getGroupedModels_Response_200"},"V1ModelConfigsSearchCapableGetResponsesContentApplicationJsonSchemaDataItemsKeyStatus":{"type":"string","enum":["platform","custom","needs_setup"],"title":"V1ModelConfigsSearchCapableGetResponsesContentApplicationJsonSchemaDataItemsKeyStatus"},"V1ModelConfigsSearchCapableGetResponsesContentApplicationJsonSchemaDataItems":{"type":"object","properties":{"creditPromoLabel":{"type":["string","null"],"description":"Plain-language discount callout, e.g. \"90% off\". null when undiscounted (always null for the Exa entry)."},"creditPromoMultiplier":{"type":"number","format":"double","description":"Factor platform-key spend on this model is billed at (0.1 = 90% off); 1 when undiscounted."},"displayLabel":{"type":"string"},"id":{"type":"string"},"keyStatus":{"$ref":"#/components/schemas/V1ModelConfigsSearchCapableGetResponsesContentApplicationJsonSchemaDataItemsKeyStatus"},"name":{"type":"string"},"provider":{"type":"string"},"supportsCustomKey":{"type":"boolean"}},"required":["displayLabel","id","keyStatus","name","provider","supportsCustomKey"],"title":"V1ModelConfigsSearchCapableGetResponsesContentApplicationJsonSchemaDataItems"},"Model_Configs_listSearchCapableModels_Response_200":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1ModelConfigsSearchCapableGetResponsesContentApplicationJsonSchemaDataItems"}},"total":{"type":"integer"}},"required":["data","total"],"title":"Model Configs_listSearchCapableModels_Response_200"},"V1ModelConfigsSearchConfiguredGetResponsesContentApplicationJsonSchemaDataItemsKeyStatus":{"type":"string","enum":["platform","custom","needs_setup"],"title":"V1ModelConfigsSearchConfiguredGetResponsesContentApplicationJsonSchemaDataItemsKeyStatus"},"V1ModelConfigsSearchConfiguredGetResponsesContentApplicationJsonSchemaDataItems":{"type":"object","properties":{"creditPromoLabel":{"type":["string","null"],"description":"Plain-language discount callout, e.g. \"90% off\". null when undiscounted (always null for the Exa entry)."},"creditPromoMultiplier":{"type":"number","format":"double","description":"Factor platform-key spend on this model is billed at (0.1 = 90% off); 1 when undiscounted."},"displayLabel":{"type":"string"},"id":{"type":"string"},"keyStatus":{"$ref":"#/components/schemas/V1ModelConfigsSearchConfiguredGetResponsesContentApplicationJsonSchemaDataItemsKeyStatus"},"name":{"type":"string"},"provider":{"type":"string"},"supportsCustomKey":{"type":"boolean"}},"required":["displayLabel","id","keyStatus","name","provider","supportsCustomKey"],"title":"V1ModelConfigsSearchConfiguredGetResponsesContentApplicationJsonSchemaDataItems"},"Model_Configs_listConfiguredSearchProviders_Response_200":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1ModelConfigsSearchConfiguredGetResponsesContentApplicationJsonSchemaDataItems"}},"total":{"type":"integer"}},"required":["data","total"],"title":"Model Configs_listConfiguredSearchProviders_Response_200"},"V1ModelConfigsUsageGetResponsesContentApplicationJsonSchemaDataItems":{"type":"object","properties":{"lastUsedAt":{"type":["string","null"]},"modelId":{"type":"string"},"provider":{"type":"string"},"usageCount":{"type":["integer","null"]}},"required":["lastUsedAt","modelId","provider","usageCount"],"title":"V1ModelConfigsUsageGetResponsesContentApplicationJsonSchemaDataItems"},"Model_Configs_getModelConfigurationUsage_Response_200":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1ModelConfigsUsageGetResponsesContentApplicationJsonSchemaDataItems"}},"total":{"type":"integer"}},"required":["data","total"],"title":"Model Configs_getModelConfigurationUsage_Response_200"},"V1ModelConfigsIdPutRequestBodyContentApplicationJsonSchemaSettingsCustomModelExecutorConfig":{"type":"object","properties":{"baseURL":{"type":"string","format":"uri"},"modelMapping":{"type":"string"}},"title":"V1ModelConfigsIdPutRequestBodyContentApplicationJsonSchemaSettingsCustomModelExecutorConfig"},"V1ModelConfigsIdPutRequestBodyContentApplicationJsonSchemaSettingsCustomModelExecutorProvider":{"type":"string","enum":["openai","anthropic","google","xai","vertex","vertex-anthropic","bedrock","tinfoil","vercel","generic-openai"],"title":"V1ModelConfigsIdPutRequestBodyContentApplicationJsonSchemaSettingsCustomModelExecutorProvider"},"V1ModelConfigsIdPutRequestBodyContentApplicationJsonSchemaSettingsCustomModelMidConversationSystemMessages":{"type":"string","enum":["preserve","hoist"],"description":"Where a system message that follows a conversation turn lands on this endpoint. Omitted keeps it at its position (Mistral- and Gemma-family ids fold it into the leading prompt); \"hoist\" folds it for any endpoint whose chat template rejects a non-leading system role.","title":"V1ModelConfigsIdPutRequestBodyContentApplicationJsonSchemaSettingsCustomModelMidConversationSystemMessages"},"V1ModelConfigsIdPutRequestBodyContentApplicationJsonSchemaSettingsCustomModelReasoning":{"type":"object","properties":{"defaultEffort":{"type":"string","minLength":1,"maxLength":32},"supported":{"type":"boolean"}},"required":["supported"],"title":"V1ModelConfigsIdPutRequestBodyContentApplicationJsonSchemaSettingsCustomModelReasoning"},"V1ModelConfigsIdPutRequestBodyContentApplicationJsonSchemaSettingsCustomModel":{"type":"object","properties":{"displayName":{"type":"string","minLength":1},"executorConfig":{"$ref":"#/components/schemas/V1ModelConfigsIdPutRequestBodyContentApplicationJsonSchemaSettingsCustomModelExecutorConfig"},"executorProvider":{"$ref":"#/components/schemas/V1ModelConfigsIdPutRequestBodyContentApplicationJsonSchemaSettingsCustomModelExecutorProvider"},"inputCostPer1kTokens":{"type":"number","format":"double","minimum":0},"maxOutputTokens":{"type":"integer","exclusiveMinimum":0},"midConversationSystemMessages":{"$ref":"#/components/schemas/V1ModelConfigsIdPutRequestBodyContentApplicationJsonSchemaSettingsCustomModelMidConversationSystemMessages","description":"Where a system message that follows a conversation turn lands on this endpoint. Omitted keeps it at its position (Mistral- and Gemma-family ids fold it into the leading prompt); \"hoist\" folds it for any endpoint whose chat template rejects a non-leading system role."},"outputCostPer1kTokens":{"type":"number","format":"double","minimum":0},"reasoning":{"$ref":"#/components/schemas/V1ModelConfigsIdPutRequestBodyContentApplicationJsonSchemaSettingsCustomModelReasoning"},"supportedResponseFormats":{"type":"array","items":{"type":"string"}},"supportsStreaming":{"type":"boolean"}},"required":["displayName","inputCostPer1kTokens","outputCostPer1kTokens"],"title":"V1ModelConfigsIdPutRequestBodyContentApplicationJsonSchemaSettingsCustomModel"},"V1ModelConfigsIdPutRequestBodyContentApplicationJsonSchemaSettings":{"type":"object","properties":{"customModel":{"$ref":"#/components/schemas/V1ModelConfigsIdPutRequestBodyContentApplicationJsonSchemaSettingsCustomModel"},"maxTokens":{"type":"integer","exclusiveMinimum":0},"temperature":{"type":"number","format":"double","minimum":0,"maximum":2}},"title":"V1ModelConfigsIdPutRequestBodyContentApplicationJsonSchemaSettings"},"V1ModelConfigsIdPutResponsesContentApplicationJsonSchemaConfigurationStatus":{"type":"string","enum":["ready","needs_configuration"],"description":"Organization configuration readiness. `needs_configuration` means conflicting legacy teammate settings were preserved and execution fails closed until an authorized actor deliberately updates the canonical row.","title":"V1ModelConfigsIdPutResponsesContentApplicationJsonSchemaConfigurationStatus"},"V1ModelConfigsIdPutResponsesContentApplicationJsonSchemaKeyStatus":{"type":"string","enum":["platform","custom","needs_setup"],"title":"V1ModelConfigsIdPutResponsesContentApplicationJsonSchemaKeyStatus"},"V1ModelConfigsIdPutResponsesContentApplicationJsonSchemaReasoningCapabilityAnthropicThinkingMode":{"type":"string","enum":["adaptive","enabled"],"description":"Anthropic only: the thinking request shape sent. adaptive (Claude 4.6 and later, including the Claude 5 family) accepts effort and rejects budgetTokens; enabled is the legacy budgetTokens form.","title":"V1ModelConfigsIdPutResponsesContentApplicationJsonSchemaReasoningCapabilityAnthropicThinkingMode"},"V1ModelConfigsIdPutResponsesContentApplicationJsonSchemaReasoningCapabilityGoogleThinkingMode":{"type":"string","enum":["budget","level"],"title":"V1ModelConfigsIdPutResponsesContentApplicationJsonSchemaReasoningCapabilityGoogleThinkingMode"},"V1ModelConfigsIdPutResponsesContentApplicationJsonSchemaReasoningCapabilityOptionsBudgetTokens":{"type":"object","properties":{"max":{"type":"number","format":"double"},"min":{"type":"number","format":"double"}},"title":"V1ModelConfigsIdPutResponsesContentApplicationJsonSchemaReasoningCapabilityOptionsBudgetTokens"},"V1ModelConfigsIdPutResponsesContentApplicationJsonSchemaReasoningCapabilityOptions":{"type":"object","properties":{"budgetTokens":{"$ref":"#/components/schemas/V1ModelConfigsIdPutResponsesContentApplicationJsonSchemaReasoningCapabilityOptionsBudgetTokens"},"effort":{"type":"array","items":{"type":"string"}},"toggle":{"type":"boolean"}},"description":"Which reasoning knobs this model's API accepts (catalog-sourced from models.dev reasoning_options). Absent when the catalog has no claim for the model.","title":"V1ModelConfigsIdPutResponsesContentApplicationJsonSchemaReasoningCapabilityOptions"},"V1ModelConfigsIdPutResponsesContentApplicationJsonSchemaReasoningCapability":{"type":"object","properties":{"anthropicThinkingMode":{"$ref":"#/components/schemas/V1ModelConfigsIdPutResponsesContentApplicationJsonSchemaReasoningCapabilityAnthropicThinkingMode","description":"Anthropic only: the thinking request shape sent. adaptive (Claude 4.6 and later, including the Claude 5 family) accepts effort and rejects budgetTokens; enabled is the legacy budgetTokens form."},"builtInReasoning":{"type":"boolean","description":"The model always reasons (GPT-5 / o-series); disabling is an effort floor, not off."},"googleThinkingMode":{"$ref":"#/components/schemas/V1ModelConfigsIdPutResponsesContentApplicationJsonSchemaReasoningCapabilityGoogleThinkingMode"},"options":{"$ref":"#/components/schemas/V1ModelConfigsIdPutResponsesContentApplicationJsonSchemaReasoningCapabilityOptions","description":"Which reasoning knobs this model's API accepts (catalog-sourced from models.dev reasoning_options). Absent when the catalog has no claim for the model."},"provider":{"type":"string"},"supported":{"type":"boolean"},"supportsReasoningSummary":{"type":"boolean"}},"required":["supported"],"title":"V1ModelConfigsIdPutResponsesContentApplicationJsonSchemaReasoningCapability"},"Model_Configs_updateModelConfiguration_Response_200":{"type":"object","properties":{"configScope":{"type":"string","description":"`personal` or `organization` for a stored configuration. `organization_connection` marks a model an organization custom inference endpoint declares that the caller has no stored configuration for: it is runnable, and its `id` cannot be updated, toggled, or deleted (change the connection model list instead)."},"configurationStatus":{"$ref":"#/components/schemas/V1ModelConfigsIdPutResponsesContentApplicationJsonSchemaConfigurationStatus","description":"Organization configuration readiness. `needs_configuration` means conflicting legacy teammate settings were preserved and execution fails closed until an authorized actor deliberately updates the canonical row."},"costPer1kTokens":{"type":"number","format":"double"},"createdAt":{"type":"string"},"createdByUserId":{"type":["string","null"],"description":"Nullable creation provenance for organization-owned model configurations; never authorization or execution authority."},"creator":{"type":"string"},"creatorDisplayName":{"type":["string","null"]},"creditPromoLabel":{"type":["string","null"],"description":"Plain-language discount callout for this model, e.g. \"90% off\". null when undiscounted."},"creditPromoMultiplier":{"type":"number","format":"double","description":"Factor platform-key spend on this model is billed at while a credit promo is active (0.1 = 90% off). 1 when no discount applies."},"displayName":{"type":"string"},"id":{"type":"string"},"inputCostPer1kTokens":{"type":"number","format":"double"},"isAvailable":{"type":"boolean","description":"Read-only inference availability under workspace policy; does not change persisted isEnabled."},"isDefault":{"type":"boolean"},"isEnabled":{"type":"boolean"},"keyStatus":{"$ref":"#/components/schemas/V1ModelConfigsIdPutResponsesContentApplicationJsonSchemaKeyStatus"},"maxOutputTokens":{"type":"number","format":"double"},"migrationCandidateCount":{"type":"integer","minimum":0,"description":"Number of preserved legacy candidates considered during organization migration. Candidate settings remain internal."},"modelId":{"type":"string"},"organizationConnectionId":{"type":["string","null"],"description":"Normalized organization-owned connection reference. Null for platform selection, personal credentials, and providers that have not migrated."},"organizationId":{"type":["string","null"]},"outputCostPer1kTokens":{"type":"number","format":"double"},"provider":{"type":"string"},"providerKeyId":{"type":["string","null"],"description":"Previous-Worker-compatible provider-key alias. Updated organization clients should use organizationConnectionId; platform selection is null."},"reasoningCapability":{"$ref":"#/components/schemas/V1ModelConfigsIdPutResponsesContentApplicationJsonSchemaReasoningCapability"},"settings":{"type":"object","additionalProperties":{"description":"Any type"}},"supportedResponseFormats":{"type":"array","items":{"type":"string"}},"supportsCustomKey":{"type":"boolean"},"supportsSearch":{"type":"boolean"},"supportsStreaming":{"type":"boolean"},"supportsToolUse":{"type":"boolean","description":"True when the model catalog lists the model as supporting tool calls; absent otherwise."},"updatedAt":{"type":"string"},"userId":{"type":["string","null"],"description":"Legacy actor owner for personal/compatibility rows. Null for organization-owned model configurations."}},"required":["createdAt","id","isDefault","isEnabled","modelId","organizationId","provider","providerKeyId","settings","updatedAt","userId"],"title":"Model Configs_updateModelConfiguration_Response_200"},"V1ModelConfigsIdPutResponsesContentApplicationJsonSchemaOneOf0Code":{"type":"string","enum":["ORGANIZATION_MODEL_CONFIG_MIGRATED"],"title":"V1ModelConfigsIdPutResponsesContentApplicationJsonSchemaOneOf0Code"},"UpdateModelConfigurationRequestConflictError0":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/V1ModelConfigsIdPutResponsesContentApplicationJsonSchemaOneOf0Code"},"configId":{"type":"string"},"details":{"type":"string"},"error":{"type":"string"}},"required":["code","configId","details","error"],"title":"UpdateModelConfigurationRequestConflictError0"},"V1ModelConfigsIdPutResponsesContentApplicationJsonSchemaOneOf1Code":{"type":"string","enum":["ORGANIZATION_MODEL_CONFIG_NEEDS_CONFIGURATION"],"title":"V1ModelConfigsIdPutResponsesContentApplicationJsonSchemaOneOf1Code"},"UpdateModelConfigurationRequestConflictError1":{"type":"object","properties":{"candidateCount":{"type":"integer","exclusiveMinimum":0},"code":{"$ref":"#/components/schemas/V1ModelConfigsIdPutResponsesContentApplicationJsonSchemaOneOf1Code"},"configId":{"type":"string"},"details":{"type":"string"},"error":{"type":"string"},"modelId":{"type":"string"},"provider":{"type":"string"}},"required":["candidateCount","code","configId","details","error","modelId","provider"],"title":"UpdateModelConfigurationRequestConflictError1"},"UpdateModelConfigurationRequestConflictError":{"oneOf":[{"$ref":"#/components/schemas/UpdateModelConfigurationRequestConflictError0"},{"$ref":"#/components/schemas/UpdateModelConfigurationRequestConflictError1"}],"title":"UpdateModelConfigurationRequestConflictError"},"V1ModelConfigsIdDeleteResponsesContentApplicationJsonSchemaOneOf0Code":{"type":"string","enum":["ORGANIZATION_MODEL_CONFIG_MIGRATED"],"title":"V1ModelConfigsIdDeleteResponsesContentApplicationJsonSchemaOneOf0Code"},"DeleteModelConfigurationRequestConflictError0":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/V1ModelConfigsIdDeleteResponsesContentApplicationJsonSchemaOneOf0Code"},"configId":{"type":"string"},"details":{"type":"string"},"error":{"type":"string"}},"required":["code","configId","details","error"],"title":"DeleteModelConfigurationRequestConflictError0"},"V1ModelConfigsIdDeleteResponsesContentApplicationJsonSchemaOneOf1Code":{"type":"string","enum":["ORGANIZATION_MODEL_CONFIG_NEEDS_CONFIGURATION"],"title":"V1ModelConfigsIdDeleteResponsesContentApplicationJsonSchemaOneOf1Code"},"DeleteModelConfigurationRequestConflictError1":{"type":"object","properties":{"candidateCount":{"type":"integer","exclusiveMinimum":0},"code":{"$ref":"#/components/schemas/V1ModelConfigsIdDeleteResponsesContentApplicationJsonSchemaOneOf1Code"},"configId":{"type":"string"},"details":{"type":"string"},"error":{"type":"string"},"modelId":{"type":"string"},"provider":{"type":"string"}},"required":["candidateCount","code","configId","details","error","modelId","provider"],"title":"DeleteModelConfigurationRequestConflictError1"},"DeleteModelConfigurationRequestConflictError":{"oneOf":[{"$ref":"#/components/schemas/DeleteModelConfigurationRequestConflictError0"},{"$ref":"#/components/schemas/DeleteModelConfigurationRequestConflictError1"}],"title":"DeleteModelConfigurationRequestConflictError"},"V1ModelConfigsIdDefaultPatchResponsesContentApplicationJsonSchemaDataConfigurationStatus":{"type":"string","enum":["ready","needs_configuration"],"description":"Organization configuration readiness. `needs_configuration` means conflicting legacy teammate settings were preserved and execution fails closed until an authorized actor deliberately updates the canonical row.","title":"V1ModelConfigsIdDefaultPatchResponsesContentApplicationJsonSchemaDataConfigurationStatus"},"V1ModelConfigsIdDefaultPatchResponsesContentApplicationJsonSchemaDataKeyStatus":{"type":"string","enum":["platform","custom","needs_setup"],"title":"V1ModelConfigsIdDefaultPatchResponsesContentApplicationJsonSchemaDataKeyStatus"},"V1ModelConfigsIdDefaultPatchResponsesContentApplicationJsonSchemaDataReasoningCapabilityAnthropicThinkingMode":{"type":"string","enum":["adaptive","enabled"],"description":"Anthropic only: the thinking request shape sent. adaptive (Claude 4.6 and later, including the Claude 5 family) accepts effort and rejects budgetTokens; enabled is the legacy budgetTokens form.","title":"V1ModelConfigsIdDefaultPatchResponsesContentApplicationJsonSchemaDataReasoningCapabilityAnthropicThinkingMode"},"V1ModelConfigsIdDefaultPatchResponsesContentApplicationJsonSchemaDataReasoningCapabilityGoogleThinkingMode":{"type":"string","enum":["budget","level"],"title":"V1ModelConfigsIdDefaultPatchResponsesContentApplicationJsonSchemaDataReasoningCapabilityGoogleThinkingMode"},"V1ModelConfigsIdDefaultPatchResponsesContentApplicationJsonSchemaDataReasoningCapabilityOptionsBudgetTokens":{"type":"object","properties":{"max":{"type":"number","format":"double"},"min":{"type":"number","format":"double"}},"title":"V1ModelConfigsIdDefaultPatchResponsesContentApplicationJsonSchemaDataReasoningCapabilityOptionsBudgetTokens"},"V1ModelConfigsIdDefaultPatchResponsesContentApplicationJsonSchemaDataReasoningCapabilityOptions":{"type":"object","properties":{"budgetTokens":{"$ref":"#/components/schemas/V1ModelConfigsIdDefaultPatchResponsesContentApplicationJsonSchemaDataReasoningCapabilityOptionsBudgetTokens"},"effort":{"type":"array","items":{"type":"string"}},"toggle":{"type":"boolean"}},"description":"Which reasoning knobs this model's API accepts (catalog-sourced from models.dev reasoning_options). Absent when the catalog has no claim for the model.","title":"V1ModelConfigsIdDefaultPatchResponsesContentApplicationJsonSchemaDataReasoningCapabilityOptions"},"V1ModelConfigsIdDefaultPatchResponsesContentApplicationJsonSchemaDataReasoningCapability":{"type":"object","properties":{"anthropicThinkingMode":{"$ref":"#/components/schemas/V1ModelConfigsIdDefaultPatchResponsesContentApplicationJsonSchemaDataReasoningCapabilityAnthropicThinkingMode","description":"Anthropic only: the thinking request shape sent. adaptive (Claude 4.6 and later, including the Claude 5 family) accepts effort and rejects budgetTokens; enabled is the legacy budgetTokens form."},"builtInReasoning":{"type":"boolean","description":"The model always reasons (GPT-5 / o-series); disabling is an effort floor, not off."},"googleThinkingMode":{"$ref":"#/components/schemas/V1ModelConfigsIdDefaultPatchResponsesContentApplicationJsonSchemaDataReasoningCapabilityGoogleThinkingMode"},"options":{"$ref":"#/components/schemas/V1ModelConfigsIdDefaultPatchResponsesContentApplicationJsonSchemaDataReasoningCapabilityOptions","description":"Which reasoning knobs this model's API accepts (catalog-sourced from models.dev reasoning_options). Absent when the catalog has no claim for the model."},"provider":{"type":"string"},"supported":{"type":"boolean"},"supportsReasoningSummary":{"type":"boolean"}},"required":["supported"],"title":"V1ModelConfigsIdDefaultPatchResponsesContentApplicationJsonSchemaDataReasoningCapability"},"V1ModelConfigsIdDefaultPatchResponsesContentApplicationJsonSchemaData":{"type":"object","properties":{"configScope":{"type":"string","description":"`personal` or `organization` for a stored configuration. `organization_connection` marks a model an organization custom inference endpoint declares that the caller has no stored configuration for: it is runnable, and its `id` cannot be updated, toggled, or deleted (change the connection model list instead)."},"configurationStatus":{"$ref":"#/components/schemas/V1ModelConfigsIdDefaultPatchResponsesContentApplicationJsonSchemaDataConfigurationStatus","description":"Organization configuration readiness. `needs_configuration` means conflicting legacy teammate settings were preserved and execution fails closed until an authorized actor deliberately updates the canonical row."},"costPer1kTokens":{"type":"number","format":"double"},"createdAt":{"type":"string"},"createdByUserId":{"type":["string","null"],"description":"Nullable creation provenance for organization-owned model configurations; never authorization or execution authority."},"creator":{"type":"string"},"creatorDisplayName":{"type":["string","null"]},"creditPromoLabel":{"type":["string","null"],"description":"Plain-language discount callout for this model, e.g. \"90% off\". null when undiscounted."},"creditPromoMultiplier":{"type":"number","format":"double","description":"Factor platform-key spend on this model is billed at while a credit promo is active (0.1 = 90% off). 1 when no discount applies."},"displayName":{"type":"string"},"id":{"type":"string"},"inputCostPer1kTokens":{"type":"number","format":"double"},"isAvailable":{"type":"boolean","description":"Read-only inference availability under workspace policy; does not change persisted isEnabled."},"isDefault":{"type":"boolean"},"isEnabled":{"type":"boolean"},"keyStatus":{"$ref":"#/components/schemas/V1ModelConfigsIdDefaultPatchResponsesContentApplicationJsonSchemaDataKeyStatus"},"maxOutputTokens":{"type":"number","format":"double"},"migrationCandidateCount":{"type":"integer","minimum":0,"description":"Number of preserved legacy candidates considered during organization migration. Candidate settings remain internal."},"modelId":{"type":"string"},"organizationConnectionId":{"type":["string","null"],"description":"Normalized organization-owned connection reference. Null for platform selection, personal credentials, and providers that have not migrated."},"organizationId":{"type":["string","null"]},"outputCostPer1kTokens":{"type":"number","format":"double"},"provider":{"type":"string"},"providerKeyId":{"type":["string","null"],"description":"Previous-Worker-compatible provider-key alias. Updated organization clients should use organizationConnectionId; platform selection is null."},"reasoningCapability":{"$ref":"#/components/schemas/V1ModelConfigsIdDefaultPatchResponsesContentApplicationJsonSchemaDataReasoningCapability"},"settings":{"type":"object","additionalProperties":{"description":"Any type"}},"supportedResponseFormats":{"type":"array","items":{"type":"string"}},"supportsCustomKey":{"type":"boolean"},"supportsSearch":{"type":"boolean"},"supportsStreaming":{"type":"boolean"},"supportsToolUse":{"type":"boolean","description":"True when the model catalog lists the model as supporting tool calls; absent otherwise."},"updatedAt":{"type":"string"},"userId":{"type":["string","null"],"description":"Legacy actor owner for personal/compatibility rows. Null for organization-owned model configurations."}},"required":["createdAt","id","isDefault","isEnabled","modelId","organizationId","provider","providerKeyId","settings","updatedAt","userId"],"title":"V1ModelConfigsIdDefaultPatchResponsesContentApplicationJsonSchemaData"},"Model_Configs_setDefaultModelConfiguration_Response_200":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/V1ModelConfigsIdDefaultPatchResponsesContentApplicationJsonSchemaData"},"message":{"type":"string"},"success":{"type":"boolean"}},"required":["data","message","success"],"title":"Model Configs_setDefaultModelConfiguration_Response_200"},"V1ModelConfigsIdDefaultPatchResponsesContentApplicationJsonSchemaOneOf0Code":{"type":"string","enum":["ORGANIZATION_MODEL_CONFIG_MIGRATED"],"title":"V1ModelConfigsIdDefaultPatchResponsesContentApplicationJsonSchemaOneOf0Code"},"SetDefaultModelConfigurationRequestConflictError0":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/V1ModelConfigsIdDefaultPatchResponsesContentApplicationJsonSchemaOneOf0Code"},"configId":{"type":"string"},"details":{"type":"string"},"error":{"type":"string"}},"required":["code","configId","details","error"],"title":"SetDefaultModelConfigurationRequestConflictError0"},"V1ModelConfigsIdDefaultPatchResponsesContentApplicationJsonSchemaOneOf1Code":{"type":"string","enum":["ORGANIZATION_MODEL_CONFIG_NEEDS_CONFIGURATION"],"title":"V1ModelConfigsIdDefaultPatchResponsesContentApplicationJsonSchemaOneOf1Code"},"SetDefaultModelConfigurationRequestConflictError1":{"type":"object","properties":{"candidateCount":{"type":"integer","exclusiveMinimum":0},"code":{"$ref":"#/components/schemas/V1ModelConfigsIdDefaultPatchResponsesContentApplicationJsonSchemaOneOf1Code"},"configId":{"type":"string"},"details":{"type":"string"},"error":{"type":"string"},"modelId":{"type":"string"},"provider":{"type":"string"}},"required":["candidateCount","code","configId","details","error","modelId","provider"],"title":"SetDefaultModelConfigurationRequestConflictError1"},"SetDefaultModelConfigurationRequestConflictError":{"oneOf":[{"$ref":"#/components/schemas/SetDefaultModelConfigurationRequestConflictError0"},{"$ref":"#/components/schemas/SetDefaultModelConfigurationRequestConflictError1"}],"title":"SetDefaultModelConfigurationRequestConflictError"},"Model_Configs_enableOrDisableModelConfiguration_Response_200":{"type":"object","properties":{"message":{"type":"string"},"success":{"type":"boolean"}},"required":["message","success"],"title":"Model Configs_enableOrDisableModelConfiguration_Response_200"},"V1ModelConfigsIdStatusPatchResponsesContentApplicationJsonSchemaOneOf0Code":{"type":"string","enum":["ORGANIZATION_MODEL_CONFIG_MIGRATED"],"title":"V1ModelConfigsIdStatusPatchResponsesContentApplicationJsonSchemaOneOf0Code"},"EnableOrDisableModelConfigurationRequestConflictError0":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/V1ModelConfigsIdStatusPatchResponsesContentApplicationJsonSchemaOneOf0Code"},"configId":{"type":"string"},"details":{"type":"string"},"error":{"type":"string"}},"required":["code","configId","details","error"],"title":"EnableOrDisableModelConfigurationRequestConflictError0"},"V1ModelConfigsIdStatusPatchResponsesContentApplicationJsonSchemaOneOf1Code":{"type":"string","enum":["ORGANIZATION_MODEL_CONFIG_NEEDS_CONFIGURATION"],"title":"V1ModelConfigsIdStatusPatchResponsesContentApplicationJsonSchemaOneOf1Code"},"EnableOrDisableModelConfigurationRequestConflictError1":{"type":"object","properties":{"candidateCount":{"type":"integer","exclusiveMinimum":0},"code":{"$ref":"#/components/schemas/V1ModelConfigsIdStatusPatchResponsesContentApplicationJsonSchemaOneOf1Code"},"configId":{"type":"string"},"details":{"type":"string"},"error":{"type":"string"},"modelId":{"type":"string"},"provider":{"type":"string"}},"required":["candidateCount","code","configId","details","error","modelId","provider"],"title":"EnableOrDisableModelConfigurationRequestConflictError1"},"EnableOrDisableModelConfigurationRequestConflictError":{"oneOf":[{"$ref":"#/components/schemas/EnableOrDisableModelConfigurationRequestConflictError0"},{"$ref":"#/components/schemas/EnableOrDisableModelConfigurationRequestConflictError1"}],"title":"EnableOrDisableModelConfigurationRequestConflictError"},"V1ModelUsageGetResponsesContentApplicationJsonSchemaMeta":{"type":"object","properties":{"dataSource":{"type":"string"},"endDate":{"type":"string"},"granularity":{"type":"string"},"period":{"type":"string"},"startDate":{"type":"string"}},"required":["endDate","startDate"],"title":"V1ModelUsageGetResponsesContentApplicationJsonSchemaMeta"},"V1ModelUsageGetResponsesContentApplicationJsonSchemaSummary":{"type":"object","properties":{"platformCost":{"type":"number","format":"double"},"platformTokens":{"type":"number","format":"double"},"totalCost":{"type":"number","format":"double"},"totalRequests":{"type":"number","format":"double"},"totalTokens":{"type":"number","format":"double"},"userCost":{"type":"number","format":"double"},"userTokens":{"type":"number","format":"double"}},"required":["totalCost","totalRequests","totalTokens"],"title":"V1ModelUsageGetResponsesContentApplicationJsonSchemaSummary"},"V1ModelUsageGetResponsesContentApplicationJsonSchemaTimeSeriesItems":{"type":"object","properties":{"cost":{"type":"number","format":"double"},"date":{"type":"string"},"requests":{"type":"number","format":"double"},"tokens":{"type":"number","format":"double"}},"required":["cost","date","requests","tokens"],"title":"V1ModelUsageGetResponsesContentApplicationJsonSchemaTimeSeriesItems"},"V1ModelUsageGetResponsesContentApplicationJsonSchemaUsageByModel":{"type":"object","properties":{"avgCostPerRequest":{"type":"number","format":"double"},"modelId":{"type":"string"},"modelName":{"type":"string"},"provider":{"type":"string"},"requestCount":{"type":"number","format":"double"},"totalCost":{"type":"number","format":"double"},"totalTokens":{"type":"number","format":"double"}},"required":["avgCostPerRequest","modelId","provider","requestCount","totalCost","totalTokens"],"title":"V1ModelUsageGetResponsesContentApplicationJsonSchemaUsageByModel"},"Model_Usage_getModelUsageStatistics_Response_200":{"type":"object","properties":{"meta":{"$ref":"#/components/schemas/V1ModelUsageGetResponsesContentApplicationJsonSchemaMeta"},"summary":{"$ref":"#/components/schemas/V1ModelUsageGetResponsesContentApplicationJsonSchemaSummary"},"timeSeries":{"type":"array","items":{"$ref":"#/components/schemas/V1ModelUsageGetResponsesContentApplicationJsonSchemaTimeSeriesItems"}},"usageByModel":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/V1ModelUsageGetResponsesContentApplicationJsonSchemaUsageByModel"}}},"required":["meta","summary","usageByModel"],"title":"Model Usage_getModelUsageStatistics_Response_200"},"V1ModelUsageModelConfigIdGetResponsesContentApplicationJsonSchemaMeta":{"type":"object","properties":{"dataSource":{"type":"string"}},"required":["dataSource"],"title":"V1ModelUsageModelConfigIdGetResponsesContentApplicationJsonSchemaMeta"},"V1ModelUsageModelConfigIdGetResponsesContentApplicationJsonSchemaModelConfig":{"type":"object","properties":{"displayName":{"type":"string"},"id":{"type":"string"},"modelId":{"type":"string"},"provider":{"type":"string"}},"required":["displayName","id","modelId","provider"],"title":"V1ModelUsageModelConfigIdGetResponsesContentApplicationJsonSchemaModelConfig"},"V1ModelUsageModelConfigIdGetResponsesContentApplicationJsonSchemaRecentUsageItems":{"type":"object","properties":{"completionTokens":{"type":"number","format":"double"},"estimatedCost":{"type":"number","format":"double"},"executionTime":{"type":"number","format":"double"},"id":{"type":"string"},"promptTokens":{"type":"number","format":"double"},"timestamp":{"type":"string"},"totalTokens":{"type":"number","format":"double"}},"required":["id","timestamp"],"title":"V1ModelUsageModelConfigIdGetResponsesContentApplicationJsonSchemaRecentUsageItems"},"Model_Usage_getModelUsageDetails_Response_200":{"type":"object","properties":{"meta":{"$ref":"#/components/schemas/V1ModelUsageModelConfigIdGetResponsesContentApplicationJsonSchemaMeta"},"modelConfig":{"$ref":"#/components/schemas/V1ModelUsageModelConfigIdGetResponsesContentApplicationJsonSchemaModelConfig"},"recentUsage":{"type":"array","items":{"$ref":"#/components/schemas/V1ModelUsageModelConfigIdGetResponsesContentApplicationJsonSchemaRecentUsageItems"}}},"required":["meta","modelConfig","recentUsage"],"title":"Model Usage_getModelUsageDetails_Response_200"},"V1ProductsGetParametersSort":{"type":"string","enum":["activity","name"],"title":"V1ProductsGetParametersSort"},"V1ProductsGetParametersView":{"type":"string","enum":["full","compact"],"description":"Response representation. `full` (default) preserves complete values; `compact` shortens every string value longer than 100 characters to a 100-character preview followed by `…`.","title":"V1ProductsGetParametersView"},"V1ProductsGetResponsesContentApplicationJsonSchemaDataItemsCapabilitiesItems":{"type":"object","properties":{"agentId":{"type":["string","null"]},"capabilityName":{"type":"string"},"flowId":{"type":["string","null"]}},"required":["agentId","capabilityName","flowId"],"title":"V1ProductsGetResponsesContentApplicationJsonSchemaDataItemsCapabilitiesItems"},"V1ProductsGetResponsesContentApplicationJsonSchemaDataItemsExternalSourceKind":{"type":"string","enum":["mcp","openapi","a2a"],"title":"V1ProductsGetResponsesContentApplicationJsonSchemaDataItemsExternalSourceKind"},"V1ProductsGetResponsesContentApplicationJsonSchemaDataItemsExternalSource":{"type":"object","properties":{"kind":{"$ref":"#/components/schemas/V1ProductsGetResponsesContentApplicationJsonSchemaDataItemsExternalSourceKind"},"savedServerName":{"type":"string","description":"The saved MCP connection the import signed in through"},"serverName":{"type":["string","null"]},"url":{"type":"string"}},"required":["kind","serverName","url"],"description":"What a Runs elsewhere product was imported from; null for any other product","title":"V1ProductsGetResponsesContentApplicationJsonSchemaDataItemsExternalSource"},"V1ProductsGetResponsesContentApplicationJsonSchemaDataItemsKind":{"type":"string","enum":["runtype","external","spec_only"],"description":"Derived on read: `external` (Runs elsewhere) for a product imported from a server it does not run, `spec_only` for one with no capability and no surface, otherwise `runtype`","title":"V1ProductsGetResponsesContentApplicationJsonSchemaDataItemsKind"},"V1ProductsGetResponsesContentApplicationJsonSchemaDataItemsSurfacesItems":{"type":"object","properties":{"name":{"type":"string"},"type":{"type":"string"}},"required":["name","type"],"title":"V1ProductsGetResponsesContentApplicationJsonSchemaDataItemsSurfacesItems"},"V1ProductsGetResponsesContentApplicationJsonSchemaDataItems":{"type":"object","properties":{"canvas":{"description":"Any type"},"capabilities":{"type":"array","items":{"$ref":"#/components/schemas/V1ProductsGetResponsesContentApplicationJsonSchemaDataItemsCapabilitiesItems"}},"capabilityCount":{"type":"integer"},"createdAt":{"type":"string"},"description":{"type":["string","null"]},"externalSource":{"oneOf":[{"$ref":"#/components/schemas/V1ProductsGetResponsesContentApplicationJsonSchemaDataItemsExternalSource"},{"type":"null"}],"description":"What a Runs elsewhere product was imported from; null for any other product"},"icon":{"type":["string","null"]},"id":{"type":"string"},"kind":{"$ref":"#/components/schemas/V1ProductsGetResponsesContentApplicationJsonSchemaDataItemsKind","description":"Derived on read: `external` (Runs elsewhere) for a product imported from a server it does not run, `spec_only` for one with no capability and no surface, otherwise `runtype`"},"name":{"type":"string"},"spec":{"description":"Any type"},"surfaceCount":{"type":"integer"},"surfaces":{"type":"array","items":{"$ref":"#/components/schemas/V1ProductsGetResponsesContentApplicationJsonSchemaDataItemsSurfacesItems"}},"updatedAt":{"type":"string"}},"required":["capabilities","capabilityCount","createdAt","description","externalSource","icon","id","kind","name","surfaceCount","surfaces","updatedAt"],"title":"V1ProductsGetResponsesContentApplicationJsonSchemaDataItems"},"Products_listProducts_Response_200":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1ProductsGetResponsesContentApplicationJsonSchemaDataItems"}},"pagination":{"$ref":"#/components/schemas/Pagination"}},"required":["data","pagination"],"title":"Products_listProducts_Response_200"},"V1ProductsPostRequestBodyContentApplicationJsonSchemaCanvasArchitectureLayout":{"type":"object","properties":{"x":{"type":"number","format":"double"},"y":{"type":"number","format":"double"}},"required":["x","y"],"title":"V1ProductsPostRequestBodyContentApplicationJsonSchemaCanvasArchitectureLayout"},"ProductCanvasBlock":{"type":"object","properties":{"addedAt":{"type":"string","description":"When the block was added; set by the server"},"addedByUserId":{"type":"string","description":"Who added the block (blocks people add only); set by the server"},"config":{"type":"object","additionalProperties":{"description":"Any type"},"description":"Block-owned settings; absent keeps the stored config"},"editedAt":{"type":"string","description":"When that save happened; set by the server"},"editedByUserId":{"type":"string","description":"Who last saved a change to what the block shows; set by the server"},"hidden":{"type":"boolean","description":"True hides the block; absent or false shows it"},"id":{"type":"string","minLength":1,"maxLength":100,"description":"Stable block id; comment anchors read `block:<id>`"},"kind":{"type":"string","minLength":1,"maxLength":64,"description":"Block kind, e.g. overview, get-started, docs, architecture, cost, recent-runs, notes"}},"required":["id","kind"],"title":"ProductCanvasBlock"},"V1ProductsPostRequestBodyContentApplicationJsonSchemaCanvasGroupsItemsPosition":{"type":"object","properties":{"x":{"type":"number","format":"double"},"y":{"type":"number","format":"double"}},"required":["x","y"],"title":"V1ProductsPostRequestBodyContentApplicationJsonSchemaCanvasGroupsItemsPosition"},"V1ProductsPostRequestBodyContentApplicationJsonSchemaCanvasGroupsItemsSize":{"type":"object","properties":{"height":{"type":"number","format":"double"},"width":{"type":"number","format":"double"}},"required":["height","width"],"title":"V1ProductsPostRequestBodyContentApplicationJsonSchemaCanvasGroupsItemsSize"},"V1ProductsPostRequestBodyContentApplicationJsonSchemaCanvasGroupsItemsType":{"type":"string","enum":["capabilities","surfaces"],"title":"V1ProductsPostRequestBodyContentApplicationJsonSchemaCanvasGroupsItemsType"},"V1ProductsPostRequestBodyContentApplicationJsonSchemaCanvasGroupsItems":{"type":"object","properties":{"color":{"type":"string"},"id":{"type":"string"},"memberIds":{"type":"array","items":{"type":"string"}},"name":{"type":"string"},"position":{"$ref":"#/components/schemas/V1ProductsPostRequestBodyContentApplicationJsonSchemaCanvasGroupsItemsPosition"},"size":{"$ref":"#/components/schemas/V1ProductsPostRequestBodyContentApplicationJsonSchemaCanvasGroupsItemsSize"},"type":{"$ref":"#/components/schemas/V1ProductsPostRequestBodyContentApplicationJsonSchemaCanvasGroupsItemsType"}},"required":["color","id","memberIds","name"],"title":"V1ProductsPostRequestBodyContentApplicationJsonSchemaCanvasGroupsItems"},"V1ProductsPostRequestBodyContentApplicationJsonSchemaCanvasNotesItems":{"type":"object","properties":{"color":{"type":"string"},"height":{"type":"number","format":"double"},"id":{"type":"string"},"text":{"type":"string"},"width":{"type":"number","format":"double"},"x":{"type":"number","format":"double"},"y":{"type":"number","format":"double"}},"required":["id","text","x","y"],"title":"V1ProductsPostRequestBodyContentApplicationJsonSchemaCanvasNotesItems"},"V1ProductsPostRequestBodyContentApplicationJsonSchemaCanvasQuickStartImportDocumentKind":{"type":"string","enum":["a2a-agent","fpo","fpo-template","mcp-server"],"title":"V1ProductsPostRequestBodyContentApplicationJsonSchemaCanvasQuickStartImportDocumentKind"},"V1ProductsPostRequestBodyContentApplicationJsonSchemaCanvasQuickStartImportSourceKind":{"type":"string","enum":["url","json"],"title":"V1ProductsPostRequestBodyContentApplicationJsonSchemaCanvasQuickStartImportSourceKind"},"V1ProductsPostRequestBodyContentApplicationJsonSchemaCanvasQuickStartImport":{"type":"object","properties":{"documentKind":{"$ref":"#/components/schemas/V1ProductsPostRequestBodyContentApplicationJsonSchemaCanvasQuickStartImportDocumentKind"},"importedAt":{"type":"string"},"normalizedSourceUrl":{"type":"string"},"savedServerName":{"type":"string"},"serverName":{"type":"string"},"sourceKind":{"$ref":"#/components/schemas/V1ProductsPostRequestBodyContentApplicationJsonSchemaCanvasQuickStartImportSourceKind"},"sourceUrl":{"type":"string"},"templateVariableKeys":{"type":"array","items":{"type":"string"}}},"required":["documentKind","importedAt","sourceKind"],"title":"V1ProductsPostRequestBodyContentApplicationJsonSchemaCanvasQuickStartImport"},"V1ProductsPostRequestBodyContentApplicationJsonSchemaCanvas":{"type":"object","properties":{"architectureLayout":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/V1ProductsPostRequestBodyContentApplicationJsonSchemaCanvasArchitectureLayout"}},"blocks":{"type":"array","items":{"$ref":"#/components/schemas/ProductCanvasBlock"},"description":"Product Canvas blocks in page order. Entries merge with the stored ones by id; stored entries the request leaves out are kept after the sent ones. Saving the description or stack stamps the overview block, saving the linked docs stamps the docs block, and a changed config stamps its own block."},"capabilityOrder":{"type":"array","items":{"type":"string"}},"capabilityPositions":{"type":"object","additionalProperties":{"type":"number","format":"double"}},"groups":{"type":"array","items":{"$ref":"#/components/schemas/V1ProductsPostRequestBodyContentApplicationJsonSchemaCanvasGroupsItems"}},"notes":{"type":"array","items":{"$ref":"#/components/schemas/V1ProductsPostRequestBodyContentApplicationJsonSchemaCanvasNotesItems"}},"onboardingProgress":{"type":"object","additionalProperties":{"type":"object","additionalProperties":{"description":"Any type"}}},"quickStartImport":{"$ref":"#/components/schemas/V1ProductsPostRequestBodyContentApplicationJsonSchemaCanvasQuickStartImport"},"surfaceOrder":{"type":"array","items":{"type":"string"}},"surfacePositions":{"type":"object","additionalProperties":{"type":"number","format":"double"}},"templateId":{"type":"string"}},"title":"V1ProductsPostRequestBodyContentApplicationJsonSchemaCanvas"},"V1ProductsPostRequestBodyContentApplicationJsonSchemaSpecImportedFromSource":{"type":"string","enum":["github","linear","chatprd","manual"],"title":"V1ProductsPostRequestBodyContentApplicationJsonSchemaSpecImportedFromSource"},"V1ProductsPostRequestBodyContentApplicationJsonSchemaSpecImportedFrom":{"type":"object","properties":{"importedAt":{"type":"string"},"source":{"$ref":"#/components/schemas/V1ProductsPostRequestBodyContentApplicationJsonSchemaSpecImportedFromSource"},"sourceId":{"type":"string"},"syncEnabled":{"type":"boolean"}},"required":["importedAt","source"],"title":"V1ProductsPostRequestBodyContentApplicationJsonSchemaSpecImportedFrom"},"V1ProductsPostRequestBodyContentApplicationJsonSchemaSpecInternalDocsResourcesItems":{"type":"object","properties":{"addedAt":{"type":"string"},"addedByUserId":{"type":"string"},"content":{"type":"string"},"source":{"type":"string"},"title":{"type":"string","minLength":1},"type":{"type":"string","minLength":1},"url":{"type":"string"}},"required":["title","type"],"title":"V1ProductsPostRequestBodyContentApplicationJsonSchemaSpecInternalDocsResourcesItems"},"V1ProductsPostRequestBodyContentApplicationJsonSchemaSpecInternalDocs":{"type":"object","properties":{"content":{"type":"string"},"resources":{"type":"array","items":{"$ref":"#/components/schemas/V1ProductsPostRequestBodyContentApplicationJsonSchemaSpecInternalDocsResourcesItems"}},"tags":{"type":"array","items":{"type":"string"}}},"title":"V1ProductsPostRequestBodyContentApplicationJsonSchemaSpecInternalDocs"},"V1ProductsPostRequestBodyContentApplicationJsonSchemaSpecProductStage":{"type":"string","enum":["idea","prototype","beta","production","scaling"],"title":"V1ProductsPostRequestBodyContentApplicationJsonSchemaSpecProductStage"},"ProductStackItem":{"type":"object","properties":{"category":{"type":"string","maxLength":100},"key":{"type":"string","minLength":1,"maxLength":200,"description":"Stable chip key, e.g. model:claude-sonnet-5 or custom:inngest"},"label":{"type":"string","minLength":1,"maxLength":200},"mark":{"type":"string","maxLength":100,"description":"Brand or provider mark id the dashboard draws"},"url":{"type":"string","maxLength":2048},"version":{"type":"string","maxLength":100},"where":{"type":"string","maxLength":500,"description":"Where a detected item was found"}},"required":["key","label"],"title":"ProductStackItem"},"ProductDeclaredStack":{"type":"object","properties":{"actorLabel":{"type":"string"},"actorUserId":{"type":"string"},"declaredAt":{"type":"string"},"items":{"type":"array","items":{"$ref":"#/components/schemas/ProductStackItem"}}},"required":["actorLabel","declaredAt","items"],"title":"ProductDeclaredStack"},"ProductStackDeclared":{"type":"object","properties":{"api":{"$ref":"#/components/schemas/ProductDeclaredStack"},"cli":{"$ref":"#/components/schemas/ProductDeclaredStack"},"mcp":{"$ref":"#/components/schemas/ProductDeclaredStack"}},"description":"The last declaration from each source; a product save keeps it as stored","title":"ProductStackDeclared"},"ProductStackDetected":{"type":"object","properties":{"derivedAt":{"type":"string"},"items":{"type":"array","items":{"$ref":"#/components/schemas/ProductStackItem"}}},"required":["derivedAt","items"],"description":"What the last detection derived; a product save keeps it as stored","title":"ProductStackDetected"},"ProductStack":{"type":"object","properties":{"declared":{"$ref":"#/components/schemas/ProductStackDeclared","description":"The last declaration from each source; a product save keeps it as stored"},"detected":{"$ref":"#/components/schemas/ProductStackDetected","description":"What the last detection derived; a product save keeps it as stored"},"hidden":{"type":"array","items":{"type":"string","minLength":1,"maxLength":200},"description":"Keys of detected or declared chips people hid; replaces the stored list"},"hiddenAt":{"type":"object","additionalProperties":{"type":"string"},"description":"When each hidden key was hidden; set by the server"},"manual":{"type":"array","items":{"$ref":"#/components/schemas/ProductStackItem"},"description":"Chips people added by hand; replaces the stored list"}},"description":"The Overview's stack. The legacy techStack buckets are separate and unchanged.","title":"ProductStack"},"V1ProductsPostRequestBodyContentApplicationJsonSchemaSpecTechStack":{"type":"object","properties":{"backend":{"type":"array","items":{"type":"string"}},"database":{"type":"array","items":{"type":"string"}},"frontend":{"type":"array","items":{"type":"string"}},"infrastructure":{"type":"array","items":{"type":"string"}},"languages":{"type":"array","items":{"type":"string"}}},"title":"V1ProductsPostRequestBodyContentApplicationJsonSchemaSpecTechStack"},"V1ProductsPostRequestBodyContentApplicationJsonSchemaSpec":{"type":"object","properties":{"aiUseCases":{"type":"array","items":{"type":"string"}},"complianceNeeds":{"type":"array","items":{"type":"string"}},"dataSourceTypes":{"type":"array","items":{"type":"string"}},"deploymentTargets":{"type":"array","items":{"type":"string"}},"existingTools":{"type":"array","items":{"type":"string"}},"importedFrom":{"$ref":"#/components/schemas/V1ProductsPostRequestBodyContentApplicationJsonSchemaSpecImportedFrom"},"internalDocs":{"oneOf":[{"$ref":"#/components/schemas/V1ProductsPostRequestBodyContentApplicationJsonSchemaSpecInternalDocs"},{"type":"null"}]},"preferredModels":{"type":"array","items":{"type":"string"}},"productGoal":{"type":"string"},"productStage":{"$ref":"#/components/schemas/V1ProductsPostRequestBodyContentApplicationJsonSchemaSpecProductStage"},"stack":{"$ref":"#/components/schemas/ProductStack"},"targetAudience":{"type":"string"},"techStack":{"$ref":"#/components/schemas/V1ProductsPostRequestBodyContentApplicationJsonSchemaSpecTechStack"}},"title":"V1ProductsPostRequestBodyContentApplicationJsonSchemaSpec"},"V1ProductsPostResponsesContentApplicationJsonSchemaTestApiKeyLimits":{"type":"object","properties":{"dailyExecutions":{"type":"integer"},"lifetimeExecutions":{"type":"integer"}},"required":["dailyExecutions","lifetimeExecutions"],"title":"V1ProductsPostResponsesContentApplicationJsonSchemaTestApiKeyLimits"},"V1ProductsPostResponsesContentApplicationJsonSchemaTestApiKey":{"type":"object","properties":{"canRevealLater":{"type":"boolean"},"id":{"type":"string"},"key":{"type":"string"},"limits":{"$ref":"#/components/schemas/V1ProductsPostResponsesContentApplicationJsonSchemaTestApiKeyLimits"},"name":{"type":"string"},"prefix":{"type":"string"}},"required":["canRevealLater","id","key","limits","name","prefix"],"title":"V1ProductsPostResponsesContentApplicationJsonSchemaTestApiKey"},"Products_createProduct_Response_201":{"type":"object","properties":{"canvas":{"type":"object","additionalProperties":{"description":"Any type"}},"capabilities":{"type":"array","items":{"description":"Any type"}},"createdAt":{"type":"string"},"dashboardUrl":{"type":"string"},"description":{"type":["string","null"]},"icon":{"type":["string","null"]},"id":{"type":"string"},"name":{"type":"string"},"spec":{"type":"object","additionalProperties":{"description":"Any type"}},"surfaces":{"type":"array","items":{"description":"Any type"}},"testApiKey":{"$ref":"#/components/schemas/V1ProductsPostResponsesContentApplicationJsonSchemaTestApiKey"},"updatedAt":{"type":"string"}},"required":["canvas","capabilities","createdAt","description","icon","id","name","spec","surfaces","updatedAt"],"title":"Products_createProduct_Response_201"},"V1ProductsAssemblePostResponsesContentApplicationJsonSchemaCapabilitiesItems":{"type":"object","properties":{"agentId":{"type":"string"},"capabilityId":{"type":"string"},"flowId":{"type":"string"},"name":{"type":"string"}},"required":["capabilityId","name"],"title":"V1ProductsAssemblePostResponsesContentApplicationJsonSchemaCapabilitiesItems"},"V1ProductsAssemblePostResponsesContentApplicationJsonSchemaSurfacesItems":{"type":"object","properties":{"integrationId":{"type":"string"},"name":{"type":"string"},"surfaceId":{"type":"string"},"surfaceItemIds":{"type":"array","items":{"type":"string"}},"type":{"type":"string"}},"required":["name","surfaceId","surfaceItemIds","type"],"title":"V1ProductsAssemblePostResponsesContentApplicationJsonSchemaSurfacesItems"},"Products_assembleProductFromFpo_Response_201":{"type":"object","properties":{"cached":{"type":"boolean"},"capabilities":{"type":"array","items":{"$ref":"#/components/schemas/V1ProductsAssemblePostResponsesContentApplicationJsonSchemaCapabilitiesItems"}},"creationMap":{"type":"object","additionalProperties":{"type":"string"}},"productId":{"type":"string"},"surfaces":{"type":"array","items":{"$ref":"#/components/schemas/V1ProductsAssemblePostResponsesContentApplicationJsonSchemaSurfacesItems"}},"warnings":{"type":"array","items":{"type":"string"},"description":"Non-fatal advisories, e.g. a remapped deprecated field or seed data skipped because an existing enforce collection outside the FPO refuses it."}},"required":["cached","capabilities","creationMap","productId","surfaces"],"title":"Products_assembleProductFromFpo_Response_201"},"V1ProductsAssemblePostResponsesContentApplicationJsonSchemaError":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"],"title":"V1ProductsAssemblePostResponsesContentApplicationJsonSchemaError"},"AssembleProductFromFpoRequestBadRequestError":{"type":"object","properties":{"error":{"$ref":"#/components/schemas/V1ProductsAssemblePostResponsesContentApplicationJsonSchemaError"}},"required":["error"],"title":"AssembleProductFromFpoRequestBadRequestError"},"AssembleProductFromFpoRequestForbiddenError":{"type":"object","properties":{"error":{"$ref":"#/components/schemas/V1ProductsAssemblePostResponsesContentApplicationJsonSchemaError"}},"required":["error"],"title":"AssembleProductFromFpoRequestForbiddenError"},"AssembleProductFromFpoRequestInternalServerError":{"type":"object","properties":{"error":{"$ref":"#/components/schemas/V1ProductsAssemblePostResponsesContentApplicationJsonSchemaError"}},"required":["error"],"title":"AssembleProductFromFpoRequestInternalServerError"},"V1ProductsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionSpecImportedFromSource":{"type":"string","enum":["github","linear","chatprd","manual"],"title":"V1ProductsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionSpecImportedFromSource"},"V1ProductsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionSpecImportedFrom":{"type":"object","properties":{"importedAt":{"type":"string"},"source":{"$ref":"#/components/schemas/V1ProductsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionSpecImportedFromSource"},"sourceId":{"type":"string"},"syncEnabled":{"type":"boolean"}},"required":["importedAt","source"],"title":"V1ProductsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionSpecImportedFrom"},"V1ProductsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionSpecInternalDocsResourcesItems":{"type":"object","properties":{"addedAt":{"type":"string"},"addedByUserId":{"type":"string"},"content":{"type":"string"},"source":{"type":"string"},"title":{"type":"string","minLength":1},"type":{"type":"string","minLength":1},"url":{"type":"string"}},"required":["title","type"],"title":"V1ProductsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionSpecInternalDocsResourcesItems"},"V1ProductsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionSpecInternalDocs":{"type":"object","properties":{"content":{"type":"string"},"resources":{"type":"array","items":{"$ref":"#/components/schemas/V1ProductsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionSpecInternalDocsResourcesItems"}},"tags":{"type":"array","items":{"type":"string"}}},"title":"V1ProductsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionSpecInternalDocs"},"V1ProductsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionSpecLoggingPolicy":{"type":"string","enum":["default","on","off"],"title":"V1ProductsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionSpecLoggingPolicy"},"V1ProductsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionSpecProductStage":{"type":"string","enum":["idea","prototype","beta","production","scaling"],"title":"V1ProductsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionSpecProductStage"},"V1ProductsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionSpecTechStack":{"type":"object","properties":{"backend":{"type":"array","items":{"type":"string"}},"database":{"type":"array","items":{"type":"string"}},"frontend":{"type":"array","items":{"type":"string"}},"infrastructure":{"type":"array","items":{"type":"string"}},"languages":{"type":"array","items":{"type":"string"}}},"title":"V1ProductsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionSpecTechStack"},"V1ProductsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionSpec":{"type":"object","properties":{"aiUseCases":{"type":"array","items":{"type":"string"}},"complianceNeeds":{"type":"array","items":{"type":"string"}},"dataSourceTypes":{"type":"array","items":{"type":"string"}},"deploymentTargets":{"type":"array","items":{"type":"string"}},"existingTools":{"type":"array","items":{"type":"string"}},"importedFrom":{"$ref":"#/components/schemas/V1ProductsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionSpecImportedFrom"},"internalDocs":{"oneOf":[{"$ref":"#/components/schemas/V1ProductsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionSpecInternalDocs"},{"type":"null"}]},"loggingPolicy":{"$ref":"#/components/schemas/V1ProductsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionSpecLoggingPolicy"},"preferredModels":{"type":"array","items":{"type":"string"}},"productGoal":{"type":"string"},"productStage":{"$ref":"#/components/schemas/V1ProductsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionSpecProductStage"},"stack":{"$ref":"#/components/schemas/ProductStack"},"targetAudience":{"type":"string"},"techStack":{"$ref":"#/components/schemas/V1ProductsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionSpecTechStack"}},"title":"V1ProductsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionSpec"},"V1ProductsEnsurePostRequestBodyContentApplicationJsonSchemaDefinition":{"type":"object","properties":{"description":{"type":["string","null"]},"icon":{"type":["string","null"],"maxLength":50},"name":{"type":"string","minLength":1,"maxLength":255},"spec":{"$ref":"#/components/schemas/V1ProductsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionSpec"}},"required":["name"],"title":"V1ProductsEnsurePostRequestBodyContentApplicationJsonSchemaDefinition"},"V1ProductsEnsurePostRequestBodyContentApplicationJsonSchemaOnConflict":{"type":"string","enum":["error","overwrite"],"title":"V1ProductsEnsurePostRequestBodyContentApplicationJsonSchemaOnConflict"},"ProductEnsureResponseOneOf0Result":{"type":"string","enum":["unchanged","created","updated"],"title":"ProductEnsureResponseOneOf0Result"},"ProductEnsureResponse0":{"type":"object","properties":{"contentHash":{"type":"string","description":"Server-computed canonical content hash. Clients should echo this hash in probes."},"productId":{"type":"string"},"result":{"$ref":"#/components/schemas/ProductEnsureResponseOneOf0Result"}},"required":["contentHash","productId","result"],"title":"ProductEnsureResponse0"},"ProductEnsureResponseOneOf1Result":{"type":"string","enum":["definitionRequired"],"title":"ProductEnsureResponseOneOf1Result"},"ProductEnsureResponse1":{"type":"object","properties":{"result":{"$ref":"#/components/schemas/ProductEnsureResponseOneOf1Result"}},"required":["result"],"title":"ProductEnsureResponse1"},"ProductEnsureResponseOneOf2Changes":{"type":"string","enum":["none","create","update"],"title":"ProductEnsureResponseOneOf2Changes"},"ProductEnsureResponseOneOf2Result":{"type":"string","enum":["plan"],"title":"ProductEnsureResponseOneOf2Result"},"ProductEnsureResponse2":{"type":"object","properties":{"changedKeys":{"type":"array","items":{"type":"string"}},"changes":{"$ref":"#/components/schemas/ProductEnsureResponseOneOf2Changes"},"contentHash":{"type":"string"},"productId":{"type":"string"},"remoteHash":{"type":"string"},"result":{"$ref":"#/components/schemas/ProductEnsureResponseOneOf2Result"}},"required":["changedKeys","changes","contentHash","result"],"title":"ProductEnsureResponse2"},"ProductEnsureResponse":{"oneOf":[{"$ref":"#/components/schemas/ProductEnsureResponse0"},{"$ref":"#/components/schemas/ProductEnsureResponse1"},{"$ref":"#/components/schemas/ProductEnsureResponse2"}],"title":"ProductEnsureResponse"},"ProductEnsureConflictCode":{"type":"string","enum":["external_modification","remote_changed"],"title":"ProductEnsureConflictCode"},"ProductEnsureConflict":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/ProductEnsureConflictCode"},"currentHash":{"type":["string","null"]},"error":{"type":"string"},"lastModifiedSource":{"type":"string"},"modifiedAt":{"type":["string","null"]}},"required":["code","error"],"title":"ProductEnsureConflict"},"ProductEnsureHashMismatchCode":{"type":"string","enum":["content_hash_mismatch"],"title":"ProductEnsureHashMismatchCode"},"ProductEnsureHashMismatch":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/ProductEnsureHashMismatchCode"},"contentHash":{"type":"string","description":"The server-computed canonical hash of the submitted definition."},"error":{"type":"string"}},"required":["code","contentHash","error"],"title":"ProductEnsureHashMismatch"},"V1ProductsEnsureFpoPostRequestBodyContentApplicationJsonSchemaOnConflict":{"type":"string","enum":["error","overwrite"],"description":"Per nested entity: \"overwrite\" converges over dashboard/API edits.","title":"V1ProductsEnsureFpoPostRequestBodyContentApplicationJsonSchemaOnConflict"},"V1ProductsEnsureFpoPostRequestBodyContentApplicationJsonSchemaRelease":{"type":"string","enum":["none","publish"],"description":"Whether converged capability agents and flows go live. Defaults to \"publish\": an agent or flow whose converged content is not yet live is versioned and published (the agent's `live` alias moves to that version), matching product creation. \"none\" saves changes as drafts and leaves `live` where it was. Publishing needs update authority over that entity kind, and for an agent the live deploy scope (AGENTS:DEPLOY:LIVE; AGENTS:WRITE or AGENTS:UPDATE also accepted); an API key without it converges that kind as \"none\".","title":"V1ProductsEnsureFpoPostRequestBodyContentApplicationJsonSchemaRelease"},"ProductFpoEnsureResponseOneOf0EntitiesItemsKind":{"type":"string","enum":["product","flow","agent","capability","tool","surface","record","schedule","eval","skill","collection","questionSet"],"title":"ProductFpoEnsureResponseOneOf0EntitiesItemsKind"},"ProductFpoEnsureResponseOneOf0EntitiesItemsResult":{"type":"string","enum":["created","updated","unchanged","failed","skipped","pruned"],"title":"ProductFpoEnsureResponseOneOf0EntitiesItemsResult"},"ProductFpoEnsureResponseOneOf0EntitiesItems":{"type":"object","properties":{"error":{"type":"string"},"id":{"type":"string","description":"Resulting platform id (absent on failure/skip/pruned)."},"kind":{"$ref":"#/components/schemas/ProductFpoEnsureResponseOneOf0EntitiesItemsKind"},"name":{"type":"string"},"ref":{"type":"string","description":"The FPO-local ref (capability id / entity name) for correlation."},"result":{"$ref":"#/components/schemas/ProductFpoEnsureResponseOneOf0EntitiesItemsResult"},"sessionsSignedOut":{"type":"integer","description":"Surface apply only: the signed-in sessions an identity provider or issuer change ended."},"signsOutSessions":{"type":"boolean","description":"Surface dryRun only: applying it changes the identity provider or issuer and signs out every session."},"warnings":{"type":"array","items":{"type":"string"},"description":"Non-blocking advisories, e.g. SCHEDULE_AGENT_CONFIG_UNSUPPORTED when converging an agent moved `live` onto a version its active schedules cannot run."}},"required":["kind","name","ref","result"],"title":"ProductFpoEnsureResponseOneOf0EntitiesItems"},"ProductFpoEnsureResponseOneOf0Result":{"type":"string","enum":["unchanged","converged","plan"],"description":"`unchanged` when every entity was unchanged (a matching hash-only probe reports no entities), `converged` when at least one was created/updated, `plan` for dryRun.","title":"ProductFpoEnsureResponseOneOf0Result"},"ProductFpoEnsureResponse0":{"type":"object","properties":{"contentHash":{"type":"string","description":"Server-computed canonical whole-FPO content hash."},"entities":{"type":"array","items":{"$ref":"#/components/schemas/ProductFpoEnsureResponseOneOf0EntitiesItems"}},"hasFailures":{"type":"boolean","description":"True when one or more entities failed to converge (re-run to self-heal)."},"productId":{"type":"string"},"remoteHash":{"type":"string","description":"dryRun only: the live graph's pull-fpo hash, absent when the product does not exist or the caller cannot read every section. Pass it back as expectedRemoteHash to guard the apply."},"result":{"$ref":"#/components/schemas/ProductFpoEnsureResponseOneOf0Result","description":"`unchanged` when every entity was unchanged (a matching hash-only probe reports no entities), `converged` when at least one was created/updated, `plan` for dryRun."}},"required":["contentHash","entities","hasFailures","result"],"title":"ProductFpoEnsureResponse0"},"ProductFpoEnsureResponseOneOf1Result":{"type":"string","enum":["definitionRequired"],"title":"ProductFpoEnsureResponseOneOf1Result"},"ProductFpoEnsureResponse1":{"type":"object","properties":{"result":{"$ref":"#/components/schemas/ProductFpoEnsureResponseOneOf1Result"}},"required":["result"],"title":"ProductFpoEnsureResponse1"},"ProductFpoEnsureResponse":{"oneOf":[{"$ref":"#/components/schemas/ProductFpoEnsureResponse0"},{"$ref":"#/components/schemas/ProductFpoEnsureResponse1"}],"title":"ProductFpoEnsureResponse"},"ProductPullResponseDefinitionSpecImportedFromSource":{"type":"string","enum":["github","linear","chatprd","manual"],"title":"ProductPullResponseDefinitionSpecImportedFromSource"},"ProductPullResponseDefinitionSpecImportedFrom":{"type":"object","properties":{"importedAt":{"type":"string"},"source":{"$ref":"#/components/schemas/ProductPullResponseDefinitionSpecImportedFromSource"},"sourceId":{"type":"string"},"syncEnabled":{"type":"boolean"}},"required":["importedAt","source"],"title":"ProductPullResponseDefinitionSpecImportedFrom"},"ProductPullResponseDefinitionSpecInternalDocsResourcesItems":{"type":"object","properties":{"addedAt":{"type":"string"},"addedByUserId":{"type":"string"},"content":{"type":"string"},"source":{"type":"string"},"title":{"type":"string","minLength":1},"type":{"type":"string","minLength":1},"url":{"type":"string"}},"required":["title","type"],"title":"ProductPullResponseDefinitionSpecInternalDocsResourcesItems"},"ProductPullResponseDefinitionSpecInternalDocs":{"type":"object","properties":{"content":{"type":"string"},"resources":{"type":"array","items":{"$ref":"#/components/schemas/ProductPullResponseDefinitionSpecInternalDocsResourcesItems"}},"tags":{"type":"array","items":{"type":"string"}}},"title":"ProductPullResponseDefinitionSpecInternalDocs"},"ProductPullResponseDefinitionSpecLoggingPolicy":{"type":"string","enum":["default","on","off"],"title":"ProductPullResponseDefinitionSpecLoggingPolicy"},"ProductPullResponseDefinitionSpecProductStage":{"type":"string","enum":["idea","prototype","beta","production","scaling"],"title":"ProductPullResponseDefinitionSpecProductStage"},"ProductPullResponseDefinitionSpecTechStack":{"type":"object","properties":{"backend":{"type":"array","items":{"type":"string"}},"database":{"type":"array","items":{"type":"string"}},"frontend":{"type":"array","items":{"type":"string"}},"infrastructure":{"type":"array","items":{"type":"string"}},"languages":{"type":"array","items":{"type":"string"}}},"title":"ProductPullResponseDefinitionSpecTechStack"},"ProductPullResponseDefinitionSpec":{"type":"object","properties":{"aiUseCases":{"type":"array","items":{"type":"string"}},"complianceNeeds":{"type":"array","items":{"type":"string"}},"dataSourceTypes":{"type":"array","items":{"type":"string"}},"deploymentTargets":{"type":"array","items":{"type":"string"}},"existingTools":{"type":"array","items":{"type":"string"}},"importedFrom":{"$ref":"#/components/schemas/ProductPullResponseDefinitionSpecImportedFrom"},"internalDocs":{"oneOf":[{"$ref":"#/components/schemas/ProductPullResponseDefinitionSpecInternalDocs"},{"type":"null"}]},"loggingPolicy":{"$ref":"#/components/schemas/ProductPullResponseDefinitionSpecLoggingPolicy"},"preferredModels":{"type":"array","items":{"type":"string"}},"productGoal":{"type":"string"},"productStage":{"$ref":"#/components/schemas/ProductPullResponseDefinitionSpecProductStage"},"stack":{"$ref":"#/components/schemas/ProductStack"},"targetAudience":{"type":"string"},"techStack":{"$ref":"#/components/schemas/ProductPullResponseDefinitionSpecTechStack"}},"title":"ProductPullResponseDefinitionSpec"},"ProductPullResponseDefinition":{"type":"object","properties":{"description":{"type":["string","null"]},"icon":{"type":["string","null"],"maxLength":50},"name":{"type":"string","minLength":1,"maxLength":255},"spec":{"$ref":"#/components/schemas/ProductPullResponseDefinitionSpec"}},"required":["name"],"title":"ProductPullResponseDefinition"},"ProductPullResponse":{"type":"object","properties":{"contentHash":{"type":"string"},"definition":{"$ref":"#/components/schemas/ProductPullResponseDefinition"},"lastModifiedSource":{"type":["string","null"]},"productId":{"type":"string"},"updatedAt":{"type":["string","null"]}},"required":["contentHash","definition","lastModifiedSource","productId","updatedAt"],"title":"ProductPullResponse"},"ProductFpoPullResponse":{"type":"object","properties":{"contentHash":{"type":"string","description":"Server-computed canonical whole-FPO content hash."},"fpo":{"type":"object","additionalProperties":{"description":"Any type"},"description":"A self-contained Full Product Object reconstructed from the live graph. Feeding it back into POST /products/ensure-fpo converges to `unchanged`. records/schedules/secrets are not reconstructed (see `warnings`); tool refs are emitted as portable `tool:<name>`."},"productId":{"type":"string"},"warnings":{"type":"array","items":{"type":"string"},"description":"Reconstruction caveats (omitted entities, unrepresentable rows)."}},"required":["contentHash","fpo","productId"],"title":"ProductFpoPullResponse"},"V1ProductsIdGetResponsesContentApplicationJsonSchemaEditorContextFlowStepsMapItems":{"type":"object","properties":{"id":{"type":"string","description":"The stored step id, stable across reorders; absent when the step has none"},"name":{"type":"string"},"type":{"type":"string"}},"required":["name","type"],"title":"V1ProductsIdGetResponsesContentApplicationJsonSchemaEditorContextFlowStepsMapItems"},"V1ProductsIdGetResponsesContentApplicationJsonSchemaEditorContext":{"type":"object","properties":{"agentConfigMap":{"type":"object","additionalProperties":{"description":"Any type"}},"flowStepsMap":{"type":"object","additionalProperties":{"type":"array","items":{"$ref":"#/components/schemas/V1ProductsIdGetResponsesContentApplicationJsonSchemaEditorContextFlowStepsMapItems"}}},"publishedVersionIds":{"type":"object","additionalProperties":{"type":["string","null"]},"description":"Published version id per capability flow or agent id; null when never published"},"publishedVersionNumbers":{"type":"object","additionalProperties":{"type":["integer","null"]},"description":"The live version number per capability flow or agent id (a flow reads its saved number), as `Live · vN` names it; null when never published"},"recordTypesByFlow":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}},"description":"Record types each capability flow writes or reads, from the literal recordType of its record steps"},"resourceNames":{"type":"object","additionalProperties":{"type":"string"},"description":"Display name per capability flow or agent id"},"toolIdsByAgent":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}},"description":"Tool ids from each capability agent config (tools.toolIds)"},"toolIdsByFlow":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}},"description":"Tool ids attached to the prompt steps of each capability flow"}},"required":["agentConfigMap","flowStepsMap"],"title":"V1ProductsIdGetResponsesContentApplicationJsonSchemaEditorContext"},"V1ProductsIdGetResponsesContentApplicationJsonSchemaExternalSourceKind":{"type":"string","enum":["mcp","openapi","a2a"],"title":"V1ProductsIdGetResponsesContentApplicationJsonSchemaExternalSourceKind"},"V1ProductsIdGetResponsesContentApplicationJsonSchemaExternalSource":{"type":"object","properties":{"kind":{"$ref":"#/components/schemas/V1ProductsIdGetResponsesContentApplicationJsonSchemaExternalSourceKind"},"savedServerName":{"type":"string","description":"The saved MCP connection the import signed in through"},"serverName":{"type":["string","null"]},"url":{"type":"string"}},"required":["kind","serverName","url"],"description":"What a Runs elsewhere product was imported from; null for any other product","title":"V1ProductsIdGetResponsesContentApplicationJsonSchemaExternalSource"},"V1ProductsIdGetResponsesContentApplicationJsonSchemaKind":{"type":"string","enum":["runtype","external","spec_only"],"description":"Derived on read: `external` (Runs elsewhere) for a product imported from a server it does not run, `spec_only` for one with no capability and no surface, otherwise `runtype`","title":"V1ProductsIdGetResponsesContentApplicationJsonSchemaKind"},"Products_getProductDetails_Response_200":{"type":"object","properties":{"canvas":{"description":"Any type"},"capabilities":{"type":"array","items":{"description":"Any type"}},"configurationStatus":{"description":"Any type"},"configurationUrl":{"type":["string","null"]},"createdAt":{"type":"string"},"createdByUserId":{"type":["string","null"],"description":"Who created the product; attribution only, never who owns or runs it (the organization does)"},"dashboardUrl":{"type":"string"},"description":{"type":["string","null"]},"editorContext":{"$ref":"#/components/schemas/V1ProductsIdGetResponsesContentApplicationJsonSchemaEditorContext"},"externalSource":{"oneOf":[{"$ref":"#/components/schemas/V1ProductsIdGetResponsesContentApplicationJsonSchemaExternalSource"},{"type":"null"}],"description":"What a Runs elsewhere product was imported from; null for any other product"},"icon":{"type":["string","null"]},"id":{"type":"string"},"kind":{"$ref":"#/components/schemas/V1ProductsIdGetResponsesContentApplicationJsonSchemaKind","description":"Derived on read: `external` (Runs elsewhere) for a product imported from a server it does not run, `spec_only` for one with no capability and no surface, otherwise `runtype`"},"name":{"type":"string"},"pendingConfigurationCount":{"type":"integer"},"spec":{"description":"Any type"},"surfaces":{"type":"array","items":{"description":"Any type"}},"updatedAt":{"type":"string"}},"required":["capabilities","createdAt","createdByUserId","description","externalSource","icon","id","kind","name","surfaces","updatedAt"],"title":"Products_getProductDetails_Response_200"},"V1ProductsIdPutRequestBodyContentApplicationJsonSchemaCanvasArchitectureLayout":{"type":"object","properties":{"x":{"type":"number","format":"double"},"y":{"type":"number","format":"double"}},"required":["x","y"],"title":"V1ProductsIdPutRequestBodyContentApplicationJsonSchemaCanvasArchitectureLayout"},"V1ProductsIdPutRequestBodyContentApplicationJsonSchemaCanvasGroupsItemsPosition":{"type":"object","properties":{"x":{"type":"number","format":"double"},"y":{"type":"number","format":"double"}},"required":["x","y"],"title":"V1ProductsIdPutRequestBodyContentApplicationJsonSchemaCanvasGroupsItemsPosition"},"V1ProductsIdPutRequestBodyContentApplicationJsonSchemaCanvasGroupsItemsSize":{"type":"object","properties":{"height":{"type":"number","format":"double"},"width":{"type":"number","format":"double"}},"required":["height","width"],"title":"V1ProductsIdPutRequestBodyContentApplicationJsonSchemaCanvasGroupsItemsSize"},"V1ProductsIdPutRequestBodyContentApplicationJsonSchemaCanvasGroupsItemsType":{"type":"string","enum":["capabilities","surfaces"],"title":"V1ProductsIdPutRequestBodyContentApplicationJsonSchemaCanvasGroupsItemsType"},"V1ProductsIdPutRequestBodyContentApplicationJsonSchemaCanvasGroupsItems":{"type":"object","properties":{"color":{"type":"string"},"id":{"type":"string"},"memberIds":{"type":"array","items":{"type":"string"}},"name":{"type":"string"},"position":{"$ref":"#/components/schemas/V1ProductsIdPutRequestBodyContentApplicationJsonSchemaCanvasGroupsItemsPosition"},"size":{"$ref":"#/components/schemas/V1ProductsIdPutRequestBodyContentApplicationJsonSchemaCanvasGroupsItemsSize"},"type":{"$ref":"#/components/schemas/V1ProductsIdPutRequestBodyContentApplicationJsonSchemaCanvasGroupsItemsType"}},"required":["color","id","memberIds","name"],"title":"V1ProductsIdPutRequestBodyContentApplicationJsonSchemaCanvasGroupsItems"},"V1ProductsIdPutRequestBodyContentApplicationJsonSchemaCanvasNotesItems":{"type":"object","properties":{"color":{"type":"string"},"height":{"type":"number","format":"double"},"id":{"type":"string"},"text":{"type":"string"},"width":{"type":"number","format":"double"},"x":{"type":"number","format":"double"},"y":{"type":"number","format":"double"}},"required":["id","text","x","y"],"title":"V1ProductsIdPutRequestBodyContentApplicationJsonSchemaCanvasNotesItems"},"V1ProductsIdPutRequestBodyContentApplicationJsonSchemaCanvasQuickStartImportDocumentKind":{"type":"string","enum":["a2a-agent","fpo","fpo-template","mcp-server"],"title":"V1ProductsIdPutRequestBodyContentApplicationJsonSchemaCanvasQuickStartImportDocumentKind"},"V1ProductsIdPutRequestBodyContentApplicationJsonSchemaCanvasQuickStartImportSourceKind":{"type":"string","enum":["url","json"],"title":"V1ProductsIdPutRequestBodyContentApplicationJsonSchemaCanvasQuickStartImportSourceKind"},"V1ProductsIdPutRequestBodyContentApplicationJsonSchemaCanvasQuickStartImport":{"type":"object","properties":{"documentKind":{"$ref":"#/components/schemas/V1ProductsIdPutRequestBodyContentApplicationJsonSchemaCanvasQuickStartImportDocumentKind"},"importedAt":{"type":"string"},"normalizedSourceUrl":{"type":"string"},"savedServerName":{"type":"string"},"serverName":{"type":"string"},"sourceKind":{"$ref":"#/components/schemas/V1ProductsIdPutRequestBodyContentApplicationJsonSchemaCanvasQuickStartImportSourceKind"},"sourceUrl":{"type":"string"},"templateVariableKeys":{"type":"array","items":{"type":"string"}}},"required":["documentKind","importedAt","sourceKind"],"title":"V1ProductsIdPutRequestBodyContentApplicationJsonSchemaCanvasQuickStartImport"},"V1ProductsIdPutRequestBodyContentApplicationJsonSchemaCanvas":{"type":"object","properties":{"architectureLayout":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/V1ProductsIdPutRequestBodyContentApplicationJsonSchemaCanvasArchitectureLayout"}},"blocks":{"type":"array","items":{"$ref":"#/components/schemas/ProductCanvasBlock"},"description":"Product Canvas blocks in page order. Entries merge with the stored ones by id; stored entries the request leaves out are kept after the sent ones. Saving the description or stack stamps the overview block, saving the linked docs stamps the docs block, and a changed config stamps its own block."},"capabilityOrder":{"type":"array","items":{"type":"string"}},"capabilityPositions":{"type":"object","additionalProperties":{"type":"number","format":"double"}},"groups":{"type":"array","items":{"$ref":"#/components/schemas/V1ProductsIdPutRequestBodyContentApplicationJsonSchemaCanvasGroupsItems"}},"notes":{"type":"array","items":{"$ref":"#/components/schemas/V1ProductsIdPutRequestBodyContentApplicationJsonSchemaCanvasNotesItems"}},"onboardingProgress":{"type":"object","additionalProperties":{"type":"object","additionalProperties":{"description":"Any type"}}},"quickStartImport":{"$ref":"#/components/schemas/V1ProductsIdPutRequestBodyContentApplicationJsonSchemaCanvasQuickStartImport"},"surfaceOrder":{"type":"array","items":{"type":"string"}},"surfacePositions":{"type":"object","additionalProperties":{"type":"number","format":"double"}},"templateId":{"type":"string"}},"title":"V1ProductsIdPutRequestBodyContentApplicationJsonSchemaCanvas"},"V1ProductsIdPutRequestBodyContentApplicationJsonSchemaSpecImportedFromSource":{"type":"string","enum":["github","linear","chatprd","manual"],"title":"V1ProductsIdPutRequestBodyContentApplicationJsonSchemaSpecImportedFromSource"},"V1ProductsIdPutRequestBodyContentApplicationJsonSchemaSpecImportedFrom":{"type":"object","properties":{"importedAt":{"type":"string"},"source":{"$ref":"#/components/schemas/V1ProductsIdPutRequestBodyContentApplicationJsonSchemaSpecImportedFromSource"},"sourceId":{"type":"string"},"syncEnabled":{"type":"boolean"}},"required":["importedAt","source"],"title":"V1ProductsIdPutRequestBodyContentApplicationJsonSchemaSpecImportedFrom"},"V1ProductsIdPutRequestBodyContentApplicationJsonSchemaSpecInternalDocsResourcesItems":{"type":"object","properties":{"addedAt":{"type":"string"},"addedByUserId":{"type":"string"},"content":{"type":"string"},"source":{"type":"string"},"title":{"type":"string","minLength":1},"type":{"type":"string","minLength":1},"url":{"type":"string"}},"required":["title","type"],"title":"V1ProductsIdPutRequestBodyContentApplicationJsonSchemaSpecInternalDocsResourcesItems"},"V1ProductsIdPutRequestBodyContentApplicationJsonSchemaSpecInternalDocs":{"type":"object","properties":{"content":{"type":"string"},"resources":{"type":"array","items":{"$ref":"#/components/schemas/V1ProductsIdPutRequestBodyContentApplicationJsonSchemaSpecInternalDocsResourcesItems"}},"tags":{"type":"array","items":{"type":"string"}}},"title":"V1ProductsIdPutRequestBodyContentApplicationJsonSchemaSpecInternalDocs"},"V1ProductsIdPutRequestBodyContentApplicationJsonSchemaSpecProductStage":{"type":"string","enum":["idea","prototype","beta","production","scaling"],"title":"V1ProductsIdPutRequestBodyContentApplicationJsonSchemaSpecProductStage"},"V1ProductsIdPutRequestBodyContentApplicationJsonSchemaSpecTechStack":{"type":"object","properties":{"backend":{"type":"array","items":{"type":"string"}},"database":{"type":"array","items":{"type":"string"}},"frontend":{"type":"array","items":{"type":"string"}},"infrastructure":{"type":"array","items":{"type":"string"}},"languages":{"type":"array","items":{"type":"string"}}},"title":"V1ProductsIdPutRequestBodyContentApplicationJsonSchemaSpecTechStack"},"V1ProductsIdPutRequestBodyContentApplicationJsonSchemaSpec":{"type":"object","properties":{"aiUseCases":{"type":"array","items":{"type":"string"}},"complianceNeeds":{"type":"array","items":{"type":"string"}},"dataSourceTypes":{"type":"array","items":{"type":"string"}},"deploymentTargets":{"type":"array","items":{"type":"string"}},"existingTools":{"type":"array","items":{"type":"string"}},"importedFrom":{"$ref":"#/components/schemas/V1ProductsIdPutRequestBodyContentApplicationJsonSchemaSpecImportedFrom"},"internalDocs":{"oneOf":[{"$ref":"#/components/schemas/V1ProductsIdPutRequestBodyContentApplicationJsonSchemaSpecInternalDocs"},{"type":"null"}]},"preferredModels":{"type":"array","items":{"type":"string"}},"productGoal":{"type":"string"},"productStage":{"$ref":"#/components/schemas/V1ProductsIdPutRequestBodyContentApplicationJsonSchemaSpecProductStage"},"stack":{"$ref":"#/components/schemas/ProductStack"},"targetAudience":{"type":"string"},"techStack":{"$ref":"#/components/schemas/V1ProductsIdPutRequestBodyContentApplicationJsonSchemaSpecTechStack"}},"title":"V1ProductsIdPutRequestBodyContentApplicationJsonSchemaSpec"},"Products_updateProduct_Response_200":{"type":"object","properties":{"canvas":{"type":"object","additionalProperties":{"description":"Any type"}},"createdAt":{"type":"string"},"dashboardUrl":{"type":"string"},"description":{"type":["string","null"]},"icon":{"type":["string","null"]},"id":{"type":"string"},"name":{"type":"string"},"spec":{"type":"object","additionalProperties":{"description":"Any type"}},"updatedAt":{"type":"string"}},"required":["canvas","createdAt","description","icon","id","name","spec","updatedAt"],"title":"Products_updateProduct_Response_200"},"Products_deleteProduct_Response_200":{"type":"object","properties":{"success":{"type":"boolean"},"warning":{"type":"string"}},"required":["success"],"title":"Products_deleteProduct_Response_200"},"V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataAgentsItemsDataItemsCompleteness":{"type":"string","enum":["partial","complete","conflicted","expired","deleted"],"description":"Storage completeness; null on a row the control-plane arm served.","title":"V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataAgentsItemsDataItemsCompleteness"},"V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataAgentsItemsDataItemsExternalAgentProtocol":{"type":"string","enum":["a2a","runtype-stream"],"description":"The wire protocol the external agent answered over.","title":"V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataAgentsItemsDataItemsExternalAgentProtocol"},"V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataAgentsItemsDataItemsExternalAgent":{"type":"object","properties":{"endpointHost":{"type":["string","null"],"maxLength":253,"description":"Hostname of the endpoint that answered, never its path or query."},"framework":{"type":["string","null"],"maxLength":253,"description":"The framework the agent's config declares, a builder-chosen label; null when unset."},"protocol":{"$ref":"#/components/schemas/V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataAgentsItemsDataItemsExternalAgentProtocol","description":"The wire protocol the external agent answered over."}},"required":["endpointHost","framework","protocol"],"description":"Set when an external agent (A2A or runtype-stream) answered the turn: the protocol, declared framework and endpoint host stamped on the run header when it was invoked. Null on any other run, and on an external-agent run whose header predates the stamp. A repointed agent keeps one agentId, so this is what tells two of its runs apart.","title":"V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataAgentsItemsDataItemsExternalAgent"},"V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataAgentsItemsDataItemsKind":{"type":"string","enum":["agent","flow"],"description":"Whether an agent or a flow ran.","title":"V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataAgentsItemsDataItemsKind"},"V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataAgentsItemsDataItemsOrigin":{"type":"string","enum":["dashboard","api","internal"],"description":"Where the run was dispatched from, taken from the caller's authenticated principal and never from a request field. ANY entrance that resolves a principal stamps it: a Clerk session answers dashboard; a management API key answers api, which includes the Runtype MCP server's tools and Code Mode, since both reach dispatch with a management key; and Runtype's own internal caller answers internal, for example the hosted /v1/mcp proxy. A lane that resolves NO principal carries NULL BY DESIGN: schedule, webhook, messaging, A2A, an agent exposed AS an MCP surface, subagent, nested flow, a client-token product surface (an end user is none of the three origins) and an ingested OTLP run. So NULL says \"no authenticated principal at this entrance\" rather than \"unknown caller\". The one NULL that is not a statement about the lane is a row whose header predates the field or came from the backfill: it stamps nothing even for a run that did resolve a principal.","title":"V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataAgentsItemsDataItemsOrigin"},"V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataAgentsItemsDataItemsSignalsResultsItemsAnswersBand":{"type":"string","enum":["act","review","low"],"title":"V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataAgentsItemsDataItemsSignalsResultsItemsAnswersBand"},"V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataAgentsItemsDataItemsSignalsResultsItemsAnswersSource":{"type":"object","properties":{"end":{"type":"integer","minimum":0},"field":{"type":"string"},"spanId":{"type":"string"},"start":{"type":"integer","minimum":0}},"required":["end","field","spanId","start"],"title":"V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataAgentsItemsDataItemsSignalsResultsItemsAnswersSource"},"V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataAgentsItemsDataItemsSignalsResultsItemsAnswersSourcesItems":{"type":"object","properties":{"end":{"type":"integer","minimum":0},"field":{"type":"string"},"spanId":{"type":"string"},"start":{"type":"integer","minimum":0}},"required":["end","field","spanId","start"],"title":"V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataAgentsItemsDataItemsSignalsResultsItemsAnswersSourcesItems"},"V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataAgentsItemsDataItemsSignalsResultsItemsAnswers":{"type":"object","properties":{"band":{"$ref":"#/components/schemas/V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataAgentsItemsDataItemsSignalsResultsItemsAnswersBand"},"confidence":{"type":"number","format":"double","minimum":0,"maximum":1},"distribution":{"type":"object","additionalProperties":{"type":"number","format":"double"}},"fired":{"type":"boolean"},"pNull":{"type":"number","format":"double"},"refused":{"type":"boolean"},"source":{"$ref":"#/components/schemas/V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataAgentsItemsDataItemsSignalsResultsItemsAnswersSource"},"sources":{"type":"array","items":{"$ref":"#/components/schemas/V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataAgentsItemsDataItemsSignalsResultsItemsAnswersSourcesItems"}},"value":{"description":"Any type"}},"required":["band"],"title":"V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataAgentsItemsDataItemsSignalsResultsItemsAnswers"},"V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataAgentsItemsDataItemsSignalsResultsItemsSample":{"type":"string","enum":["uniform","filtered"],"title":"V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataAgentsItemsDataItemsSignalsResultsItemsSample"},"V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataAgentsItemsDataItemsSignalsResultsItemsSignalSet":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"version":{"type":"integer"}},"required":["id","name","version"],"title":"V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataAgentsItemsDataItemsSignalsResultsItemsSignalSet"},"V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataAgentsItemsDataItemsSignalsResultsItemsStatus":{"type":"string","enum":["complete","failed","skipped_budget","skipped_policy","skipped_billing"],"title":"V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataAgentsItemsDataItemsSignalsResultsItemsStatus"},"V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataAgentsItemsDataItemsSignalsResultsItemsTarget":{"type":"object","properties":{"executionId":{"type":"string"},"spanId":{"type":["string","null"]},"turnIndex":{"type":["integer","null"]}},"required":["executionId","spanId","turnIndex"],"title":"V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataAgentsItemsDataItemsSignalsResultsItemsTarget"},"V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataAgentsItemsDataItemsSignalsResultsItemsUnit":{"type":"string","enum":["turn","conversation","run"],"title":"V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataAgentsItemsDataItemsSignalsResultsItemsUnit"},"V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataAgentsItemsDataItemsSignalsResultsItems":{"type":"object","properties":{"answers":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataAgentsItemsDataItemsSignalsResultsItemsAnswers"}},"bindingId":{"type":"string"},"computedAt":{"type":"string"},"error":{"type":"string"},"fired":{"type":"array","items":{"type":"string"}},"sample":{"$ref":"#/components/schemas/V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataAgentsItemsDataItemsSignalsResultsItemsSample"},"signalSet":{"$ref":"#/components/schemas/V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataAgentsItemsDataItemsSignalsResultsItemsSignalSet"},"status":{"$ref":"#/components/schemas/V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataAgentsItemsDataItemsSignalsResultsItemsStatus"},"target":{"$ref":"#/components/schemas/V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataAgentsItemsDataItemsSignalsResultsItemsTarget"},"unit":{"$ref":"#/components/schemas/V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataAgentsItemsDataItemsSignalsResultsItemsUnit"},"values":{"type":"object","additionalProperties":{"description":"Any type"}}},"required":["answers","bindingId","computedAt","fired","sample","signalSet","status","target","unit","values"],"title":"V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataAgentsItemsDataItemsSignalsResultsItems"},"V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataAgentsItemsDataItemsSignalsStatus":{"type":"string","enum":["complete","pending","partial","none","unavailable"],"title":"V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataAgentsItemsDataItemsSignalsStatus"},"V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataAgentsItemsDataItemsSignals":{"type":"object","properties":{"fired":{"type":"array","items":{"type":"string"}},"results":{"type":"array","items":{"$ref":"#/components/schemas/V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataAgentsItemsDataItemsSignalsResultsItems"}},"status":{"$ref":"#/components/schemas/V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataAgentsItemsDataItemsSignalsStatus"}},"required":["fired","status"],"description":"Trace signals. A list row carries status and fired only; GET /v1/runs/{id} adds results. Omitted entirely until the organization binds a signal set.","title":"V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataAgentsItemsDataItemsSignals"},"V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataAgentsItemsDataItemsSource":{"type":"string","enum":["hosted","ingested"],"description":"hosted, or ingested for an OTLP export. An ingested run is never reported running.","title":"V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataAgentsItemsDataItemsSource"},"V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataAgentsItemsDataItemsStatus":{"type":"string","enum":["queued","running","awaiting","completed","failed","cancelled"],"description":"Customer-facing status, derived by runStatusFrom.","title":"V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataAgentsItemsDataItemsStatus"},"V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataAgentsItemsDataItemsViaKind":{"type":"string","enum":["schedule","surface","api","mcp","cli","test","eval","simulation"],"description":"One word for the way the run started.","title":"V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataAgentsItemsDataItemsViaKind"},"V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataAgentsItemsDataItemsVia":{"type":"object","properties":{"id":{"type":["string","null"],"description":"The thing that started it: the schedule id (schedule), product surface id (surface), API key id (api), the acting user id (cli), eval suite id (eval) or simulation run id (simulation). Null for mcp and test, and for an api run whose header predates key stamping."},"kind":{"$ref":"#/components/schemas/V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataAgentsItemsDataItemsViaKind","description":"One word for the way the run started."},"label":{"type":["string","null"],"description":"Its display name when the API could resolve one: schedule name, surface name, API key name as it was at dispatch, MCP client name, the acting user's first name, or eval suite name. Null when unresolved, for example a deleted schedule."}},"required":["id","kind","label"],"description":"How the run started, for a Via column. Forward-only for schedule, api key, cli, mcp and eval detail: a header written before those stamps reads null, or falls back to the coarse origin/surface facts when they alone answer it. A label is a snapshot or a lookup and never authority; mcp, cli and sdk are self-declared by the client.","title":"V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataAgentsItemsDataItemsVia"},"V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataAgentsItemsDataItems":{"type":"object","properties":{"agentId":{"type":["string","null"],"description":"Agent that ran."},"agentTargetResolution":{"type":["string","null"],"description":"How the run chose its version: alias, version or legacy-live-row. Absent means the overlay did not answer, which is not false and not null."},"agentVersionId":{"type":["string","null"],"description":"Agent version that ran. Absent means the overlay did not answer, which is not false and not null."},"agentVersionLabel":{"type":["string","null"],"description":"Version label. Absent means the overlay did not answer, which is not false and not null."},"agentVersionNumber":{"type":["number","null"],"format":"double","description":"Version number, for a version chip and version grouping. Absent means the overlay did not answer, which is not false and not null."},"batchExecutionId":{"type":["string","null"],"description":"Batch this run belongs to."},"budgetExhausted":{"type":["boolean","null"],"description":"Budget exhausted. Absent means the overlay did not answer, which is not false and not null."},"cacheReadTokens":{"type":["number","null"],"format":"double","description":"Prompt-cache reads summed over the run's model calls (a subset of inputTokens). Returned by GET /v1/runs/{executionId} only; null means no model call reported one."},"cacheWriteTokens":{"type":["number","null"],"format":"double","description":"Prompt-cache writes summed over the run's model calls (a subset of inputTokens). Returned by GET /v1/runs/{executionId} only; null means no model call reported one."},"cancelRequestedAt":{"type":["string","null"],"description":"Cancel request. Absent means the overlay did not answer, which is not false and not null."},"childCount":{"type":["number","null"],"format":"double","description":"How many runs name this one as their parent. The unscoped feed returns roots only, so this is the size of the fold underneath a row; read the children with parentExecutionId=<executionId>. It is populated on a resource-scoped page too, where nothing is folded, so a surface can still offer the same expansion. WHICH children are counted depends on the arm that served the row: the span store counts every child, agent and nested-flow alike, while the legacy control-plane fallback counts agent children only, so on that arm a parent whose only child is a nested flow reports 0. That is deliberate — the fallback arm cannot enumerate a nested-flow child either, so counting one would advertise a fold that opens on nothing. It counts only children the CALLER may read: a credential holding one execution family (AGENTS:READ or FLOWS:READ alone) counts the children of that family and no others, so a count never discloses a run the same credential could not list. NULL means the arm cannot count children at all, which is not zero."},"completeness":{"$ref":"#/components/schemas/V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataAgentsItemsDataItemsCompleteness","description":"Storage completeness; null on a row the control-plane arm served."},"conversationId":{"type":["string","null"],"description":"Conversation this run belongs to."},"durationMs":{"type":["number","null"],"format":"double","description":"Wall-clock duration in milliseconds."},"endedAt":{"type":["string","null"],"description":"ISO instant the run ended; null while it is still running."},"executionId":{"type":"string","description":"Runtime execution id; the key for /v1/logs and /v1/runs/{id}."},"expiresAt":{"type":["string","null"],"description":"Budget expiry. Absent means the overlay did not answer, which is not false and not null."},"externalAgent":{"oneOf":[{"$ref":"#/components/schemas/V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataAgentsItemsDataItemsExternalAgent"},{"type":"null"}],"description":"Set when an external agent (A2A or runtype-stream) answered the turn: the protocol, declared framework and endpoint host stamped on the run header when it was invoked. Null on any other run, and on an external-agent run whose header predates the stamp. A repointed agent keeps one agentId, so this is what tells two of its runs apart."},"fidelityTier":{"type":["string","null"],"description":"Fidelity of the projection behind this row."},"flowId":{"type":["string","null"],"description":"Flow that ran."},"flowVersionId":{"type":["string","null"],"description":"Exact saved flow version or test capture that ran. Absent means the overlay did not answer, which is not false and not null."},"inlineDefinition":{"type":["boolean","null"],"description":"True when the dispatch carried a complete inline agent definition (name and model) beside or instead of an agentId, so the run executed that inline config and no stored version; such a row stamps no agentVersionId. False when the run executed the saved definition by reference. NULL when the header states nothing: a flow run, a lane that resolves no agent definition, or a row that predates the field."},"inputMessages":{"description":"Messages the run started from. Absent means the overlay did not answer, which is not false and not null."},"inputPreview":{"type":["string","null"],"description":"The run's first user message, secret-scrubbed and cut to 160 characters, so a list can say what a run was asked to do without reading content. Absent means no input text is recorded for this run, which is not an empty message: the span store holds no run-level input at all, so a run with no control-plane row (a flow leg, a storeResults:false run) has none."},"inputTokens":{"type":["number","null"],"format":"double","description":"Input tokens reported."},"iterations":{"type":["number","null"],"format":"double","description":"Loop iterations from the terminal frame."},"kind":{"$ref":"#/components/schemas/V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataAgentsItemsDataItemsKind","description":"Whether an agent or a flow ran."},"lastHeartbeatAt":{"type":["string","null"],"description":"Last heartbeat. Absent means the overlay did not answer, which is not false and not null."},"model":{"type":["string","null"],"description":"Model of the run's first model call (served model when reported, otherwise requested model); null when no model call recorded one."},"origin":{"$ref":"#/components/schemas/V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataAgentsItemsDataItemsOrigin","description":"Where the run was dispatched from, taken from the caller's authenticated principal and never from a request field. ANY entrance that resolves a principal stamps it: a Clerk session answers dashboard; a management API key answers api, which includes the Runtype MCP server's tools and Code Mode, since both reach dispatch with a management key; and Runtype's own internal caller answers internal, for example the hosted /v1/mcp proxy. A lane that resolves NO principal carries NULL BY DESIGN: schedule, webhook, messaging, A2A, an agent exposed AS an MCP surface, subagent, nested flow, a client-token product surface (an end user is none of the three origins) and an ingested OTLP run. So NULL says \"no authenticated principal at this entrance\" rather than \"unknown caller\". The one NULL that is not a statement about the lane is a row whose header predates the field or came from the backfill: it stamps nothing even for a run that did resolve a principal."},"otelProducer":{"description":"Framework identity the producer reported, for a versionless run group. Absent means the overlay did not answer, which is not false and not null."},"outputTokens":{"type":["number","null"],"format":"double","description":"Output tokens reported."},"parentExecutionId":{"type":["string","null"],"description":"Run that spawned this one."},"parentToolCallId":{"type":["string","null"],"description":"Parent's tool call that spawned this run."},"pendingApproval":{"description":"Approval awaiting a human. Absent means the overlay did not answer, which is not false and not null."},"progress":{"description":"Live progress document. Absent means the overlay did not answer, which is not false and not null."},"reasoningTokens":{"type":["number","null"],"format":"double","description":"Reasoning tokens summed over the run's model calls (a subset of outputTokens). Returned by GET /v1/runs/{executionId} only; null means no model call reported one."},"recordId":{"type":["string","null"],"description":"Record this run processed."},"requestedFlowId":{"type":["string","null"],"maxLength":128,"description":"The flow.id an inline /v1/dispatch named when the caller's organization does not own a flow with that id. Such a run executes as the \"virtual\" flow, so flowId reads \"virtual\" and this field carries the caller's id (control characters stripped, cut to 128 characters) so the caller can still recognise its runs. It is a label only: it grants nothing, is never used as a sender or resume identity, and is not a list filter; filter with flowId=virtual and match on this field. Absent when the run executed under the id it named."},"retentionElided":{"type":"boolean","description":"Retention removed the spans; the run still lists and reads as completed."},"rootExecutionId":{"type":["string","null"],"description":"Outermost run of the tree."},"selfReportedCost":{"type":["string","null"],"description":"Cost the producer reported."},"signals":{"$ref":"#/components/schemas/V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataAgentsItemsDataItemsSignals","description":"Trace signals. A list row carries status and fired only; GET /v1/runs/{id} adds results. Omitted entirely until the organization binds a signal set."},"source":{"$ref":"#/components/schemas/V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataAgentsItemsDataItemsSource","description":"hosted, or ingested for an OTLP export. An ingested run is never reported running."},"spanCount":{"type":["number","null"],"format":"double","description":"Spans the projection wrote."},"startedAt":{"type":"string","description":"ISO instant the run started."},"status":{"$ref":"#/components/schemas/V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataAgentsItemsDataItemsStatus","description":"Customer-facing status, derived by runStatusFrom."},"stopReason":{"type":["string","null"],"description":"Stop reason from the terminal frame."},"storeResults":{"type":["boolean","null"],"description":"The persistence posture the dispatch declared. FALSE means the run wrote no control-plane row, no journal outputs and no span content, so a surface that reports a missing transcript keys on this and never on origin. NULL means the header states nothing, which is not \"true\": a lane that takes no such flag carries no stamp, and an ingested (OTLP) run declared none. A row served from the legacy control-plane lane answers true, because that row exists only when the run stored."},"surfaceId":{"type":["string","null"],"description":"Product surface that entered this run."},"surfaceType":{"type":["string","null"],"description":"Surface family (api, chat, webhook, schedule, ...)."},"test":{"type":["boolean","null"],"description":"DEPRECATED: a derived alias of origin, kept for one release — read origin instead. True when the run came from the dashboard, i.e. origin === \"dashboard\"; NULL exactly when origin is NULL. It is never derived from storeResults, which defaults to false across the whole flow lane and which an API caller sets for its own privacy reasons: reading it as \"test\" labelled production runs as tests. A run whose header predates origin therefore reads NULL rather than claiming either answer.","deprecated":true},"totalCost":{"type":["string","null"],"description":"Metered cost as a decimal string."},"traceId":{"type":["string","null"],"description":"Trace id in the span store; null on a row the control-plane arm served."},"via":{"oneOf":[{"$ref":"#/components/schemas/V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataAgentsItemsDataItemsVia"},{"type":"null"}],"description":"How the run started, for a Via column. Forward-only for schedule, api key, cli, mcp and eval detail: a header written before those stamps reads null, or falls back to the coarse origin/surface facts when they alone answer it. A label is a snapshot or a lookup and never authority; mcp, cli and sdk are self-declared by the client."}},"required":["agentId","batchExecutionId","childCount","completeness","conversationId","durationMs","endedAt","executionId","fidelityTier","flowId","inlineDefinition","inputTokens","kind","origin","outputTokens","parentExecutionId","parentToolCallId","recordId","rootExecutionId","selfReportedCost","source","spanCount","startedAt","status","storeResults","surfaceId","surfaceType","test","totalCost","traceId"],"title":"V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataAgentsItemsDataItems"},"V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataAgentsItemsError":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"title":"V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataAgentsItemsError"},"RunListPagination":{"type":"object","properties":{"hasMore":{"type":"boolean"},"hasPrev":{"type":"boolean"},"limit":{"type":"integer"},"nextCursor":{"type":["string","null"]}},"required":["hasMore","hasPrev","limit","nextCursor"],"title":"RunListPagination"},"V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataAgentsItems":{"type":"object","properties":{"agentId":{"type":"string"},"data":{"type":"array","items":{"$ref":"#/components/schemas/V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataAgentsItemsDataItems"}},"error":{"$ref":"#/components/schemas/V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataAgentsItemsError"},"pagination":{"$ref":"#/components/schemas/RunListPagination"}},"required":["agentId","data","pagination"],"title":"V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataAgentsItems"},"V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataSurfacesItemsDataItems0":{"type":"object","properties":{"agentMode":{"type":"string"},"createdAt":{"type":"string"},"externalParticipantId":{"type":["string","null"]},"externalThreadId":{"type":["string","null"]},"id":{"type":"string"},"lastMessageAt":{"type":["string","null"]},"messageCount":{"type":"number","format":"double"},"participantEmail":{"type":["string","null"]},"participantName":{"type":["string","null"]},"status":{"type":"string"},"subject":{"type":["string","null"]},"surfaceId":{"type":"string"},"takeoverActorId":{"type":["string","null"]},"takeoverActorType":{"type":["string","null"]},"takeoverAt":{"type":["string","null"]},"takeoverReason":{"type":["string","null"]},"timezone":{"type":["string","null"]},"updatedAt":{"type":"string"}},"required":["agentMode","createdAt","externalParticipantId","externalThreadId","id","lastMessageAt","messageCount","participantEmail","participantName","status","subject","surfaceId","takeoverActorId","takeoverActorType","takeoverAt","takeoverReason","timezone","updatedAt"],"title":"V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataSurfacesItemsDataItems0"},"V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataSurfacesItemsDataItemsOneOf1MetadataSchema":{"type":"object","properties":{"keys":{"type":"array","items":{"type":"string"}}},"required":["keys"],"title":"V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataSurfacesItemsDataItemsOneOf1MetadataSchema"},"V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataSurfacesItemsDataItems1":{"type":"object","properties":{"availableFields":{"type":"array","items":{"type":"string"}},"createdAt":{"type":"string"},"id":{"type":"string"},"messages":{"type":["array","null"],"items":{"description":"Any type"}},"metadata":{"type":"object","additionalProperties":{"description":"Any type"}},"metadataLabels":{"type":"object","additionalProperties":{"type":"string"}},"metadataSchema":{"$ref":"#/components/schemas/V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataSurfacesItemsDataItemsOneOf1MetadataSchema"},"name":{"type":"string"},"organizationId":{"type":["string","null"]},"ownerId":{"type":["string","null"]},"productSurfaceId":{"type":["string","null"]},"schemaValid":{"type":["boolean","null"]},"type":{"type":"string"},"updatedAt":{"type":"string"},"userId":{"type":"string"}},"required":["createdAt","id","messages","metadata","name","organizationId","ownerId","productSurfaceId","schemaValid","type","updatedAt","userId"],"title":"V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataSurfacesItemsDataItems1"},"V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataSurfacesItemsDataItems":{"oneOf":[{"$ref":"#/components/schemas/V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataSurfacesItemsDataItems0"},{"$ref":"#/components/schemas/V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataSurfacesItemsDataItems1"}],"title":"V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataSurfacesItemsDataItems"},"V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataSurfacesItemsError":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"title":"V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataSurfacesItemsError"},"V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataSurfacesItemsSource":{"type":"string","enum":["messaging","client_conversation"],"title":"V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataSurfacesItemsSource"},"V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataSurfacesItems":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataSurfacesItemsDataItems"}},"error":{"$ref":"#/components/schemas/V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataSurfacesItemsError"},"pagination":{"$ref":"#/components/schemas/Pagination"},"source":{"$ref":"#/components/schemas/V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataSurfacesItemsSource"},"surfaceId":{"type":"string"}},"required":["data","pagination","source","surfaceId"],"title":"V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataSurfacesItems"},"V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaData":{"type":"object","properties":{"agents":{"type":"array","items":{"$ref":"#/components/schemas/V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataAgentsItems"}},"surfaces":{"type":"array","items":{"$ref":"#/components/schemas/V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaDataSurfacesItems"}}},"required":["agents","surfaces"],"title":"V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaData"},"Products_getProductActivity_Response_200":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/V1ProductsIdActivityGetResponsesContentApplicationJsonSchemaData"},"success":{"type":"boolean"}},"required":["data","success"],"title":"Products_getProductActivity_Response_200"},"Products_addCapabilityToProduct_Response_201":{"type":"object","properties":{"agentId":{"type":["string","null"]},"capabilityDescription":{"type":["string","null"]},"capabilityName":{"type":"string"},"createdAt":{"type":"string"},"displayOrder":{"type":["integer","null"]},"enabled":{"type":"boolean"},"flowId":{"type":["string","null"]},"id":{"type":"string"},"parametersSchema":{"description":"Any type"},"productId":{"type":"string"}},"required":["agentId","capabilityDescription","capabilityName","createdAt","displayOrder","enabled","flowId","id","productId"],"title":"Products_addCapabilityToProduct_Response_201"},"Products_updateCapability_Response_200":{"type":"object","properties":{"agentId":{"type":["string","null"]},"capabilityDescription":{"type":["string","null"]},"capabilityName":{"type":"string"},"createdAt":{"type":"string"},"displayOrder":{"type":["integer","null"]},"enabled":{"type":"boolean"},"flowId":{"type":["string","null"]},"id":{"type":"string"},"parametersSchema":{"description":"Any type"},"productId":{"type":"string"}},"required":["agentId","capabilityDescription","capabilityName","createdAt","displayOrder","enabled","flowId","id","productId"],"title":"Products_updateCapability_Response_200"},"Products_removeCapability_Response_200":{"type":"object","properties":{"success":{"type":"boolean"}},"required":["success"],"title":"Products_removeCapability_Response_200"},"V1ProductsIdCleanupPreviewGetResponsesContentApplicationJsonSchemaResourcesItemsType":{"type":"string","enum":["flow","agent"],"title":"V1ProductsIdCleanupPreviewGetResponsesContentApplicationJsonSchemaResourcesItemsType"},"V1ProductsIdCleanupPreviewGetResponsesContentApplicationJsonSchemaResourcesItems":{"type":"object","properties":{"externalRefCount":{"type":"integer"},"id":{"type":"string"},"name":{"type":"string"},"referencedElsewhere":{"type":"boolean"},"type":{"$ref":"#/components/schemas/V1ProductsIdCleanupPreviewGetResponsesContentApplicationJsonSchemaResourcesItemsType"}},"required":["externalRefCount","id","name","referencedElsewhere","type"],"title":"V1ProductsIdCleanupPreviewGetResponsesContentApplicationJsonSchemaResourcesItems"},"Products_previewCleanupResources_Response_200":{"type":"object","properties":{"resources":{"type":"array","items":{"$ref":"#/components/schemas/V1ProductsIdCleanupPreviewGetResponsesContentApplicationJsonSchemaResourcesItems"}}},"required":["resources"],"title":"Products_previewCleanupResources_Response_200"},"V1ProductsIdCommentsGetParametersStatus":{"type":"string","enum":["open","resolved","all"],"description":"Which threads to list; defaults to `all`","title":"V1ProductsIdCommentsGetParametersStatus"},"ProductCommentAuthorKind":{"type":"string","enum":["user","assistant"],"description":"`assistant` for an answer to an `@assistant` mention, else `user`","title":"ProductCommentAuthorKind"},"ProductComment":{"type":"object","properties":{"authorKind":{"$ref":"#/components/schemas/ProductCommentAuthorKind","description":"`assistant` for an answer to an `@assistant` mention, else `user`"},"authorLabel":{"type":"string","description":"The name it was posted under: the person's first name, the API key's name, or `Assistant`"},"authorUserId":{"type":["string","null"],"description":"Who posted it (for an assistant answer, whose client relayed it); null once that person's account is deleted"},"body":{"type":"string"},"createdAt":{"type":"string"},"id":{"type":"string"},"mentions":{"type":"array","items":{"type":"string"}},"threadId":{"type":"string"}},"required":["authorKind","authorLabel","authorUserId","body","createdAt","id","mentions","threadId"],"title":"ProductComment"},"ProductCommentThread":{"type":"object","properties":{"anchor":{"type":"string","description":"The canvas element the thread is on; the thread outlives it when that element is removed"},"createdAt":{"type":"string"},"createdByUserId":{"type":["string","null"]},"id":{"type":"string"},"messages":{"type":"array","items":{"$ref":"#/components/schemas/ProductComment"},"description":"Oldest first"},"productId":{"type":"string"},"resolved":{"type":"boolean"},"resolvedAt":{"type":["string","null"]},"resolvedByUserId":{"type":["string","null"]},"updatedAt":{"type":"string"}},"required":["anchor","createdAt","createdByUserId","id","messages","productId","resolved","resolvedAt","resolvedByUserId","updatedAt"],"title":"ProductCommentThread"},"ListProductCommentsResponse":{"type":"object","properties":{"hasMore":{"type":"boolean","description":"True when older threads were left out by `limit`"},"nextCursor":{"type":["string","null"],"description":"Pass as `cursor` to list the threads older than this page; null once none are left"},"threads":{"type":"array","items":{"$ref":"#/components/schemas/ProductCommentThread"},"description":"Oldest first: the newest `limit` threads"}},"required":["hasMore","nextCursor","threads"],"title":"ListProductCommentsResponse"},"CreateProductCommentThreadRequest":{"type":"object","properties":{"anchor":{"type":"string","pattern":"^[a-z][a-z-]*:\\S+$","minLength":1,"maxLength":512,"description":"The canvas element to comment on: `entity:<id>`, `step:<flow>/<step>`, `edge:<from>/<to>`, `block:<block>[/<key>]`"},"body":{"type":"string","minLength":1,"maxLength":10000,"description":"The comment text; backticks mark code and `@name` a mention"},"mentions":{"type":"array","items":{"type":"string","minLength":1,"maxLength":255},"description":"What the body names with `@`: `assistant`, or a teammate as their name was inserted"}},"required":["anchor","body"],"title":"CreateProductCommentThreadRequest"},"UpdateProductCommentThreadRequest":{"type":"object","properties":{"resolved":{"type":"boolean","description":"True resolves the thread, false opens it again"}},"required":["resolved"],"title":"UpdateProductCommentThreadRequest"},"CreateProductCommentRequestAuthorKind":{"type":"string","enum":["user","assistant"],"description":"`assistant` when the caller's client posts the Assistant's answer to an `@assistant`; defaults to `user`","title":"CreateProductCommentRequestAuthorKind"},"CreateProductCommentRequest":{"type":"object","properties":{"authorKind":{"$ref":"#/components/schemas/CreateProductCommentRequestAuthorKind","description":"`assistant` when the caller's client posts the Assistant's answer to an `@assistant`; defaults to `user`"},"body":{"type":"string","minLength":1,"maxLength":10000,"description":"The comment text; backticks mark code and `@name` a mention"},"mentions":{"type":"array","items":{"type":"string","minLength":1,"maxLength":255},"description":"What the body names with `@`: `assistant`, or a teammate as their name was inserted"}},"required":["body"],"title":"CreateProductCommentRequest"},"V1ProductsIdConfigurationGetResponsesContentApplicationJsonSchemaConfigurationStatus":{"type":"string","enum":["configured","needs_configuration","revoked","invalid"],"title":"V1ProductsIdConfigurationGetResponsesContentApplicationJsonSchemaConfigurationStatus"},"V1ProductsIdConfigurationGetResponsesContentApplicationJsonSchemaHandoffOneOf0Type":{"type":"string","enum":["url"],"title":"V1ProductsIdConfigurationGetResponsesContentApplicationJsonSchemaHandoffOneOf0Type"},"V1ProductsIdConfigurationGetResponsesContentApplicationJsonSchemaHandoff0":{"type":"object","properties":{"expiresAt":{"type":"string"},"type":{"$ref":"#/components/schemas/V1ProductsIdConfigurationGetResponsesContentApplicationJsonSchemaHandoffOneOf0Type"},"url":{"type":"string"}},"required":["type","url"],"title":"V1ProductsIdConfigurationGetResponsesContentApplicationJsonSchemaHandoff0"},"V1ProductsIdConfigurationGetResponsesContentApplicationJsonSchemaHandoff":{"oneOf":[{"$ref":"#/components/schemas/V1ProductsIdConfigurationGetResponsesContentApplicationJsonSchemaHandoff0"}],"title":"V1ProductsIdConfigurationGetResponsesContentApplicationJsonSchemaHandoff"},"V1ProductsIdConfigurationGetResponsesContentApplicationJsonSchemaRequirementsItemsStatus":{"type":"string","enum":["configured","needs_configuration","revoked","invalid"],"title":"V1ProductsIdConfigurationGetResponsesContentApplicationJsonSchemaRequirementsItemsStatus"},"V1ProductsIdConfigurationGetResponsesContentApplicationJsonSchemaRequirementsItems":{"type":"object","properties":{"description":{"type":["string","null"]},"displayName":{"type":["string","null"]},"docsUrl":{"type":"string"},"helpText":{"type":"string"},"itemId":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean","default":true},"secretId":{"type":"string"},"secretKey":{"type":"string","minLength":1},"status":{"$ref":"#/components/schemas/V1ProductsIdConfigurationGetResponsesContentApplicationJsonSchemaRequirementsItemsStatus"},"version":{"type":"integer","minimum":0}},"required":["itemId","secretKey","status"],"title":"V1ProductsIdConfigurationGetResponsesContentApplicationJsonSchemaRequirementsItems"},"Products_getProductConfigurationSummary_Response_200":{"type":"object","properties":{"configurationStatus":{"$ref":"#/components/schemas/V1ProductsIdConfigurationGetResponsesContentApplicationJsonSchemaConfigurationStatus"},"configurationUrl":{"type":"string"},"handoff":{"$ref":"#/components/schemas/V1ProductsIdConfigurationGetResponsesContentApplicationJsonSchemaHandoff"},"pendingConfigurationCount":{"type":"integer","minimum":0},"productId":{"type":"string"},"productName":{"type":"string"},"requirements":{"type":"array","items":{"$ref":"#/components/schemas/V1ProductsIdConfigurationGetResponsesContentApplicationJsonSchemaRequirementsItems"}}},"required":["configurationStatus","configurationUrl","pendingConfigurationCount","productId","productName","requirements"],"title":"Products_getProductConfigurationSummary_Response_200"},"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaHandoffRung":{"type":"string","enum":["browser"],"title":"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaHandoffRung"},"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaHandoff":{"type":"object","properties":{"reason":{"type":"string"},"rung":{"$ref":"#/components/schemas/V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaHandoffRung"},"summary":{"type":"string"},"url":{"type":"string"}},"required":["reason","rung","summary","url"],"title":"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaHandoff"},"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaState":{"type":"string","enum":["ready","needs_setup"],"title":"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaState"},"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsAlternativesItemsOneOf0Rung":{"type":"string","enum":["mcp_tool"],"title":"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsAlternativesItemsOneOf0Rung"},"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsAlternativesItems0":{"type":"object","properties":{"args":{"type":"object","additionalProperties":{"description":"Any type"}},"pendingArgs":{"type":"object","additionalProperties":{"type":"string"}},"rung":{"$ref":"#/components/schemas/V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsAlternativesItemsOneOf0Rung"},"summary":{"type":"string"},"tool":{"type":"string"}},"required":["args","rung","summary","tool"],"title":"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsAlternativesItems0"},"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsAlternativesItemsOneOf1Method":{"type":"string","enum":["PATCH","POST","PUT"],"title":"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsAlternativesItemsOneOf1Method"},"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsAlternativesItemsOneOf1Rung":{"type":"string","enum":["rest"],"title":"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsAlternativesItemsOneOf1Rung"},"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsAlternativesItems1":{"type":"object","properties":{"endpoint":{"type":"string"},"method":{"$ref":"#/components/schemas/V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsAlternativesItemsOneOf1Method"},"rung":{"$ref":"#/components/schemas/V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsAlternativesItemsOneOf1Rung"},"summary":{"type":"string"}},"required":["endpoint","method","rung","summary"],"title":"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsAlternativesItems1"},"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsAlternativesItemsOneOf2Rung":{"type":"string","enum":["browser"],"title":"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsAlternativesItemsOneOf2Rung"},"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsAlternativesItems2":{"type":"object","properties":{"reason":{"type":"string"},"rung":{"$ref":"#/components/schemas/V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsAlternativesItemsOneOf2Rung"},"summary":{"type":"string"},"url":{"type":"string"}},"required":["reason","rung","summary","url"],"title":"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsAlternativesItems2"},"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsAlternativesItemsOneOf3Rung":{"type":"string","enum":["satisfied"],"title":"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsAlternativesItemsOneOf3Rung"},"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsAlternativesItems3":{"type":"object","properties":{"rung":{"$ref":"#/components/schemas/V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsAlternativesItemsOneOf3Rung"}},"required":["rung"],"title":"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsAlternativesItems3"},"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsAlternativesItems":{"oneOf":[{"$ref":"#/components/schemas/V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsAlternativesItems0"},{"$ref":"#/components/schemas/V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsAlternativesItems1"},{"$ref":"#/components/schemas/V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsAlternativesItems2"},{"$ref":"#/components/schemas/V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsAlternativesItems3"}],"title":"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsAlternativesItems"},"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsFulfillmentOneOf0Rung":{"type":"string","enum":["mcp_tool"],"title":"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsFulfillmentOneOf0Rung"},"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsFulfillment0":{"type":"object","properties":{"args":{"type":"object","additionalProperties":{"description":"Any type"}},"pendingArgs":{"type":"object","additionalProperties":{"type":"string"}},"rung":{"$ref":"#/components/schemas/V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsFulfillmentOneOf0Rung"},"summary":{"type":"string"},"tool":{"type":"string"}},"required":["args","rung","summary","tool"],"title":"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsFulfillment0"},"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsFulfillmentOneOf1Method":{"type":"string","enum":["PATCH","POST","PUT"],"title":"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsFulfillmentOneOf1Method"},"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsFulfillmentOneOf1Rung":{"type":"string","enum":["rest"],"title":"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsFulfillmentOneOf1Rung"},"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsFulfillment1":{"type":"object","properties":{"endpoint":{"type":"string"},"method":{"$ref":"#/components/schemas/V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsFulfillmentOneOf1Method"},"rung":{"$ref":"#/components/schemas/V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsFulfillmentOneOf1Rung"},"summary":{"type":"string"}},"required":["endpoint","method","rung","summary"],"title":"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsFulfillment1"},"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsFulfillmentOneOf2Rung":{"type":"string","enum":["browser"],"title":"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsFulfillmentOneOf2Rung"},"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsFulfillment2":{"type":"object","properties":{"reason":{"type":"string"},"rung":{"$ref":"#/components/schemas/V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsFulfillmentOneOf2Rung"},"summary":{"type":"string"},"url":{"type":"string"}},"required":["reason","rung","summary","url"],"title":"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsFulfillment2"},"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsFulfillmentOneOf3Rung":{"type":"string","enum":["satisfied"],"title":"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsFulfillmentOneOf3Rung"},"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsFulfillment3":{"type":"object","properties":{"rung":{"$ref":"#/components/schemas/V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsFulfillmentOneOf3Rung"}},"required":["rung"],"title":"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsFulfillment3"},"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsFulfillment":{"oneOf":[{"$ref":"#/components/schemas/V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsFulfillment0"},{"$ref":"#/components/schemas/V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsFulfillment1"},{"$ref":"#/components/schemas/V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsFulfillment2"},{"$ref":"#/components/schemas/V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsFulfillment3"}],"title":"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsFulfillment"},"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsKind":{"type":"string","enum":["secret","surface_install"],"title":"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsKind"},"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsStatus":{"type":"string","enum":["satisfied","pending"],"title":"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsStatus"},"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaStepsItems":{"type":"object","properties":{"alternatives":{"type":"array","items":{"$ref":"#/components/schemas/V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsAlternativesItems"}},"docsUrl":{"type":"string"},"fulfillment":{"$ref":"#/components/schemas/V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsFulfillment"},"helpText":{"type":"string"},"id":{"type":"string"},"kind":{"$ref":"#/components/schemas/V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsKind"},"required":{"type":"boolean"},"secretKey":{"type":"string"},"status":{"$ref":"#/components/schemas/V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsStatus"},"surfaceId":{"type":"string"},"surfaceType":{"type":"string"},"title":{"type":"string"}},"required":["fulfillment","id","kind","required","status","title"],"title":"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaStepsItems"},"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaSurfacesItemsState":{"type":"string","enum":["ready","needs_setup"],"title":"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaSurfacesItemsState"},"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaSurfacesItemsStepsItemsAlternativesItemsOneOf0Rung":{"type":"string","enum":["mcp_tool"],"title":"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaSurfacesItemsStepsItemsAlternativesItemsOneOf0Rung"},"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaSurfacesItemsStepsItemsAlternativesItems0":{"type":"object","properties":{"args":{"type":"object","additionalProperties":{"description":"Any type"}},"pendingArgs":{"type":"object","additionalProperties":{"type":"string"}},"rung":{"$ref":"#/components/schemas/V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaSurfacesItemsStepsItemsAlternativesItemsOneOf0Rung"},"summary":{"type":"string"},"tool":{"type":"string"}},"required":["args","rung","summary","tool"],"title":"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaSurfacesItemsStepsItemsAlternativesItems0"},"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaSurfacesItemsStepsItemsAlternativesItemsOneOf1Method":{"type":"string","enum":["PATCH","POST","PUT"],"title":"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaSurfacesItemsStepsItemsAlternativesItemsOneOf1Method"},"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaSurfacesItemsStepsItemsAlternativesItemsOneOf1Rung":{"type":"string","enum":["rest"],"title":"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaSurfacesItemsStepsItemsAlternativesItemsOneOf1Rung"},"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaSurfacesItemsStepsItemsAlternativesItems1":{"type":"object","properties":{"endpoint":{"type":"string"},"method":{"$ref":"#/components/schemas/V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaSurfacesItemsStepsItemsAlternativesItemsOneOf1Method"},"rung":{"$ref":"#/components/schemas/V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaSurfacesItemsStepsItemsAlternativesItemsOneOf1Rung"},"summary":{"type":"string"}},"required":["endpoint","method","rung","summary"],"title":"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaSurfacesItemsStepsItemsAlternativesItems1"},"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaSurfacesItemsStepsItemsAlternativesItemsOneOf2Rung":{"type":"string","enum":["browser"],"title":"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaSurfacesItemsStepsItemsAlternativesItemsOneOf2Rung"},"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaSurfacesItemsStepsItemsAlternativesItems2":{"type":"object","properties":{"reason":{"type":"string"},"rung":{"$ref":"#/components/schemas/V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaSurfacesItemsStepsItemsAlternativesItemsOneOf2Rung"},"summary":{"type":"string"},"url":{"type":"string"}},"required":["reason","rung","summary","url"],"title":"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaSurfacesItemsStepsItemsAlternativesItems2"},"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaSurfacesItemsStepsItemsAlternativesItemsOneOf3Rung":{"type":"string","enum":["satisfied"],"title":"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaSurfacesItemsStepsItemsAlternativesItemsOneOf3Rung"},"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaSurfacesItemsStepsItemsAlternativesItems3":{"type":"object","properties":{"rung":{"$ref":"#/components/schemas/V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaSurfacesItemsStepsItemsAlternativesItemsOneOf3Rung"}},"required":["rung"],"title":"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaSurfacesItemsStepsItemsAlternativesItems3"},"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaSurfacesItemsStepsItemsAlternativesItems":{"oneOf":[{"$ref":"#/components/schemas/V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaSurfacesItemsStepsItemsAlternativesItems0"},{"$ref":"#/components/schemas/V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaSurfacesItemsStepsItemsAlternativesItems1"},{"$ref":"#/components/schemas/V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaSurfacesItemsStepsItemsAlternativesItems2"},{"$ref":"#/components/schemas/V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaSurfacesItemsStepsItemsAlternativesItems3"}],"title":"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaSurfacesItemsStepsItemsAlternativesItems"},"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaSurfacesItemsStepsItemsFulfillmentOneOf0Rung":{"type":"string","enum":["mcp_tool"],"title":"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaSurfacesItemsStepsItemsFulfillmentOneOf0Rung"},"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaSurfacesItemsStepsItemsFulfillment0":{"type":"object","properties":{"args":{"type":"object","additionalProperties":{"description":"Any type"}},"pendingArgs":{"type":"object","additionalProperties":{"type":"string"}},"rung":{"$ref":"#/components/schemas/V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaSurfacesItemsStepsItemsFulfillmentOneOf0Rung"},"summary":{"type":"string"},"tool":{"type":"string"}},"required":["args","rung","summary","tool"],"title":"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaSurfacesItemsStepsItemsFulfillment0"},"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaSurfacesItemsStepsItemsFulfillmentOneOf1Method":{"type":"string","enum":["PATCH","POST","PUT"],"title":"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaSurfacesItemsStepsItemsFulfillmentOneOf1Method"},"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaSurfacesItemsStepsItemsFulfillmentOneOf1Rung":{"type":"string","enum":["rest"],"title":"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaSurfacesItemsStepsItemsFulfillmentOneOf1Rung"},"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaSurfacesItemsStepsItemsFulfillment1":{"type":"object","properties":{"endpoint":{"type":"string"},"method":{"$ref":"#/components/schemas/V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaSurfacesItemsStepsItemsFulfillmentOneOf1Method"},"rung":{"$ref":"#/components/schemas/V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaSurfacesItemsStepsItemsFulfillmentOneOf1Rung"},"summary":{"type":"string"}},"required":["endpoint","method","rung","summary"],"title":"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaSurfacesItemsStepsItemsFulfillment1"},"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaSurfacesItemsStepsItemsFulfillmentOneOf2Rung":{"type":"string","enum":["browser"],"title":"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaSurfacesItemsStepsItemsFulfillmentOneOf2Rung"},"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaSurfacesItemsStepsItemsFulfillment2":{"type":"object","properties":{"reason":{"type":"string"},"rung":{"$ref":"#/components/schemas/V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaSurfacesItemsStepsItemsFulfillmentOneOf2Rung"},"summary":{"type":"string"},"url":{"type":"string"}},"required":["reason","rung","summary","url"],"title":"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaSurfacesItemsStepsItemsFulfillment2"},"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaSurfacesItemsStepsItemsFulfillmentOneOf3Rung":{"type":"string","enum":["satisfied"],"title":"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaSurfacesItemsStepsItemsFulfillmentOneOf3Rung"},"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaSurfacesItemsStepsItemsFulfillment3":{"type":"object","properties":{"rung":{"$ref":"#/components/schemas/V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaSurfacesItemsStepsItemsFulfillmentOneOf3Rung"}},"required":["rung"],"title":"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaSurfacesItemsStepsItemsFulfillment3"},"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaSurfacesItemsStepsItemsFulfillment":{"oneOf":[{"$ref":"#/components/schemas/V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaSurfacesItemsStepsItemsFulfillment0"},{"$ref":"#/components/schemas/V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaSurfacesItemsStepsItemsFulfillment1"},{"$ref":"#/components/schemas/V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaSurfacesItemsStepsItemsFulfillment2"},{"$ref":"#/components/schemas/V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaSurfacesItemsStepsItemsFulfillment3"}],"title":"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaSurfacesItemsStepsItemsFulfillment"},"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaSurfacesItemsStepsItemsKind":{"type":"string","enum":["secret","surface_install"],"title":"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaSurfacesItemsStepsItemsKind"},"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaSurfacesItemsStepsItemsStatus":{"type":"string","enum":["satisfied","pending"],"title":"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaSurfacesItemsStepsItemsStatus"},"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaSurfacesItemsStepsItems":{"type":"object","properties":{"alternatives":{"type":"array","items":{"$ref":"#/components/schemas/V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaSurfacesItemsStepsItemsAlternativesItems"}},"docsUrl":{"type":"string"},"fulfillment":{"$ref":"#/components/schemas/V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaSurfacesItemsStepsItemsFulfillment"},"helpText":{"type":"string"},"id":{"type":"string"},"kind":{"$ref":"#/components/schemas/V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaSurfacesItemsStepsItemsKind"},"required":{"type":"boolean"},"secretKey":{"type":"string"},"status":{"$ref":"#/components/schemas/V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaSurfacesItemsStepsItemsStatus"},"surfaceId":{"type":"string"},"surfaceType":{"type":"string"},"title":{"type":"string"}},"required":["fulfillment","id","kind","required","status","title"],"title":"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaSurfacesItemsStepsItems"},"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaSurfacesItems":{"type":"object","properties":{"name":{"type":"string"},"pendingCount":{"type":"integer","minimum":0},"state":{"$ref":"#/components/schemas/V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaSurfacesItemsState"},"steps":{"type":"array","items":{"$ref":"#/components/schemas/V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaSurfacesItemsStepsItems"}},"surfaceId":{"type":"string"},"surfaceType":{"type":"string"}},"required":["name","pendingCount","state","steps","surfaceId","surfaceType"],"title":"V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaSurfacesItems"},"Products_getProductSetupReadiness_Response_200":{"type":"object","properties":{"handoff":{"$ref":"#/components/schemas/V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaHandoff"},"pendingCount":{"type":"integer","minimum":0},"productId":{"type":"string"},"productName":{"type":"string"},"state":{"$ref":"#/components/schemas/V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaState"},"steps":{"type":"array","items":{"$ref":"#/components/schemas/V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaStepsItems"}},"surfaces":{"type":"array","items":{"$ref":"#/components/schemas/V1ProductsIdSetupGetResponsesContentApplicationJsonSchemaSurfacesItems"}}},"required":["pendingCount","productId","productName","state","steps","surfaces"],"title":"Products_getProductSetupReadiness_Response_200"},"DeclareProductStackRequestSource":{"type":"string","enum":["mcp","cli","api"],"description":"Where the declaration comes from: the Runtype MCP server, the CLI, or the API","title":"DeclareProductStackRequestSource"},"DeclareProductStackRequest":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/ProductStackItem"},"description":"Everything this source says the product is built on. Replaces the previous declaration from the same source whole; an empty list clears it. Keys follow the detected ones (model:<id>, data:<engine>, runtime:<name>, integration:<id>) so a declared item and a detected one show once, else custom:<slug>."},"source":{"$ref":"#/components/schemas/DeclareProductStackRequestSource","description":"Where the declaration comes from: the Runtype MCP server, the CLI, or the API"}},"required":["items","source"],"title":"DeclareProductStackRequest"},"DeclareProductStackResponseSource":{"type":"string","enum":["mcp","cli","api"],"title":"DeclareProductStackResponseSource"},"DeclareProductStackResponse":{"type":"object","properties":{"declaration":{"$ref":"#/components/schemas/ProductDeclaredStack"},"productId":{"type":"string"},"source":{"$ref":"#/components/schemas/DeclareProductStackResponseSource"},"stack":{"$ref":"#/components/schemas/ProductStack"}},"required":["declaration","productId","source","stack"],"title":"DeclareProductStackResponse"},"WebhookHealthRecentFailuresItems":{"type":"object","properties":{"at":{"type":"string"},"reason":{"type":"string"},"statusCode":{"type":"number","format":"double"}},"required":["at","reason"],"title":"WebhookHealthRecentFailuresItems"},"WebhookHealth":{"type":"object","properties":{"lastDeliveryAt":{"type":["string","null"],"description":"ISO timestamp of the most recent accepted inbound delivery."},"recentFailures":{"type":"array","items":{"$ref":"#/components/schemas/WebhookHealthRecentFailuresItems"},"description":"Most recent inbound rejections, newest first, capped at a small fixed number. A failure newer than lastDeliveryAt means the webhook is currently rejecting events (commonly a credential mismatch such as a wrong Slack signing secret)."}},"required":["lastDeliveryAt","recentFailures"],"title":"WebhookHealth"},"V1ProductsIdSurfacesGetResponsesContentApplicationJsonSchemaDataItems":{"type":"object","properties":{"behavior":{"description":"Any type"},"createdAt":{"type":"string"},"endpoint":{"type":["string","null"],"description":"Canonical public URL of this surface (MCP, API, A2A, AG-UI, webhook, chat). Null for surface types reached through their own channels (Slack, email, schedule, ...). Clients should use this instead of constructing the URL themselves."},"id":{"type":"string"},"inbound":{"description":"Any type"},"name":{"type":"string"},"outbound":{"description":"Any type"},"productId":{"type":"string"},"status":{"type":"string"},"type":{"type":"string"},"updatedAt":{"type":"string"},"webhookHealth":{"$ref":"#/components/schemas/WebhookHealth"}},"required":["createdAt","endpoint","id","name","productId","status","type","updatedAt","webhookHealth"],"title":"V1ProductsIdSurfacesGetResponsesContentApplicationJsonSchemaDataItems"},"Products_listSurfaces_Response_200":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1ProductsIdSurfacesGetResponsesContentApplicationJsonSchemaDataItems"}},"pagination":{"$ref":"#/components/schemas/Pagination"}},"required":["data","pagination"],"title":"Products_listSurfaces_Response_200"},"V1ProductsIdSurfacesPostRequestBodyContentApplicationJsonSchemaStatus":{"type":"string","enum":["draft","active","paused"],"title":"V1ProductsIdSurfacesPostRequestBodyContentApplicationJsonSchemaStatus"},"V1ProductsIdSurfacesPostRequestBodyContentApplicationJsonSchemaType":{"type":"string","enum":["chat","mcp","mcp_code","cli","api","webhook","schedule","a2a","email","slack","sms","imessage","discord","whatsapp","telegram","hosted-page","chrome_extension"],"title":"V1ProductsIdSurfacesPostRequestBodyContentApplicationJsonSchemaType"},"V1ProductsIdSurfacesPostResponsesContentApplicationJsonSchemaWarningsItemsSeverity":{"type":"string","enum":["warning","recommendation"],"title":"V1ProductsIdSurfacesPostResponsesContentApplicationJsonSchemaWarningsItemsSeverity"},"V1ProductsIdSurfacesPostResponsesContentApplicationJsonSchemaWarningsItems":{"type":"object","properties":{"code":{"type":"string","description":"Stable advisory code, e.g. `MODEL_NOT_ENABLED` when `behavior.conversationTitles.model` names a model this account cannot run."},"message":{"type":"string"},"path":{"type":"string"},"severity":{"$ref":"#/components/schemas/V1ProductsIdSurfacesPostResponsesContentApplicationJsonSchemaWarningsItemsSeverity"},"suggestedFix":{"type":"string"}},"required":["code","message","path","severity"],"title":"V1ProductsIdSurfacesPostResponsesContentApplicationJsonSchemaWarningsItems"},"Products_createSurface_Response_201":{"type":"object","properties":{"behavior":{"description":"Any type"},"createdAt":{"type":"string"},"endpoint":{"type":["string","null"],"description":"Canonical public URL of this surface (MCP, API, A2A, AG-UI, webhook, chat). Null for surface types reached through their own channels (Slack, email, schedule, ...). Clients should use this instead of constructing the URL themselves."},"id":{"type":"string"},"inbound":{"description":"Any type"},"items":{"type":"array","items":{"description":"Any type"}},"keys":{"type":"array","items":{"description":"Any type"}},"name":{"type":"string"},"outbound":{"description":"Any type"},"productId":{"type":"string"},"status":{"type":"string"},"type":{"type":"string"},"updatedAt":{"type":"string"},"warnings":{"type":"array","items":{"$ref":"#/components/schemas/V1ProductsIdSurfacesPostResponsesContentApplicationJsonSchemaWarningsItems"},"description":"Advisory findings about this surface configuration. Present only when non-empty; never blocks the mutation."},"webhookHealth":{"$ref":"#/components/schemas/WebhookHealth"}},"required":["createdAt","endpoint","id","items","keys","name","productId","status","type","updatedAt","webhookHealth"],"title":"Products_createSurface_Response_201"},"V1ProductsIdSurfacesEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionEnvironment":{"type":"string","enum":["production","development"],"title":"V1ProductsIdSurfacesEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionEnvironment"},"V1ProductsIdSurfacesEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionStatus":{"type":"string","enum":["draft","active","paused"],"title":"V1ProductsIdSurfacesEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionStatus"},"V1ProductsIdSurfacesEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionType":{"type":"string","enum":["chat","mcp","mcp_code","cli","api","webhook","schedule","a2a","email","slack","sms","imessage","discord","whatsapp","telegram","hosted-page","chrome_extension"],"title":"V1ProductsIdSurfacesEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionType"},"V1ProductsIdSurfacesEnsurePostRequestBodyContentApplicationJsonSchemaDefinition":{"type":"object","properties":{"behavior":{"type":"object","additionalProperties":{"description":"Any type"}},"environment":{"$ref":"#/components/schemas/V1ProductsIdSurfacesEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionEnvironment"},"inbound":{"type":["object","null"],"additionalProperties":{"description":"Any type"},"description":"Inbound channel config. Omit to keep the stored value; null clears it. A credential value of \"<redacted>\" (as returned by pull) keeps the stored credential."},"name":{"type":"string","minLength":1,"maxLength":255},"outbound":{"type":["object","null"],"additionalProperties":{"description":"Any type"},"description":"Outbound channel config. Omit to keep the stored value; null clears it. A credential value of \"<redacted>\" (as returned by pull) keeps the stored credential."},"status":{"$ref":"#/components/schemas/V1ProductsIdSurfacesEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionStatus"},"type":{"$ref":"#/components/schemas/V1ProductsIdSurfacesEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionType"}},"required":["name","type"],"title":"V1ProductsIdSurfacesEnsurePostRequestBodyContentApplicationJsonSchemaDefinition"},"V1ProductsIdSurfacesEnsurePostRequestBodyContentApplicationJsonSchemaOnConflict":{"type":"string","enum":["error","overwrite"],"title":"V1ProductsIdSurfacesEnsurePostRequestBodyContentApplicationJsonSchemaOnConflict"},"SurfaceEnsureResponseOneOf0Result":{"type":"string","enum":["unchanged","created","updated"],"title":"SurfaceEnsureResponseOneOf0Result"},"SurfaceEnsureResponse0":{"type":"object","properties":{"contentHash":{"type":"string","description":"Server-computed canonical content hash. Clients should echo this hash in probes."},"result":{"$ref":"#/components/schemas/SurfaceEnsureResponseOneOf0Result"},"sessionsSignedOut":{"type":"integer","description":"Present when the update changed the identity provider or issuer: the number of signed-in sessions it ended."},"surfaceId":{"type":"string"}},"required":["contentHash","result","surfaceId"],"title":"SurfaceEnsureResponse0"},"SurfaceEnsureResponseOneOf1Result":{"type":"string","enum":["definitionRequired"],"title":"SurfaceEnsureResponseOneOf1Result"},"SurfaceEnsureResponse1":{"type":"object","properties":{"result":{"$ref":"#/components/schemas/SurfaceEnsureResponseOneOf1Result"}},"required":["result"],"title":"SurfaceEnsureResponse1"},"SurfaceEnsureResponseOneOf2Changes":{"type":"string","enum":["none","create","update"],"title":"SurfaceEnsureResponseOneOf2Changes"},"SurfaceEnsureResponseOneOf2Result":{"type":"string","enum":["plan"],"title":"SurfaceEnsureResponseOneOf2Result"},"SurfaceEnsureResponse2":{"type":"object","properties":{"changedKeys":{"type":"array","items":{"type":"string"}},"changes":{"$ref":"#/components/schemas/SurfaceEnsureResponseOneOf2Changes"},"contentHash":{"type":"string"},"remoteHash":{"type":"string"},"result":{"$ref":"#/components/schemas/SurfaceEnsureResponseOneOf2Result"},"signsOutSessions":{"type":"boolean","description":"True when applying this plan changes the identity provider or issuer and signs out every session."},"surfaceId":{"type":"string"}},"required":["changedKeys","changes","contentHash","result"],"title":"SurfaceEnsureResponse2"},"SurfaceEnsureResponse":{"oneOf":[{"$ref":"#/components/schemas/SurfaceEnsureResponse0"},{"$ref":"#/components/schemas/SurfaceEnsureResponse1"},{"$ref":"#/components/schemas/SurfaceEnsureResponse2"}],"title":"SurfaceEnsureResponse"},"SurfaceEnsureConflictCode":{"type":"string","enum":["external_modification","remote_changed"],"title":"SurfaceEnsureConflictCode"},"SurfaceEnsureConflict":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/SurfaceEnsureConflictCode"},"currentHash":{"type":["string","null"]},"error":{"type":"string"},"lastModifiedSource":{"type":"string"},"modifiedAt":{"type":["string","null"]}},"required":["code","error"],"title":"SurfaceEnsureConflict"},"SurfaceEnsureHashMismatchCode":{"type":"string","enum":["content_hash_mismatch"],"title":"SurfaceEnsureHashMismatchCode"},"SurfaceEnsureHashMismatch":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/SurfaceEnsureHashMismatchCode"},"contentHash":{"type":"string","description":"The server-computed canonical hash of the submitted definition."},"error":{"type":"string"}},"required":["code","contentHash","error"],"title":"SurfaceEnsureHashMismatch"},"SurfacePullResponseDefinitionEnvironment":{"type":"string","enum":["production","development"],"title":"SurfacePullResponseDefinitionEnvironment"},"SurfacePullResponseDefinitionStatus":{"type":"string","enum":["draft","active","paused"],"title":"SurfacePullResponseDefinitionStatus"},"SurfacePullResponseDefinitionType":{"type":"string","enum":["chat","mcp","mcp_code","cli","api","webhook","schedule","a2a","email","slack","sms","imessage","discord","whatsapp","telegram","hosted-page","chrome_extension"],"title":"SurfacePullResponseDefinitionType"},"SurfacePullResponseDefinition":{"type":"object","properties":{"behavior":{"type":"object","additionalProperties":{"description":"Any type"}},"environment":{"$ref":"#/components/schemas/SurfacePullResponseDefinitionEnvironment"},"inbound":{"type":["object","null"],"additionalProperties":{"description":"Any type"},"description":"Inbound channel config. Omit to keep the stored value; null clears it. A credential value of \"<redacted>\" (as returned by pull) keeps the stored credential."},"name":{"type":"string","minLength":1,"maxLength":255},"outbound":{"type":["object","null"],"additionalProperties":{"description":"Any type"},"description":"Outbound channel config. Omit to keep the stored value; null clears it. A credential value of \"<redacted>\" (as returned by pull) keeps the stored credential."},"status":{"$ref":"#/components/schemas/SurfacePullResponseDefinitionStatus"},"type":{"$ref":"#/components/schemas/SurfacePullResponseDefinitionType"}},"required":["name","type"],"title":"SurfacePullResponseDefinition"},"SurfacePullResponse":{"type":"object","properties":{"contentHash":{"type":"string"},"definition":{"$ref":"#/components/schemas/SurfacePullResponseDefinition"},"lastModifiedSource":{"type":["string","null"]},"surfaceId":{"type":"string"},"updatedAt":{"type":["string","null"]}},"required":["contentHash","definition","lastModifiedSource","surfaceId","updatedAt"],"title":"SurfacePullResponse"},"V1ProductsIdSurfacesSurfaceIdGetResponsesContentApplicationJsonSchemaItemsItems":{"type":"object","properties":{"agentId":{"type":["string","null"]},"agentType":{"type":["string","null"]},"cachedSkills":{"type":["array","null"],"items":{"description":"Any type"}},"capabilityId":{"type":"string"},"capabilityName":{"type":["string","null"]},"config":{"description":"Any type"},"createdAt":{"type":"string"},"displayOrder":{"type":["integer","null"]},"enabled":{"type":"boolean"},"endpointSlug":{"type":["string","null"]},"exposedDescription":{"type":["string","null"]},"exposedName":{"type":["string","null"]},"flowId":{"type":["string","null"]},"id":{"type":"string"},"isEntryPoint":{"type":"boolean"},"parametersSchema":{"description":"Any type"}},"required":["agentId","agentType","cachedSkills","capabilityId","capabilityName","createdAt","displayOrder","enabled","endpointSlug","exposedDescription","exposedName","flowId","id","isEntryPoint"],"title":"V1ProductsIdSurfacesSurfaceIdGetResponsesContentApplicationJsonSchemaItemsItems"},"V1ProductsIdSurfacesSurfaceIdGetResponsesContentApplicationJsonSchemaKeysItems":{"type":"object","properties":{"canReveal":{"type":"boolean"},"createdAt":{"type":"string"},"environment":{"type":"string"},"expiresAt":{"type":["string","null"]},"id":{"type":"string"},"isActive":{"type":"boolean"},"isDevelopment":{"type":"boolean"},"keyHint":{"type":["string","null"]},"keyPrefix":{"type":"string"},"lastUsedAt":{"type":["string","null"]},"name":{"type":["string","null"]},"rateLimitPerDay":{"type":["integer","null"]},"rateLimitPerMinute":{"type":["integer","null"]},"scopeTargetIds":{"type":["array","null"],"items":{"type":"string"}},"scopes":{"type":"array","items":{"type":"string"}},"usageCount":{"type":["integer","null"]}},"required":["canReveal","createdAt","environment","expiresAt","id","isActive","isDevelopment","keyHint","keyPrefix","lastUsedAt","name","rateLimitPerDay","rateLimitPerMinute","scopeTargetIds","scopes","usageCount"],"title":"V1ProductsIdSurfacesSurfaceIdGetResponsesContentApplicationJsonSchemaKeysItems"},"V1ProductsIdSurfacesSurfaceIdGetResponsesContentApplicationJsonSchemaScopeTargetsItems":{"type":"object","properties":{"capabilityId":{"type":"string"},"id":{"type":"string"},"name":{"type":"string"},"surfaceItemId":{"type":"string"}},"required":["id","name"],"title":"V1ProductsIdSurfacesSurfaceIdGetResponsesContentApplicationJsonSchemaScopeTargetsItems"},"Products_getSurfaceDetails_Response_200":{"type":"object","properties":{"behavior":{"description":"Any type"},"createdAt":{"type":"string"},"endpoint":{"type":["string","null"],"description":"Canonical public URL of this surface (MCP, API, A2A, AG-UI, webhook, chat). Null for surface types reached through their own channels (Slack, email, schedule, ...). Clients should use this instead of constructing the URL themselves."},"id":{"type":"string"},"inbound":{"description":"Any type"},"items":{"type":"array","items":{"$ref":"#/components/schemas/V1ProductsIdSurfacesSurfaceIdGetResponsesContentApplicationJsonSchemaItemsItems"}},"keys":{"type":"array","items":{"$ref":"#/components/schemas/V1ProductsIdSurfacesSurfaceIdGetResponsesContentApplicationJsonSchemaKeysItems"}},"lastModifiedSource":{"type":["string","null"]},"name":{"type":"string"},"outbound":{"description":"Any type"},"productId":{"type":"string"},"scopeTargets":{"type":"array","items":{"$ref":"#/components/schemas/V1ProductsIdSurfacesSurfaceIdGetResponsesContentApplicationJsonSchemaScopeTargetsItems"}},"status":{"type":"string"},"type":{"type":"string"},"updatedAt":{"type":"string"},"webhookHealth":{"$ref":"#/components/schemas/WebhookHealth"}},"required":["createdAt","endpoint","id","items","keys","lastModifiedSource","name","productId","scopeTargets","status","type","updatedAt","webhookHealth"],"title":"Products_getSurfaceDetails_Response_200"},"V1ProductsIdSurfacesSurfaceIdPutRequestBodyContentApplicationJsonSchemaStatus":{"type":"string","enum":["draft","active","paused"],"title":"V1ProductsIdSurfacesSurfaceIdPutRequestBodyContentApplicationJsonSchemaStatus"},"V1ProductsIdSurfacesSurfaceIdPutResponsesContentApplicationJsonSchemaWarningsItemsSeverity":{"type":"string","enum":["warning","recommendation"],"title":"V1ProductsIdSurfacesSurfaceIdPutResponsesContentApplicationJsonSchemaWarningsItemsSeverity"},"V1ProductsIdSurfacesSurfaceIdPutResponsesContentApplicationJsonSchemaWarningsItems":{"type":"object","properties":{"code":{"type":"string","description":"Stable advisory code, e.g. `MODEL_NOT_ENABLED` when `behavior.conversationTitles.model` names a model this account cannot run."},"message":{"type":"string"},"path":{"type":"string"},"severity":{"$ref":"#/components/schemas/V1ProductsIdSurfacesSurfaceIdPutResponsesContentApplicationJsonSchemaWarningsItemsSeverity"},"suggestedFix":{"type":"string"}},"required":["code","message","path","severity"],"title":"V1ProductsIdSurfacesSurfaceIdPutResponsesContentApplicationJsonSchemaWarningsItems"},"Products_updateSurface_Response_200":{"type":"object","properties":{"behavior":{"description":"Any type"},"createdAt":{"type":"string"},"endpoint":{"type":["string","null"],"description":"Canonical public URL of this surface (MCP, API, A2A, AG-UI, webhook, chat). Null for surface types reached through their own channels (Slack, email, schedule, ...). Clients should use this instead of constructing the URL themselves."},"id":{"type":"string"},"inbound":{"description":"Any type"},"name":{"type":"string"},"outbound":{"description":"Any type"},"productId":{"type":"string"},"status":{"type":"string"},"type":{"type":"string"},"updatedAt":{"type":"string"},"warnings":{"type":"array","items":{"$ref":"#/components/schemas/V1ProductsIdSurfacesSurfaceIdPutResponsesContentApplicationJsonSchemaWarningsItems"},"description":"Advisory findings about this surface configuration. Present only when non-empty; never blocks the mutation."},"webhookHealth":{"$ref":"#/components/schemas/WebhookHealth"}},"required":["createdAt","endpoint","id","name","productId","status","type","updatedAt","webhookHealth"],"title":"Products_updateSurface_Response_200"},"Products_deleteSurface_Response_200":{"type":"object","properties":{"success":{"type":"boolean"}},"required":["success"],"title":"Products_deleteSurface_Response_200"},"Products_setTheAnsweringCapabilityOfAChatSurface_Response_200":{"type":"object","properties":{"capabilityId":{"type":"string"},"itemId":{"type":"string"}},"required":["capabilityId","itemId"],"title":"Products_setTheAnsweringCapabilityOfAChatSurface_Response_200"},"V1ProductsIdSurfacesSurfaceIdItemsPostRequestBodyContentApplicationJsonSchemaPresentationDisplayMode":{"type":"string","enum":["chat","form","document"],"title":"V1ProductsIdSurfacesSurfaceIdItemsPostRequestBodyContentApplicationJsonSchemaPresentationDisplayMode"},"V1ProductsIdSurfacesSurfaceIdItemsPostRequestBodyContentApplicationJsonSchemaPresentationFormConfig":{"type":"object","properties":{"inputSchemaOverrides":{"type":"object","additionalProperties":{"description":"Any type"}},"submitButtonLabel":{"type":"string"},"successMessage":{"type":"string"}},"title":"V1ProductsIdSurfacesSurfaceIdItemsPostRequestBodyContentApplicationJsonSchemaPresentationFormConfig"},"V1ProductsIdSurfacesSurfaceIdItemsPostRequestBodyContentApplicationJsonSchemaPresentationVisibility":{"type":"string","enum":["public","auth-only"],"default":"auth-only","title":"V1ProductsIdSurfacesSurfaceIdItemsPostRequestBodyContentApplicationJsonSchemaPresentationVisibility"},"V1ProductsIdSurfacesSurfaceIdItemsPostRequestBodyContentApplicationJsonSchemaPresentation":{"type":"object","properties":{"displayIcon":{"type":"string"},"displayLabel":{"type":"string","minLength":1,"maxLength":120},"displayMode":{"$ref":"#/components/schemas/V1ProductsIdSurfacesSurfaceIdItemsPostRequestBodyContentApplicationJsonSchemaPresentationDisplayMode"},"displayOrder":{"type":"integer","minimum":0,"default":0},"formConfig":{"$ref":"#/components/schemas/V1ProductsIdSurfacesSurfaceIdItemsPostRequestBodyContentApplicationJsonSchemaPresentationFormConfig"},"isDefault":{"type":"boolean","default":false},"route":{"type":"string","pattern":"^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$","minLength":1,"maxLength":80},"visibility":{"$ref":"#/components/schemas/V1ProductsIdSurfacesSurfaceIdItemsPostRequestBodyContentApplicationJsonSchemaPresentationVisibility","default":"auth-only"}},"required":["displayLabel","displayMode","route"],"title":"V1ProductsIdSurfacesSurfaceIdItemsPostRequestBodyContentApplicationJsonSchemaPresentation"},"V1ProductsIdSurfacesSurfaceIdItemsPostResponsesContentApplicationJsonSchemaWarningsItemsSeverity":{"type":"string","enum":["warning","recommendation"],"title":"V1ProductsIdSurfacesSurfaceIdItemsPostResponsesContentApplicationJsonSchemaWarningsItemsSeverity"},"V1ProductsIdSurfacesSurfaceIdItemsPostResponsesContentApplicationJsonSchemaWarningsItems":{"type":"object","properties":{"code":{"type":"string","description":"Stable advisory code: `APPROVAL_UNANSWERABLE_ON_SURFACE` when an approval-gated agent is bound to a surface with no human to answer the prompt, or `APPROVAL_REPLY_CAPTURE_ON_SURFACE` when the pairing works but the decision is read from the reply the person texts back."},"message":{"type":"string"},"path":{"type":"string"},"severity":{"$ref":"#/components/schemas/V1ProductsIdSurfacesSurfaceIdItemsPostResponsesContentApplicationJsonSchemaWarningsItemsSeverity"},"suggestedFix":{"type":"string"}},"required":["code","message","path","severity"],"title":"V1ProductsIdSurfacesSurfaceIdItemsPostResponsesContentApplicationJsonSchemaWarningsItems"},"Products_addItemToSurface_Response_201":{"type":"object","properties":{"capabilityId":{"type":"string"},"createdAt":{"type":"string"},"displayOrder":{"type":["integer","null"]},"enabled":{"type":"boolean"},"endpointSlug":{"type":["string","null"]},"exposedDescription":{"type":["string","null"]},"exposedName":{"type":["string","null"]},"id":{"type":"string"},"isEntryPoint":{"type":"boolean"},"surfaceId":{"type":"string"},"warnings":{"type":"array","items":{"$ref":"#/components/schemas/V1ProductsIdSurfacesSurfaceIdItemsPostResponsesContentApplicationJsonSchemaWarningsItems"},"description":"Advisory findings about this binding. Present only when non-empty; never blocks the mutation."}},"required":["capabilityId","createdAt","displayOrder","enabled","endpointSlug","exposedDescription","exposedName","id","isEntryPoint","surfaceId"],"title":"Products_addItemToSurface_Response_201"},"V1ProductsIdSurfacesSurfaceIdItemsItemIdPutRequestBodyContentApplicationJsonSchemaPresentationDisplayMode":{"type":"string","enum":["chat","form","document"],"title":"V1ProductsIdSurfacesSurfaceIdItemsItemIdPutRequestBodyContentApplicationJsonSchemaPresentationDisplayMode"},"V1ProductsIdSurfacesSurfaceIdItemsItemIdPutRequestBodyContentApplicationJsonSchemaPresentationFormConfig":{"type":"object","properties":{"inputSchemaOverrides":{"type":"object","additionalProperties":{"description":"Any type"}},"submitButtonLabel":{"type":"string"},"successMessage":{"type":"string"}},"title":"V1ProductsIdSurfacesSurfaceIdItemsItemIdPutRequestBodyContentApplicationJsonSchemaPresentationFormConfig"},"V1ProductsIdSurfacesSurfaceIdItemsItemIdPutRequestBodyContentApplicationJsonSchemaPresentationVisibility":{"type":"string","enum":["public","auth-only"],"default":"auth-only","title":"V1ProductsIdSurfacesSurfaceIdItemsItemIdPutRequestBodyContentApplicationJsonSchemaPresentationVisibility"},"V1ProductsIdSurfacesSurfaceIdItemsItemIdPutRequestBodyContentApplicationJsonSchemaPresentation":{"type":"object","properties":{"displayIcon":{"type":"string"},"displayLabel":{"type":"string","minLength":1,"maxLength":120},"displayMode":{"$ref":"#/components/schemas/V1ProductsIdSurfacesSurfaceIdItemsItemIdPutRequestBodyContentApplicationJsonSchemaPresentationDisplayMode"},"displayOrder":{"type":"integer","minimum":0,"default":0},"formConfig":{"$ref":"#/components/schemas/V1ProductsIdSurfacesSurfaceIdItemsItemIdPutRequestBodyContentApplicationJsonSchemaPresentationFormConfig"},"isDefault":{"type":"boolean","default":false},"route":{"type":"string","pattern":"^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$","minLength":1,"maxLength":80},"visibility":{"$ref":"#/components/schemas/V1ProductsIdSurfacesSurfaceIdItemsItemIdPutRequestBodyContentApplicationJsonSchemaPresentationVisibility","default":"auth-only"}},"required":["displayLabel","displayMode","route"],"title":"V1ProductsIdSurfacesSurfaceIdItemsItemIdPutRequestBodyContentApplicationJsonSchemaPresentation"},"V1ProductsIdSurfacesSurfaceIdItemsItemIdPutResponsesContentApplicationJsonSchemaWarningsItemsSeverity":{"type":"string","enum":["warning","recommendation"],"title":"V1ProductsIdSurfacesSurfaceIdItemsItemIdPutResponsesContentApplicationJsonSchemaWarningsItemsSeverity"},"V1ProductsIdSurfacesSurfaceIdItemsItemIdPutResponsesContentApplicationJsonSchemaWarningsItems":{"type":"object","properties":{"code":{"type":"string","description":"Stable advisory code: `APPROVAL_UNANSWERABLE_ON_SURFACE` when an approval-gated agent is bound to a surface with no human to answer the prompt, or `APPROVAL_REPLY_CAPTURE_ON_SURFACE` when the pairing works but the decision is read from the reply the person texts back."},"message":{"type":"string"},"path":{"type":"string"},"severity":{"$ref":"#/components/schemas/V1ProductsIdSurfacesSurfaceIdItemsItemIdPutResponsesContentApplicationJsonSchemaWarningsItemsSeverity"},"suggestedFix":{"type":"string"}},"required":["code","message","path","severity"],"title":"V1ProductsIdSurfacesSurfaceIdItemsItemIdPutResponsesContentApplicationJsonSchemaWarningsItems"},"Products_updateSurfaceItem_Response_200":{"type":"object","properties":{"capabilityId":{"type":"string"},"config":{"description":"Any type"},"createdAt":{"type":"string"},"displayOrder":{"type":["integer","null"]},"enabled":{"type":"boolean"},"endpointSlug":{"type":["string","null"]},"exposedDescription":{"type":["string","null"]},"exposedName":{"type":["string","null"]},"id":{"type":"string"},"isEntryPoint":{"type":"boolean"},"surfaceId":{"type":"string"},"warnings":{"type":"array","items":{"$ref":"#/components/schemas/V1ProductsIdSurfacesSurfaceIdItemsItemIdPutResponsesContentApplicationJsonSchemaWarningsItems"},"description":"Advisory findings about this binding. Present only when non-empty; never blocks the mutation."}},"required":["capabilityId","createdAt","displayOrder","enabled","endpointSlug","exposedDescription","exposedName","id","isEntryPoint","surfaceId"],"title":"Products_updateSurfaceItem_Response_200"},"Products_removeSurfaceItem_Response_200":{"type":"object","properties":{"success":{"type":"boolean"}},"required":["success"],"title":"Products_removeSurfaceItem_Response_200"},"V1ProductsIdSurfacesSurfaceIdKeysPostRequestBodyContentApplicationJsonSchemaEnvironment":{"type":"string","enum":["test","production"],"default":"test","title":"V1ProductsIdSurfacesSurfaceIdKeysPostRequestBodyContentApplicationJsonSchemaEnvironment"},"Products_createSurfaceApiKey_Response_201":{"type":"object","properties":{"createdAt":{"type":"string"},"environment":{"type":"string"},"expiresAt":{"type":["string","null"]},"id":{"type":"string"},"isActive":{"type":"boolean"},"key":{"type":"string"},"keyHint":{"type":["string","null"]},"keyPrefix":{"type":"string"},"name":{"type":["string","null"]},"rateLimitPerDay":{"type":["integer","null"]},"rateLimitPerMinute":{"type":["integer","null"]},"scopeTargetIds":{"type":"array","items":{"type":"string"}},"scopes":{"type":"array","items":{"type":"string"}},"surfaceId":{"type":"string"}},"required":["createdAt","environment","expiresAt","id","isActive","key","keyHint","keyPrefix","name","rateLimitPerDay","rateLimitPerMinute","scopeTargetIds","scopes","surfaceId"],"title":"Products_createSurfaceApiKey_Response_201"},"Products_deleteSurfaceApiKey_Response_200":{"type":"object","properties":{"success":{"type":"boolean"}},"required":["success"],"title":"Products_deleteSurfaceApiKey_Response_200"},"V1ProductsIdSurfacesSurfaceIdKeysKeyIdRevealGetResponsesContentApplicationJsonSchemaMetadata":{"type":"object","properties":{"createdVia":{"type":["string","null"]},"environment":{"type":"string"},"lifetimeExecutions":{"type":["integer","null"]},"surfaceType":{"type":["string","null"]}},"required":["createdVia","environment","lifetimeExecutions","surfaceType"],"title":"V1ProductsIdSurfacesSurfaceIdKeysKeyIdRevealGetResponsesContentApplicationJsonSchemaMetadata"},"Products_revealTestSurfaceKey_Response_200":{"type":"object","properties":{"key":{"type":"string"},"metadata":{"$ref":"#/components/schemas/V1ProductsIdSurfacesSurfaceIdKeysKeyIdRevealGetResponsesContentApplicationJsonSchemaMetadata"},"warning":{"type":"string"}},"required":["key","metadata","warning"],"title":"Products_revealTestSurfaceKey_Response_200"},"V1ProductsIdSurfacesSurfaceIdSchedulesGetResponsesContentApplicationJsonSchemaDataItems":{"type":"object","properties":{"agentId":{"type":["string","null"]},"createdAt":{"type":"string"},"cron":{"type":["string","null"]},"enabled":{"type":"boolean"},"executionOptions":{"type":"object","additionalProperties":{"description":"Any type"}},"flowId":{"type":["string","null"]},"flowName":{"type":["string","null"]},"id":{"type":"string"},"inputs":{"type":["object","null"],"additionalProperties":{"description":"Any type"}},"lastRunAt":{"type":["string","null"]},"messages":{"description":"Any type"},"name":{"type":["string","null"]},"nextRunAt":{"type":["string","null"]},"organizationId":{"type":["string","null"]},"productSurfaceId":{"type":["string","null"]},"recordFilter":{"description":"Any type"},"recordIds":{"type":["array","null"],"items":{"type":"string"}},"recordType":{"type":["string","null"]},"runAt":{"type":["string","null"]},"timezone":{"type":["string","null"]},"triggerType":{"type":"string"},"updatedAt":{"type":"string"},"userId":{"type":"string"}},"required":["agentId","createdAt","cron","enabled","executionOptions","flowId","flowName","id","inputs","lastRunAt","name","nextRunAt","organizationId","productSurfaceId","recordIds","recordType","runAt","timezone","triggerType","updatedAt","userId"],"title":"V1ProductsIdSurfacesSurfaceIdSchedulesGetResponsesContentApplicationJsonSchemaDataItems"},"Products_listSchedulesForSurface_Response_200":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1ProductsIdSurfacesSurfaceIdSchedulesGetResponsesContentApplicationJsonSchemaDataItems"}}},"required":["data"],"title":"Products_listSchedulesForSurface_Response_200"},"V1ProductsIdSurfacesSurfaceIdSchedulesPostRequestBodyContentApplicationJsonSchemaExecutionOptionsLoggingPolicy":{"type":"string","enum":["default","on","off"],"title":"V1ProductsIdSurfacesSurfaceIdSchedulesPostRequestBodyContentApplicationJsonSchemaExecutionOptionsLoggingPolicy"},"V1ProductsIdSurfacesSurfaceIdSchedulesPostRequestBodyContentApplicationJsonSchemaExecutionOptions":{"type":"object","properties":{"chunkSize":{"type":"integer","minimum":1,"maximum":250},"flowTimeoutMs":{"type":"integer","minimum":1000,"maximum":900000},"loggingPolicy":{"$ref":"#/components/schemas/V1ProductsIdSurfacesSurfaceIdSchedulesPostRequestBodyContentApplicationJsonSchemaExecutionOptionsLoggingPolicy"},"maxRetries":{"type":"integer","minimum":0,"maximum":10},"modelOverride":{"type":"string"},"progressFlushSize":{"type":"integer","minimum":1,"maximum":100},"recordConcurrency":{"type":"integer","minimum":1,"maximum":50},"skipCacheWarm":{"type":"boolean"},"stepTimeoutMs":{"type":"integer","minimum":1000,"maximum":600000},"timeoutMs":{"type":"integer","minimum":60000,"maximum":1800000}},"title":"V1ProductsIdSurfacesSurfaceIdSchedulesPostRequestBodyContentApplicationJsonSchemaExecutionOptions"},"RecordFilterConditionOp":{"type":"string","enum":["eq","neq","gt","gte","lt","lte","between","contains","startsWith","endsWith","in","notIn","isSet","isNotSet","isTrue","isFalse","withinLastDays","olderThanDays"],"title":"RecordFilterConditionOp"},"RecordFilterCondition":{"type":"object","properties":{"field":{"type":"string","pattern":"^[a-zA-Z0-9_][a-zA-Z0-9_.-]{0,63}$"},"op":{"$ref":"#/components/schemas/RecordFilterConditionOp"},"value":{"description":"Any type"}},"required":["field","op"],"title":"RecordFilterCondition"},"V1ProductsIdSurfacesSurfaceIdSchedulesPostRequestBodyContentApplicationJsonSchemaRecordFilterWhereOneOf1ConditionsItemsOneOf1Op":{"type":"string","enum":["and","or"],"title":"V1ProductsIdSurfacesSurfaceIdSchedulesPostRequestBodyContentApplicationJsonSchemaRecordFilterWhereOneOf1ConditionsItemsOneOf1Op"},"V1ProductsIdSurfacesSurfaceIdSchedulesPostRequestBodyContentApplicationJsonSchemaRecordFilterWhereOneOf1ConditionsItems1":{"type":"object","properties":{"conditions":{"type":"array","items":{"$ref":"#/components/schemas/RecordFilterCondition"}},"op":{"$ref":"#/components/schemas/V1ProductsIdSurfacesSurfaceIdSchedulesPostRequestBodyContentApplicationJsonSchemaRecordFilterWhereOneOf1ConditionsItemsOneOf1Op"}},"required":["conditions","op"],"title":"V1ProductsIdSurfacesSurfaceIdSchedulesPostRequestBodyContentApplicationJsonSchemaRecordFilterWhereOneOf1ConditionsItems1"},"V1ProductsIdSurfacesSurfaceIdSchedulesPostRequestBodyContentApplicationJsonSchemaRecordFilterWhereOneOf1ConditionsItems":{"oneOf":[{"$ref":"#/components/schemas/RecordFilterCondition"},{"$ref":"#/components/schemas/V1ProductsIdSurfacesSurfaceIdSchedulesPostRequestBodyContentApplicationJsonSchemaRecordFilterWhereOneOf1ConditionsItems1"}],"title":"V1ProductsIdSurfacesSurfaceIdSchedulesPostRequestBodyContentApplicationJsonSchemaRecordFilterWhereOneOf1ConditionsItems"},"V1ProductsIdSurfacesSurfaceIdSchedulesPostRequestBodyContentApplicationJsonSchemaRecordFilterWhereOneOf1Op":{"type":"string","enum":["and","or"],"title":"V1ProductsIdSurfacesSurfaceIdSchedulesPostRequestBodyContentApplicationJsonSchemaRecordFilterWhereOneOf1Op"},"V1ProductsIdSurfacesSurfaceIdSchedulesPostRequestBodyContentApplicationJsonSchemaRecordFilterWhere1":{"type":"object","properties":{"conditions":{"type":"array","items":{"$ref":"#/components/schemas/V1ProductsIdSurfacesSurfaceIdSchedulesPostRequestBodyContentApplicationJsonSchemaRecordFilterWhereOneOf1ConditionsItems"}},"op":{"$ref":"#/components/schemas/V1ProductsIdSurfacesSurfaceIdSchedulesPostRequestBodyContentApplicationJsonSchemaRecordFilterWhereOneOf1Op"}},"required":["conditions","op"],"title":"V1ProductsIdSurfacesSurfaceIdSchedulesPostRequestBodyContentApplicationJsonSchemaRecordFilterWhere1"},"V1ProductsIdSurfacesSurfaceIdSchedulesPostRequestBodyContentApplicationJsonSchemaRecordFilterWhere":{"oneOf":[{"$ref":"#/components/schemas/RecordFilterCondition"},{"$ref":"#/components/schemas/V1ProductsIdSurfacesSurfaceIdSchedulesPostRequestBodyContentApplicationJsonSchemaRecordFilterWhere1"}],"title":"V1ProductsIdSurfacesSurfaceIdSchedulesPostRequestBodyContentApplicationJsonSchemaRecordFilterWhere"},"V1ProductsIdSurfacesSurfaceIdSchedulesPostRequestBodyContentApplicationJsonSchemaRecordFilter":{"type":"object","properties":{"type":{"type":"string","minLength":1,"maxLength":255},"where":{"$ref":"#/components/schemas/V1ProductsIdSurfacesSurfaceIdSchedulesPostRequestBodyContentApplicationJsonSchemaRecordFilterWhere"}},"required":["type"],"title":"V1ProductsIdSurfacesSurfaceIdSchedulesPostRequestBodyContentApplicationJsonSchemaRecordFilter"},"V1ProductsIdSurfacesSurfaceIdSchedulesPostRequestBodyContentApplicationJsonSchemaTriggerType":{"type":"string","enum":["one_time","recurring"],"title":"V1ProductsIdSurfacesSurfaceIdSchedulesPostRequestBodyContentApplicationJsonSchemaTriggerType"},"Products_createScheduleForSurface_Response_201":{"type":"object","properties":{"agentId":{"type":["string","null"]},"createdAt":{"type":"string"},"cron":{"type":["string","null"]},"enabled":{"type":"boolean"},"executionOptions":{"type":"object","additionalProperties":{"description":"Any type"}},"flowId":{"type":["string","null"]},"id":{"type":"string"},"inputs":{"type":["object","null"],"additionalProperties":{"description":"Any type"}},"lastRunAt":{"type":["string","null"]},"messages":{"description":"Any type"},"name":{"type":["string","null"]},"nextRunAt":{"type":["string","null"]},"organizationId":{"type":["string","null"]},"productSurfaceId":{"type":["string","null"]},"recordFilter":{"description":"Any type"},"recordIds":{"type":["array","null"],"items":{"type":"string"}},"recordType":{"type":["string","null"]},"runAt":{"type":["string","null"]},"timezone":{"type":["string","null"]},"triggerType":{"type":"string"},"updatedAt":{"type":"string"},"userId":{"type":"string"}},"required":["agentId","createdAt","cron","enabled","executionOptions","flowId","id","inputs","lastRunAt","name","nextRunAt","organizationId","productSurfaceId","recordIds","recordType","runAt","timezone","triggerType","updatedAt","userId"],"title":"Products_createScheduleForSurface_Response_201"},"ScheduleValidationErrorDetailsItems":{"type":"object","properties":{"code":{"type":"string","description":"Stable Runtype validation code (e.g. MISSING_REQUIRED_FIELD, INVALID_ENUM)."},"message":{"type":"string"},"path":{"type":"string","description":"Dotted JSON path to the offending field."},"suggestion":{"type":"string","description":"Actionable hint (allowed values, accepted range, …)."}},"required":["message"],"title":"ScheduleValidationErrorDetailsItems"},"ScheduleValidationError":{"type":"object","properties":{"code":{"type":"string","description":"Stable error code. SCHEDULE_AGENT_CONFIG_UNSUPPORTED: the target agent uses config a schedule cannot supply; `details[].path` names it. RUNTIME_LANE_INELIGIBLE: the target flow uses capabilities the batch host cannot run; `reasons` names them. SCHEDULE_ONE_TIME_ELAPSED: a resumed one-time schedule has no future `runAt` to fire at."},"details":{"type":"array","items":{"$ref":"#/components/schemas/ScheduleValidationErrorDetailsItems"}},"error":{"type":"string"},"requiredScopes":{"type":"array","items":{"type":"string"},"description":"On `insufficient_scope`: every API key scope this request needs."},"message":{"type":"string","description":"Human-readable error message."},"reasons":{"type":"array","items":{"type":"string"},"description":"With RUNTIME_LANE_INELIGIBLE: stable `ineligible:*` reason codes, e.g. `ineligible:wait-until`."}},"required":["error"],"title":"ScheduleValidationError"},"V1ProductsIdSurfacesSurfaceIdSchedulesScheduleIdGetResponsesContentApplicationJsonSchemaRecentRunsItems":{"type":"object","properties":{"batchExecutionId":{"type":["string","null"]},"completedAt":{"type":["string","null"]},"createdAt":{"type":"string"},"error":{"type":["string","null"]},"id":{"type":"string"},"startedAt":{"type":["string","null"]},"status":{"type":"string"}},"required":["batchExecutionId","completedAt","createdAt","error","id","startedAt","status"],"title":"V1ProductsIdSurfacesSurfaceIdSchedulesScheduleIdGetResponsesContentApplicationJsonSchemaRecentRunsItems"},"Products_getScheduleDetails_Response_200":{"type":"object","properties":{"agentId":{"type":["string","null"]},"createdAt":{"type":"string"},"cron":{"type":["string","null"]},"enabled":{"type":"boolean"},"executionOptions":{"type":"object","additionalProperties":{"description":"Any type"}},"flowId":{"type":["string","null"]},"flowName":{"type":["string","null"]},"id":{"type":"string"},"inputs":{"type":["object","null"],"additionalProperties":{"description":"Any type"}},"lastRunAt":{"type":["string","null"]},"messages":{"description":"Any type"},"name":{"type":["string","null"]},"nextRunAt":{"type":["string","null"]},"organizationId":{"type":["string","null"]},"productSurfaceId":{"type":["string","null"]},"recentRuns":{"type":"array","items":{"$ref":"#/components/schemas/V1ProductsIdSurfacesSurfaceIdSchedulesScheduleIdGetResponsesContentApplicationJsonSchemaRecentRunsItems"}},"recordFilter":{"description":"Any type"},"recordIds":{"type":["array","null"],"items":{"type":"string"}},"recordType":{"type":["string","null"]},"runAt":{"type":["string","null"]},"timezone":{"type":["string","null"]},"triggerType":{"type":"string"},"updatedAt":{"type":"string"},"userId":{"type":"string"}},"required":["agentId","createdAt","cron","enabled","executionOptions","flowId","flowName","id","inputs","lastRunAt","name","nextRunAt","organizationId","productSurfaceId","recentRuns","recordIds","recordType","runAt","timezone","triggerType","updatedAt","userId"],"title":"Products_getScheduleDetails_Response_200"},"V1ProductsIdSurfacesSurfaceIdSchedulesScheduleIdPutRequestBodyContentApplicationJsonSchemaExecutionOptionsLoggingPolicy":{"type":"string","enum":["default","on","off"],"title":"V1ProductsIdSurfacesSurfaceIdSchedulesScheduleIdPutRequestBodyContentApplicationJsonSchemaExecutionOptionsLoggingPolicy"},"V1ProductsIdSurfacesSurfaceIdSchedulesScheduleIdPutRequestBodyContentApplicationJsonSchemaExecutionOptions":{"type":"object","properties":{"chunkSize":{"type":"integer","minimum":1,"maximum":250},"flowTimeoutMs":{"type":"integer","minimum":1000,"maximum":900000},"loggingPolicy":{"$ref":"#/components/schemas/V1ProductsIdSurfacesSurfaceIdSchedulesScheduleIdPutRequestBodyContentApplicationJsonSchemaExecutionOptionsLoggingPolicy"},"maxRetries":{"type":"integer","minimum":0,"maximum":10},"modelOverride":{"type":"string"},"progressFlushSize":{"type":"integer","minimum":1,"maximum":100},"recordConcurrency":{"type":"integer","minimum":1,"maximum":50},"skipCacheWarm":{"type":"boolean"},"stepTimeoutMs":{"type":"integer","minimum":1000,"maximum":600000},"timeoutMs":{"type":"integer","minimum":60000,"maximum":1800000}},"title":"V1ProductsIdSurfacesSurfaceIdSchedulesScheduleIdPutRequestBodyContentApplicationJsonSchemaExecutionOptions"},"V1ProductsIdSurfacesSurfaceIdSchedulesScheduleIdPutRequestBodyContentApplicationJsonSchemaRecordFilterWhereOneOf1ConditionsItemsOneOf1Op":{"type":"string","enum":["and","or"],"title":"V1ProductsIdSurfacesSurfaceIdSchedulesScheduleIdPutRequestBodyContentApplicationJsonSchemaRecordFilterWhereOneOf1ConditionsItemsOneOf1Op"},"V1ProductsIdSurfacesSurfaceIdSchedulesScheduleIdPutRequestBodyContentApplicationJsonSchemaRecordFilterWhereOneOf1ConditionsItems1":{"type":"object","properties":{"conditions":{"type":"array","items":{"$ref":"#/components/schemas/RecordFilterCondition"}},"op":{"$ref":"#/components/schemas/V1ProductsIdSurfacesSurfaceIdSchedulesScheduleIdPutRequestBodyContentApplicationJsonSchemaRecordFilterWhereOneOf1ConditionsItemsOneOf1Op"}},"required":["conditions","op"],"title":"V1ProductsIdSurfacesSurfaceIdSchedulesScheduleIdPutRequestBodyContentApplicationJsonSchemaRecordFilterWhereOneOf1ConditionsItems1"},"V1ProductsIdSurfacesSurfaceIdSchedulesScheduleIdPutRequestBodyContentApplicationJsonSchemaRecordFilterWhereOneOf1ConditionsItems":{"oneOf":[{"$ref":"#/components/schemas/RecordFilterCondition"},{"$ref":"#/components/schemas/V1ProductsIdSurfacesSurfaceIdSchedulesScheduleIdPutRequestBodyContentApplicationJsonSchemaRecordFilterWhereOneOf1ConditionsItems1"}],"title":"V1ProductsIdSurfacesSurfaceIdSchedulesScheduleIdPutRequestBodyContentApplicationJsonSchemaRecordFilterWhereOneOf1ConditionsItems"},"V1ProductsIdSurfacesSurfaceIdSchedulesScheduleIdPutRequestBodyContentApplicationJsonSchemaRecordFilterWhereOneOf1Op":{"type":"string","enum":["and","or"],"title":"V1ProductsIdSurfacesSurfaceIdSchedulesScheduleIdPutRequestBodyContentApplicationJsonSchemaRecordFilterWhereOneOf1Op"},"V1ProductsIdSurfacesSurfaceIdSchedulesScheduleIdPutRequestBodyContentApplicationJsonSchemaRecordFilterWhere1":{"type":"object","properties":{"conditions":{"type":"array","items":{"$ref":"#/components/schemas/V1ProductsIdSurfacesSurfaceIdSchedulesScheduleIdPutRequestBodyContentApplicationJsonSchemaRecordFilterWhereOneOf1ConditionsItems"}},"op":{"$ref":"#/components/schemas/V1ProductsIdSurfacesSurfaceIdSchedulesScheduleIdPutRequestBodyContentApplicationJsonSchemaRecordFilterWhereOneOf1Op"}},"required":["conditions","op"],"title":"V1ProductsIdSurfacesSurfaceIdSchedulesScheduleIdPutRequestBodyContentApplicationJsonSchemaRecordFilterWhere1"},"V1ProductsIdSurfacesSurfaceIdSchedulesScheduleIdPutRequestBodyContentApplicationJsonSchemaRecordFilterWhere":{"oneOf":[{"$ref":"#/components/schemas/RecordFilterCondition"},{"$ref":"#/components/schemas/V1ProductsIdSurfacesSurfaceIdSchedulesScheduleIdPutRequestBodyContentApplicationJsonSchemaRecordFilterWhere1"}],"title":"V1ProductsIdSurfacesSurfaceIdSchedulesScheduleIdPutRequestBodyContentApplicationJsonSchemaRecordFilterWhere"},"V1ProductsIdSurfacesSurfaceIdSchedulesScheduleIdPutRequestBodyContentApplicationJsonSchemaRecordFilter":{"type":"object","properties":{"type":{"type":"string","minLength":1,"maxLength":255},"where":{"$ref":"#/components/schemas/V1ProductsIdSurfacesSurfaceIdSchedulesScheduleIdPutRequestBodyContentApplicationJsonSchemaRecordFilterWhere"}},"required":["type"],"title":"V1ProductsIdSurfacesSurfaceIdSchedulesScheduleIdPutRequestBodyContentApplicationJsonSchemaRecordFilter"},"V1ProductsIdSurfacesSurfaceIdSchedulesScheduleIdPutRequestBodyContentApplicationJsonSchemaTriggerType":{"type":"string","enum":["one_time","recurring"],"title":"V1ProductsIdSurfacesSurfaceIdSchedulesScheduleIdPutRequestBodyContentApplicationJsonSchemaTriggerType"},"Products_updateSchedule_Response_200":{"type":"object","properties":{"agentId":{"type":["string","null"]},"createdAt":{"type":"string"},"cron":{"type":["string","null"]},"enabled":{"type":"boolean"},"executionOptions":{"type":"object","additionalProperties":{"description":"Any type"}},"flowId":{"type":["string","null"]},"id":{"type":"string"},"inputs":{"type":["object","null"],"additionalProperties":{"description":"Any type"}},"lastRunAt":{"type":["string","null"]},"messages":{"description":"Any type"},"name":{"type":["string","null"]},"nextRunAt":{"type":["string","null"]},"organizationId":{"type":["string","null"]},"productSurfaceId":{"type":["string","null"]},"recordFilter":{"description":"Any type"},"recordIds":{"type":["array","null"],"items":{"type":"string"}},"recordType":{"type":["string","null"]},"runAt":{"type":["string","null"]},"timezone":{"type":["string","null"]},"triggerType":{"type":"string"},"updatedAt":{"type":"string"},"userId":{"type":"string"}},"required":["agentId","createdAt","cron","enabled","executionOptions","flowId","id","inputs","lastRunAt","name","nextRunAt","organizationId","productSurfaceId","recordIds","recordType","runAt","timezone","triggerType","updatedAt","userId"],"title":"Products_updateSchedule_Response_200"},"Products_deleteSchedule_Response_200":{"type":"object","properties":{"success":{"type":"boolean"}},"required":["success"],"title":"Products_deleteSchedule_Response_200"},"Products_pauseSchedule_Response_200":{"type":"object","properties":{"status":{"type":"string"}},"required":["status"],"title":"Products_pauseSchedule_Response_200"},"Products_resumeSchedule_Response_200":{"type":"object","properties":{"status":{"type":"string"}},"required":["status"],"title":"Products_resumeSchedule_Response_200"},"Products_runScheduleImmediately_Response_200":{"type":"object","properties":{"batchExecutionId":{"type":"string"},"recordCount":{"type":"integer"},"status":{"type":"string"}},"required":["batchExecutionId","recordCount","status"],"title":"Products_runScheduleImmediately_Response_200"},"SurfaceSession":{"type":"object","properties":{"clientId":{"type":"string","description":"The MCP client the user authorized."},"createdAt":{"type":"string","format":"date-time"},"email":{"type":"string"},"endUserCredentialId":{"type":"string"},"expiresAt":{"type":"string","format":"date-time","description":"When the current refresh token expires."},"lastRefreshedAt":{"type":"string","format":"date-time"},"sessionId":{"type":"string","description":"The refresh-token family; revoking it ends the session."}},"required":["clientId","createdAt","email","endUserCredentialId","expiresAt","lastRefreshedAt","sessionId"],"title":"SurfaceSession"},"Products_listSignedInSurfaceSessions_Response_200":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/SurfaceSession"}},"nextCursor":{"type":["string","null"],"description":"Pass as `cursor` to read the next page; null on the last page."}},"required":["data","nextCursor"],"title":"Products_listSignedInSurfaceSessions_Response_200"},"Products_revokeASignedInSurfaceSession_Response_200":{"type":"object","properties":{"success":{"type":"boolean"}},"required":["success"],"title":"Products_revokeASignedInSurfaceSession_Response_200"},"V1ProductsIdSurfacesSurfaceIdSetupGetResponsesContentApplicationJsonSchemaState":{"type":"string","enum":["ready","needs_setup"],"title":"V1ProductsIdSurfacesSurfaceIdSetupGetResponsesContentApplicationJsonSchemaState"},"V1ProductsIdSurfacesSurfaceIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsAlternativesItemsOneOf0Rung":{"type":"string","enum":["mcp_tool"],"title":"V1ProductsIdSurfacesSurfaceIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsAlternativesItemsOneOf0Rung"},"V1ProductsIdSurfacesSurfaceIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsAlternativesItems0":{"type":"object","properties":{"args":{"type":"object","additionalProperties":{"description":"Any type"}},"pendingArgs":{"type":"object","additionalProperties":{"type":"string"}},"rung":{"$ref":"#/components/schemas/V1ProductsIdSurfacesSurfaceIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsAlternativesItemsOneOf0Rung"},"summary":{"type":"string"},"tool":{"type":"string"}},"required":["args","rung","summary","tool"],"title":"V1ProductsIdSurfacesSurfaceIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsAlternativesItems0"},"V1ProductsIdSurfacesSurfaceIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsAlternativesItemsOneOf1Method":{"type":"string","enum":["PATCH","POST","PUT"],"title":"V1ProductsIdSurfacesSurfaceIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsAlternativesItemsOneOf1Method"},"V1ProductsIdSurfacesSurfaceIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsAlternativesItemsOneOf1Rung":{"type":"string","enum":["rest"],"title":"V1ProductsIdSurfacesSurfaceIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsAlternativesItemsOneOf1Rung"},"V1ProductsIdSurfacesSurfaceIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsAlternativesItems1":{"type":"object","properties":{"endpoint":{"type":"string"},"method":{"$ref":"#/components/schemas/V1ProductsIdSurfacesSurfaceIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsAlternativesItemsOneOf1Method"},"rung":{"$ref":"#/components/schemas/V1ProductsIdSurfacesSurfaceIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsAlternativesItemsOneOf1Rung"},"summary":{"type":"string"}},"required":["endpoint","method","rung","summary"],"title":"V1ProductsIdSurfacesSurfaceIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsAlternativesItems1"},"V1ProductsIdSurfacesSurfaceIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsAlternativesItemsOneOf2Rung":{"type":"string","enum":["browser"],"title":"V1ProductsIdSurfacesSurfaceIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsAlternativesItemsOneOf2Rung"},"V1ProductsIdSurfacesSurfaceIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsAlternativesItems2":{"type":"object","properties":{"reason":{"type":"string"},"rung":{"$ref":"#/components/schemas/V1ProductsIdSurfacesSurfaceIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsAlternativesItemsOneOf2Rung"},"summary":{"type":"string"},"url":{"type":"string"}},"required":["reason","rung","summary","url"],"title":"V1ProductsIdSurfacesSurfaceIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsAlternativesItems2"},"V1ProductsIdSurfacesSurfaceIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsAlternativesItemsOneOf3Rung":{"type":"string","enum":["satisfied"],"title":"V1ProductsIdSurfacesSurfaceIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsAlternativesItemsOneOf3Rung"},"V1ProductsIdSurfacesSurfaceIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsAlternativesItems3":{"type":"object","properties":{"rung":{"$ref":"#/components/schemas/V1ProductsIdSurfacesSurfaceIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsAlternativesItemsOneOf3Rung"}},"required":["rung"],"title":"V1ProductsIdSurfacesSurfaceIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsAlternativesItems3"},"V1ProductsIdSurfacesSurfaceIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsAlternativesItems":{"oneOf":[{"$ref":"#/components/schemas/V1ProductsIdSurfacesSurfaceIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsAlternativesItems0"},{"$ref":"#/components/schemas/V1ProductsIdSurfacesSurfaceIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsAlternativesItems1"},{"$ref":"#/components/schemas/V1ProductsIdSurfacesSurfaceIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsAlternativesItems2"},{"$ref":"#/components/schemas/V1ProductsIdSurfacesSurfaceIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsAlternativesItems3"}],"title":"V1ProductsIdSurfacesSurfaceIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsAlternativesItems"},"V1ProductsIdSurfacesSurfaceIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsFulfillmentOneOf0Rung":{"type":"string","enum":["mcp_tool"],"title":"V1ProductsIdSurfacesSurfaceIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsFulfillmentOneOf0Rung"},"V1ProductsIdSurfacesSurfaceIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsFulfillment0":{"type":"object","properties":{"args":{"type":"object","additionalProperties":{"description":"Any type"}},"pendingArgs":{"type":"object","additionalProperties":{"type":"string"}},"rung":{"$ref":"#/components/schemas/V1ProductsIdSurfacesSurfaceIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsFulfillmentOneOf0Rung"},"summary":{"type":"string"},"tool":{"type":"string"}},"required":["args","rung","summary","tool"],"title":"V1ProductsIdSurfacesSurfaceIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsFulfillment0"},"V1ProductsIdSurfacesSurfaceIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsFulfillmentOneOf1Method":{"type":"string","enum":["PATCH","POST","PUT"],"title":"V1ProductsIdSurfacesSurfaceIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsFulfillmentOneOf1Method"},"V1ProductsIdSurfacesSurfaceIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsFulfillmentOneOf1Rung":{"type":"string","enum":["rest"],"title":"V1ProductsIdSurfacesSurfaceIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsFulfillmentOneOf1Rung"},"V1ProductsIdSurfacesSurfaceIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsFulfillment1":{"type":"object","properties":{"endpoint":{"type":"string"},"method":{"$ref":"#/components/schemas/V1ProductsIdSurfacesSurfaceIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsFulfillmentOneOf1Method"},"rung":{"$ref":"#/components/schemas/V1ProductsIdSurfacesSurfaceIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsFulfillmentOneOf1Rung"},"summary":{"type":"string"}},"required":["endpoint","method","rung","summary"],"title":"V1ProductsIdSurfacesSurfaceIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsFulfillment1"},"V1ProductsIdSurfacesSurfaceIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsFulfillmentOneOf2Rung":{"type":"string","enum":["browser"],"title":"V1ProductsIdSurfacesSurfaceIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsFulfillmentOneOf2Rung"},"V1ProductsIdSurfacesSurfaceIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsFulfillment2":{"type":"object","properties":{"reason":{"type":"string"},"rung":{"$ref":"#/components/schemas/V1ProductsIdSurfacesSurfaceIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsFulfillmentOneOf2Rung"},"summary":{"type":"string"},"url":{"type":"string"}},"required":["reason","rung","summary","url"],"title":"V1ProductsIdSurfacesSurfaceIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsFulfillment2"},"V1ProductsIdSurfacesSurfaceIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsFulfillmentOneOf3Rung":{"type":"string","enum":["satisfied"],"title":"V1ProductsIdSurfacesSurfaceIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsFulfillmentOneOf3Rung"},"V1ProductsIdSurfacesSurfaceIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsFulfillment3":{"type":"object","properties":{"rung":{"$ref":"#/components/schemas/V1ProductsIdSurfacesSurfaceIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsFulfillmentOneOf3Rung"}},"required":["rung"],"title":"V1ProductsIdSurfacesSurfaceIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsFulfillment3"},"V1ProductsIdSurfacesSurfaceIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsFulfillment":{"oneOf":[{"$ref":"#/components/schemas/V1ProductsIdSurfacesSurfaceIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsFulfillment0"},{"$ref":"#/components/schemas/V1ProductsIdSurfacesSurfaceIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsFulfillment1"},{"$ref":"#/components/schemas/V1ProductsIdSurfacesSurfaceIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsFulfillment2"},{"$ref":"#/components/schemas/V1ProductsIdSurfacesSurfaceIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsFulfillment3"}],"title":"V1ProductsIdSurfacesSurfaceIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsFulfillment"},"V1ProductsIdSurfacesSurfaceIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsKind":{"type":"string","enum":["secret","surface_install"],"title":"V1ProductsIdSurfacesSurfaceIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsKind"},"V1ProductsIdSurfacesSurfaceIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsStatus":{"type":"string","enum":["satisfied","pending"],"title":"V1ProductsIdSurfacesSurfaceIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsStatus"},"V1ProductsIdSurfacesSurfaceIdSetupGetResponsesContentApplicationJsonSchemaStepsItems":{"type":"object","properties":{"alternatives":{"type":"array","items":{"$ref":"#/components/schemas/V1ProductsIdSurfacesSurfaceIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsAlternativesItems"}},"docsUrl":{"type":"string"},"fulfillment":{"$ref":"#/components/schemas/V1ProductsIdSurfacesSurfaceIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsFulfillment"},"helpText":{"type":"string"},"id":{"type":"string"},"kind":{"$ref":"#/components/schemas/V1ProductsIdSurfacesSurfaceIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsKind"},"required":{"type":"boolean"},"secretKey":{"type":"string"},"status":{"$ref":"#/components/schemas/V1ProductsIdSurfacesSurfaceIdSetupGetResponsesContentApplicationJsonSchemaStepsItemsStatus"},"surfaceId":{"type":"string"},"surfaceType":{"type":"string"},"title":{"type":"string"}},"required":["fulfillment","id","kind","required","status","title"],"title":"V1ProductsIdSurfacesSurfaceIdSetupGetResponsesContentApplicationJsonSchemaStepsItems"},"Products_getSurfaceSetupReadiness_Response_200":{"type":"object","properties":{"name":{"type":"string"},"pendingCount":{"type":"integer","minimum":0},"state":{"$ref":"#/components/schemas/V1ProductsIdSurfacesSurfaceIdSetupGetResponsesContentApplicationJsonSchemaState"},"steps":{"type":"array","items":{"$ref":"#/components/schemas/V1ProductsIdSurfacesSurfaceIdSetupGetResponsesContentApplicationJsonSchemaStepsItems"}},"surfaceId":{"type":"string"},"surfaceType":{"type":"string"}},"required":["name","pendingCount","state","steps","surfaceId","surfaceType"],"title":"Products_getSurfaceSetupReadiness_Response_200"},"CliPreviewBuiltinsItems":{"type":"object","properties":{"command":{"type":"string"},"description":{"type":"string"}},"required":["command","description"],"title":"CliPreviewBuiltinsItems"},"CliPreviewFlag":{"type":"object","properties":{"default":{"description":"The schema default, when it declares one"},"description":{"type":"string","description":"The first sentence of the argument's description; empty when it has none"},"enum":{"type":"array","items":{"description":"Any type"},"description":"The accepted values of an enum argument"},"name":{"type":"string","description":"The flag without its leading `--`, e.g. `ticket-id`"},"positional":{"type":"boolean","description":"Also accepted as a positional argument"},"repeatable":{"type":"boolean","description":"Takes the flag more than once, one value each time"},"required":{"type":"boolean"},"type":{"type":"string","description":"A TypeScript-style type, as the signature line prints it, e.g. `\"open\" | \"closed\"`"},"wire":{"type":"string","description":"The tool argument the flag sets, e.g. `ticketId`"}},"required":["description","name","positional","repeatable","required","type","wire"],"title":"CliPreviewFlag"},"CliPreviewCommand":{"type":"object","properties":{"aliases":{"type":"array","items":{"type":"string"},"description":"Other paths that reach the command, e.g. the hyphenated name"},"callOnly":{"type":"boolean","description":"The tool shares its name with a built-in, so only `<bin> call <tool>` reaches it"},"command":{"type":"string","description":"The command path after the command name, e.g. `search_tickets` or `call login`"},"example":{"type":"string","description":"A runnable example invocation with every required flag"},"flags":{"type":"array","items":{"$ref":"#/components/schemas/CliPreviewFlag"},"description":"The flags `<bin> <command> --help` lists, in order"},"help":{"type":"string","description":"The exact text `<bin> <command> --help` prints"},"hidden":{"type":"boolean","description":"A command override hides it from `--help`; it still runs"},"placeholderDescription":{"type":"boolean","description":"The description is the `Execute the <tool> capability` default a capability without a description gets"},"summary":{"type":"string","description":"The first sentence of the description, as `--help` lists it"},"tool":{"type":"string","description":"The MCP tool the command calls"},"usage":{"type":"string","description":"The usage line, e.g. `acme search_tickets <query> [flags]`"}},"required":["aliases","callOnly","command","example","flags","help","hidden","placeholderDescription","summary","tool","usage"],"title":"CliPreviewCommand"},"CliPreviewPublishChangesCommandsAddedItems":{"type":"object","properties":{"command":{"type":"string"},"tool":{"type":"string"}},"required":["command","tool"],"title":"CliPreviewPublishChangesCommandsAddedItems"},"CliPreviewPublishChangesCommandsChangedItemsFieldsItems":{"type":"string","enum":["name","aliases","hidden","description","flags"],"title":"CliPreviewPublishChangesCommandsChangedItemsFieldsItems"},"CliPreviewPublishChangesCommandsChangedItems":{"type":"object","properties":{"command":{"type":"string"},"fields":{"type":"array","items":{"$ref":"#/components/schemas/CliPreviewPublishChangesCommandsChangedItemsFieldsItems"}},"tool":{"type":"string"}},"required":["command","fields","tool"],"title":"CliPreviewPublishChangesCommandsChangedItems"},"CliPreviewPublishChangesCommandsRemovedItems":{"type":"object","properties":{"command":{"type":"string"},"tool":{"type":"string"}},"required":["command","tool"],"title":"CliPreviewPublishChangesCommandsRemovedItems"},"CliPreviewPublishChangesSettingsItems":{"type":"string","enum":["binName","displayName","authMode","installDomain","other"],"title":"CliPreviewPublishChangesSettingsItems"},"CliPreviewPublishChanges":{"type":"object","properties":{"commandsAdded":{"type":"array","items":{"$ref":"#/components/schemas/CliPreviewPublishChangesCommandsAddedItems"}},"commandsChanged":{"type":"array","items":{"$ref":"#/components/schemas/CliPreviewPublishChangesCommandsChangedItems"}},"commandsRemoved":{"type":"array","items":{"$ref":"#/components/schemas/CliPreviewPublishChangesCommandsRemovedItems"}},"settings":{"type":"array","items":{"$ref":"#/components/schemas/CliPreviewPublishChangesSettingsItems"},"description":"`binName`: the published version is under another command name. `installDomain`: the requested install domain differs from the last publish. `other`: the files differ in a way no listed setting or command explains, such as a newer installer."}},"required":["commandsAdded","commandsChanged","commandsRemoved","settings"],"description":"What a publish would change; null while unpublished","title":"CliPreviewPublishChanges"},"CliPreviewPublishState":{"type":"string","enum":["unpublished","published","changesNotPublished"],"description":"`unpublished`: the install host serves nothing for this surface. `published`: it serves exactly what a publish would write now. `changesNotPublished`: the saved surface differs from the published version.","title":"CliPreviewPublishState"},"CliPreviewPublish":{"type":"object","properties":{"changes":{"oneOf":[{"$ref":"#/components/schemas/CliPreviewPublishChanges"},{"type":"null"}],"description":"What a publish would change; null while unpublished"},"digest":{"type":"string","description":"The digest a publish of the saved surface would record"},"publishedAt":{"type":["string","null"]},"publishedDigest":{"type":["string","null"],"description":"The digest the published version recorded; null while unpublished"},"state":{"$ref":"#/components/schemas/CliPreviewPublishState","description":"`unpublished`: the install host serves nothing for this surface. `published`: it serves exactly what a publish would write now. `changesNotPublished`: the saved surface differs from the published version."},"version":{"type":["string","null"],"description":"The published version; null while unpublished"}},"required":["changes","digest","publishedAt","publishedDigest","state","version"],"title":"CliPreviewPublish"},"CliPreview":{"type":"object","properties":{"binName":{"type":"string","description":"The command name the preview renders, which is also the install slug"},"builtins":{"type":"array","items":{"$ref":"#/components/schemas/CliPreviewBuiltinsItems"},"description":"The built-in commands every CLI has, as `--help` lists them"},"commands":{"type":"array","items":{"$ref":"#/components/schemas/CliPreviewCommand"},"description":"One entry per tool command, hidden ones included, sorted by command path"},"displayName":{"type":"string","description":"The name `--help` opens with: the product name"},"help":{"type":"string","description":"The exact text `<bin> --help` prints"},"publish":{"$ref":"#/components/schemas/CliPreviewPublish"},"skill":{"type":"string","description":"The SKILL.md a publish writes and `<bin> skill install` installs"}},"required":["binName","builtins","commands","displayName","help","publish","skill"],"title":"CliPreview"},"V1ProductsProductIdSurfacesSurfaceIdCliPreviewGetResponsesContentApplicationJsonSchemaIssuesItemsVerdict":{"type":"string","enum":["review","reject"],"title":"V1ProductsProductIdSurfacesSurfaceIdCliPreviewGetResponsesContentApplicationJsonSchemaIssuesItemsVerdict"},"V1ProductsProductIdSurfacesSurfaceIdCliPreviewGetResponsesContentApplicationJsonSchemaIssuesItems":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"verdict":{"$ref":"#/components/schemas/V1ProductsProductIdSurfacesSurfaceIdCliPreviewGetResponsesContentApplicationJsonSchemaIssuesItemsVerdict"}},"required":["code","message","verdict"],"title":"V1ProductsProductIdSurfacesSurfaceIdCliPreviewGetResponsesContentApplicationJsonSchemaIssuesItems"},"PreviewACliSurfaceRequestBadRequestError":{"type":"object","properties":{"code":{"type":"string"},"error":{"type":"string"},"issues":{"type":"array","items":{"$ref":"#/components/schemas/V1ProductsProductIdSurfacesSurfaceIdCliPreviewGetResponsesContentApplicationJsonSchemaIssuesItems"}}},"required":["error"],"title":"PreviewACliSurfaceRequestBadRequestError"},"PreviewACliSurfaceRequestForbiddenError":{"type":"object","properties":{"code":{"type":"string"},"error":{"type":"string"},"issues":{"type":"array","items":{"$ref":"#/components/schemas/V1ProductsProductIdSurfacesSurfaceIdCliPreviewGetResponsesContentApplicationJsonSchemaIssuesItems"}}},"required":["error"],"title":"PreviewACliSurfaceRequestForbiddenError"},"PreviewACliSurfaceRequestBadGatewayError":{"type":"object","properties":{"code":{"type":"string"},"error":{"type":"string"},"issues":{"type":"array","items":{"$ref":"#/components/schemas/V1ProductsProductIdSurfacesSurfaceIdCliPreviewGetResponsesContentApplicationJsonSchemaIssuesItems"}}},"required":["error"],"title":"PreviewACliSurfaceRequestBadGatewayError"},"PreviewACliSurfaceRequestServiceUnavailableError":{"type":"object","properties":{"code":{"type":"string"},"error":{"type":"string"},"issues":{"type":"array","items":{"$ref":"#/components/schemas/V1ProductsProductIdSurfacesSurfaceIdCliPreviewGetResponsesContentApplicationJsonSchemaIssuesItems"}}},"required":["error"],"title":"PreviewACliSurfaceRequestServiceUnavailableError"},"CliInstallCommands":{"type":"object","properties":{"powershell":{"type":"string","description":"The Windows install command: `irm <url>/install.ps1 | iex`"},"sh":{"type":"string","description":"The macOS and Linux install command: `curl -fsSL <url> | sh`"},"url":{"type":"string","description":"`GET` serves the POSIX install script, e.g. `https://get.runtype.com/<slug>`"}},"required":["powershell","sh","url"],"title":"CliInstallCommands"},"CliInstallDomainFiles":{"type":"object","properties":{"SKILL.md":{"type":"string"},"cli.json":{"type":"string"},"install.ps1":{"type":"string"},"install.sh":{"type":"string"}},"required":["SKILL.md","cli.json","install.ps1","install.sh"],"description":"Each file the domain serves at its root, as the Runtype install host serves it; copy them to serve the domain yourself","title":"CliInstallDomainFiles"},"CliInstallDomainState":{"type":"string","enum":["pending","verified"],"description":"`verified`: the TXT record proved control of the domain, and the published files point at it. `pending`: the CLI installs from the Runtype install host until the TXT record is found on a later publish.","title":"CliInstallDomainState"},"CliInstallDomainVerification":{"type":"object","properties":{"recordName":{"type":"string","description":"The TXT record name, `_runtype-install.<domain>`"},"recordValue":{"type":"string","description":"The TXT record value: this surface's verification token"}},"required":["recordName","recordValue"],"description":"The TXT record that verifies the domain; null until a publish has issued the token","title":"CliInstallDomainVerification"},"CliInstallDomain":{"type":"object","properties":{"cnameTarget":{"type":"string","description":"The host a CNAME for `domain` points at when Runtype serves the domain"},"domain":{"type":"string","description":"The custom install domain the surface asks for, e.g. `get.acme.com`"},"files":{"$ref":"#/components/schemas/CliInstallDomainFiles","description":"Each file the domain serves at its root, as the Runtype install host serves it; copy them to serve the domain yourself"},"state":{"$ref":"#/components/schemas/CliInstallDomainState","description":"`verified`: the TXT record proved control of the domain, and the published files point at it. `pending`: the CLI installs from the Runtype install host until the TXT record is found on a later publish."},"verification":{"oneOf":[{"$ref":"#/components/schemas/CliInstallDomainVerification"},{"type":"null"}],"description":"The TXT record that verifies the domain; null until a publish has issued the token"}},"required":["cnameTarget","domain","files","state","verification"],"description":"The custom install domain the surface asks for and whether it is verified; null when it asks for none","title":"CliInstallDomain"},"CliPublishStatusState":{"type":"string","enum":["not_published","published"],"description":"`published`: the install host serves this surface's files under its slug. `not_published`: nothing is published, the surface has no valid command name, or another surface holds the slug.","title":"CliPublishStatusState"},"CliPublishStatus":{"type":"object","properties":{"install":{"$ref":"#/components/schemas/CliInstallCommands"},"installDomain":{"$ref":"#/components/schemas/CliInstallDomain"},"publishedAt":{"type":["string","null"],"description":"When the files last changed"},"slug":{"type":["string","null"],"description":"The install slug, which is the surface's command name; null while it has none"},"state":{"$ref":"#/components/schemas/CliPublishStatusState","description":"`published`: the install host serves this surface's files under its slug. `not_published`: nothing is published, the surface has no valid command name, or another surface holds the slug."},"version":{"type":["string","null"],"description":"The version in the published `cli.json`"}},"required":["install","installDomain","publishedAt","slug","state","version"],"title":"CliPublishStatus"},"V1ProductsProductIdSurfacesSurfaceIdCliPublishGetResponsesContentApplicationJsonSchemaIssuesItemsVerdict":{"type":"string","enum":["review","reject"],"title":"V1ProductsProductIdSurfacesSurfaceIdCliPublishGetResponsesContentApplicationJsonSchemaIssuesItemsVerdict"},"V1ProductsProductIdSurfacesSurfaceIdCliPublishGetResponsesContentApplicationJsonSchemaIssuesItems":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"verdict":{"$ref":"#/components/schemas/V1ProductsProductIdSurfacesSurfaceIdCliPublishGetResponsesContentApplicationJsonSchemaIssuesItemsVerdict"}},"required":["code","message","verdict"],"title":"V1ProductsProductIdSurfacesSurfaceIdCliPublishGetResponsesContentApplicationJsonSchemaIssuesItems"},"GetCliPublishStatusRequestBadRequestError":{"type":"object","properties":{"code":{"type":"string"},"error":{"type":"string"},"issues":{"type":"array","items":{"$ref":"#/components/schemas/V1ProductsProductIdSurfacesSurfaceIdCliPublishGetResponsesContentApplicationJsonSchemaIssuesItems"}}},"required":["error"],"title":"GetCliPublishStatusRequestBadRequestError"},"GetCliPublishStatusRequestForbiddenError":{"type":"object","properties":{"code":{"type":"string"},"error":{"type":"string"},"issues":{"type":"array","items":{"$ref":"#/components/schemas/V1ProductsProductIdSurfacesSurfaceIdCliPublishGetResponsesContentApplicationJsonSchemaIssuesItems"}}},"required":["error"],"title":"GetCliPublishStatusRequestForbiddenError"},"GetCliPublishStatusRequestBadGatewayError":{"type":"object","properties":{"code":{"type":"string"},"error":{"type":"string"},"issues":{"type":"array","items":{"$ref":"#/components/schemas/V1ProductsProductIdSurfacesSurfaceIdCliPublishGetResponsesContentApplicationJsonSchemaIssuesItems"}}},"required":["error"],"title":"GetCliPublishStatusRequestBadGatewayError"},"GetCliPublishStatusRequestServiceUnavailableError":{"type":"object","properties":{"code":{"type":"string"},"error":{"type":"string"},"issues":{"type":"array","items":{"$ref":"#/components/schemas/V1ProductsProductIdSurfacesSurfaceIdCliPublishGetResponsesContentApplicationJsonSchemaIssuesItems"}}},"required":["error"],"title":"GetCliPublishStatusRequestServiceUnavailableError"},"CliPublishResultOutcome":{"type":"string","enum":["published","unchanged"],"description":"`unchanged`: the files match the last publish, so the version stays; every file is still rewritten","title":"CliPublishResultOutcome"},"CliPublishResult":{"type":"object","properties":{"install":{"$ref":"#/components/schemas/CliInstallCommands"},"installDomain":{"$ref":"#/components/schemas/CliInstallDomain"},"outcome":{"$ref":"#/components/schemas/CliPublishResultOutcome","description":"`unchanged`: the files match the last publish, so the version stays; every file is still rewritten"},"publishedAt":{"type":"string"},"slug":{"type":"string"},"version":{"type":"string"}},"required":["install","installDomain","outcome","publishedAt","slug","version"],"title":"CliPublishResult"},"V1ProductsProductIdSurfacesSurfaceIdCliPublishPostResponsesContentApplicationJsonSchemaIssuesItemsVerdict":{"type":"string","enum":["review","reject"],"title":"V1ProductsProductIdSurfacesSurfaceIdCliPublishPostResponsesContentApplicationJsonSchemaIssuesItemsVerdict"},"V1ProductsProductIdSurfacesSurfaceIdCliPublishPostResponsesContentApplicationJsonSchemaIssuesItems":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"verdict":{"$ref":"#/components/schemas/V1ProductsProductIdSurfacesSurfaceIdCliPublishPostResponsesContentApplicationJsonSchemaIssuesItemsVerdict"}},"required":["code","message","verdict"],"title":"V1ProductsProductIdSurfacesSurfaceIdCliPublishPostResponsesContentApplicationJsonSchemaIssuesItems"},"PublishACliSurfaceRequestBadRequestError":{"type":"object","properties":{"code":{"type":"string"},"error":{"type":"string"},"issues":{"type":"array","items":{"$ref":"#/components/schemas/V1ProductsProductIdSurfacesSurfaceIdCliPublishPostResponsesContentApplicationJsonSchemaIssuesItems"}}},"required":["error"],"title":"PublishACliSurfaceRequestBadRequestError"},"PublishACliSurfaceRequestForbiddenError":{"type":"object","properties":{"code":{"type":"string"},"error":{"type":"string"},"issues":{"type":"array","items":{"$ref":"#/components/schemas/V1ProductsProductIdSurfacesSurfaceIdCliPublishPostResponsesContentApplicationJsonSchemaIssuesItems"}}},"required":["error"],"title":"PublishACliSurfaceRequestForbiddenError"},"PublishACliSurfaceRequestConflictError":{"type":"object","properties":{"code":{"type":"string"},"error":{"type":"string"},"issues":{"type":"array","items":{"$ref":"#/components/schemas/V1ProductsProductIdSurfacesSurfaceIdCliPublishPostResponsesContentApplicationJsonSchemaIssuesItems"}}},"required":["error"],"title":"PublishACliSurfaceRequestConflictError"},"PublishACliSurfaceRequestBadGatewayError":{"type":"object","properties":{"code":{"type":"string"},"error":{"type":"string"},"issues":{"type":"array","items":{"$ref":"#/components/schemas/V1ProductsProductIdSurfacesSurfaceIdCliPublishPostResponsesContentApplicationJsonSchemaIssuesItems"}}},"required":["error"],"title":"PublishACliSurfaceRequestBadGatewayError"},"PublishACliSurfaceRequestServiceUnavailableError":{"type":"object","properties":{"code":{"type":"string"},"error":{"type":"string"},"issues":{"type":"array","items":{"$ref":"#/components/schemas/V1ProductsProductIdSurfacesSurfaceIdCliPublishPostResponsesContentApplicationJsonSchemaIssuesItems"}}},"required":["error"],"title":"PublishACliSurfaceRequestServiceUnavailableError"},"ConfigureWebhookFromDocumentationRequestNotImplementedError":{"type":"object","properties":{"error":{"type":"string"},"eventHint":{"type":["string","null"]},"message":{"type":"string"},"url":{"type":"string"}},"required":["error","eventHint","message","url"],"title":"ConfigureWebhookFromDocumentationRequestNotImplementedError"},"Webhook_Management_inferSchemaFromJsonPayload_Response_200":{"type":"object","properties":{"jsonSchema":{"description":"Any type"},"learningState":{"type":"string"},"mappingSuggestions":{"type":"array","items":{"description":"Any type"}},"schema":{"description":"Any type"}},"required":["learningState","mappingSuggestions"],"title":"Webhook Management_inferSchemaFromJsonPayload_Response_200"},"Webhook_Management_toggleWebhookLearningMode_Response_200":{"type":"object","properties":{"learningState":{"type":"string"},"observationCount":{"type":"number","format":"double"}},"required":["learningState","observationCount"],"title":"Webhook Management_toggleWebhookLearningMode_Response_200"},"V1ProductsIdSurfacesSurfaceIdWebhookMappingsGetResponsesContentApplicationJsonSchemaItemsItems":{"type":"object","properties":{"capabilityId":{"type":"string"},"exposedName":{"type":["string","null"]},"fieldMappings":{"type":"array","items":{"description":"Any type"}},"id":{"type":"string"}},"required":["capabilityId","exposedName","fieldMappings","id"],"title":"V1ProductsIdSurfacesSurfaceIdWebhookMappingsGetResponsesContentApplicationJsonSchemaItemsItems"},"Webhook_Management_getWebhookFieldMappings_Response_200":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/V1ProductsIdSurfacesSurfaceIdWebhookMappingsGetResponsesContentApplicationJsonSchemaItemsItems"}}},"required":["items"],"title":"Webhook Management_getWebhookFieldMappings_Response_200"},"V1ProductsIdSurfacesSurfaceIdWebhookMappingsPutRequestBodyContentApplicationJsonSchemaMappingsItemsType":{"type":"string","enum":["string","number","boolean","json"],"title":"V1ProductsIdSurfacesSurfaceIdWebhookMappingsPutRequestBodyContentApplicationJsonSchemaMappingsItemsType"},"V1ProductsIdSurfacesSurfaceIdWebhookMappingsPutRequestBodyContentApplicationJsonSchemaMappingsItems":{"type":"object","properties":{"defaultValue":{"description":"Any type"},"source":{"type":"string","minLength":1},"target":{"type":"string","minLength":1},"transform":{"type":"string"},"type":{"$ref":"#/components/schemas/V1ProductsIdSurfacesSurfaceIdWebhookMappingsPutRequestBodyContentApplicationJsonSchemaMappingsItemsType"}},"required":["source","target"],"title":"V1ProductsIdSurfacesSurfaceIdWebhookMappingsPutRequestBodyContentApplicationJsonSchemaMappingsItems"},"Webhook_Management_updateWebhookFieldMappings_Response_200":{"type":"object","properties":{"fieldMappings":{"type":"array","items":{"description":"Any type"}},"id":{"type":"string"}},"required":["fieldMappings","id"],"title":"Webhook Management_updateWebhookFieldMappings_Response_200"},"V1ProductsIdSurfacesSurfaceIdWebhookObservationsGetResponsesContentApplicationJsonSchemaObservationsItems":{"type":"object","properties":{},"title":"V1ProductsIdSurfacesSurfaceIdWebhookObservationsGetResponsesContentApplicationJsonSchemaObservationsItems"},"Webhook_Management_listWebhookObservations_Response_200":{"type":"object","properties":{"learningState":{"type":"string"},"observationCount":{"type":"number","format":"double"},"observations":{"type":"array","items":{"$ref":"#/components/schemas/V1ProductsIdSurfacesSurfaceIdWebhookObservationsGetResponsesContentApplicationJsonSchemaObservationsItems"}}},"required":["learningState","observationCount","observations"],"title":"Webhook Management_listWebhookObservations_Response_200"},"Webhook_Management_clearWebhookObservations_Response_200":{"type":"object","properties":{"success":{"type":"boolean"}},"required":["success"],"title":"Webhook Management_clearWebhookObservations_Response_200"},"Webhook_Management_getEventRoutingConfiguration_Response_200":{"type":"object","properties":{"eventRouting":{"description":"Any type"}},"title":"Webhook Management_getEventRoutingConfiguration_Response_200"},"Webhook_Management_updateEventRoutingConfiguration_Response_200":{"type":"object","properties":{"eventRouting":{"description":"Any type"}},"title":"Webhook Management_updateEventRoutingConfiguration_Response_200"},"Webhook_Management_getWebhookSchema_Response_200":{"type":"object","properties":{"confirmedSchema":{"description":"Any type"},"learningState":{"type":"string"},"proposedSchema":{"description":"Any type"},"schemaConfirmedAt":{"type":["string","null"]}},"required":["learningState","schemaConfirmedAt"],"title":"Webhook Management_getWebhookSchema_Response_200"},"V1ProductsIdSurfacesSurfaceIdWebhookSchemaPostRequestBodyContentApplicationJsonSchemaFormat":{"type":"string","enum":["asyncapi","jsonschema","raw"],"title":"V1ProductsIdSurfacesSurfaceIdWebhookSchemaPostRequestBodyContentApplicationJsonSchemaFormat"},"Webhook_Management_uploadWebhookSchema_Response_200":{"type":"object","properties":{"learningState":{"type":"string"},"proposedSchema":{"description":"Any type"}},"required":["learningState"],"title":"Webhook Management_uploadWebhookSchema_Response_200"},"Webhook_Management_confirmProposedSchema_Response_200":{"type":"object","properties":{"confirmedSchema":{"description":"Any type"},"learningState":{"type":"string"},"schemaConfirmedAt":{"type":"string"}},"required":["learningState","schemaConfirmedAt"],"title":"Webhook Management_confirmProposedSchema_Response_200"},"A2AStreamEventOneOf0Id":{"oneOf":[{"type":"string"},{"type":"number","format":"double"}],"title":"A2AStreamEventOneOf0Id"},"A2AStreamEventOneOf0Jsonrpc":{"type":"string","enum":["2.0"],"title":"A2AStreamEventOneOf0Jsonrpc"},"A2APart":{"type":"object","properties":{"data":{"description":"Any type"},"filename":{"type":"string"},"mediaType":{"type":"string"},"raw":{"type":"string"},"text":{"type":"string"},"url":{"type":"string"}},"title":"A2APart"},"A2AMessageRole":{"type":"string","enum":["ROLE_USER","ROLE_AGENT"],"title":"A2AMessageRole"},"A2AMessage":{"type":"object","properties":{"contextId":{"type":"string"},"messageId":{"type":"string"},"parts":{"type":"array","items":{"$ref":"#/components/schemas/A2APart"}},"role":{"$ref":"#/components/schemas/A2AMessageRole"},"taskId":{"type":"string"}},"required":["parts","role"],"title":"A2AMessage"},"A2AStreamEventOneOf0ResultStatusUpdateStatusState":{"type":"string","enum":["TASK_STATE_SUBMITTED","TASK_STATE_WORKING","TASK_STATE_COMPLETED","TASK_STATE_FAILED","TASK_STATE_CANCELED","TASK_STATE_INPUT_REQUIRED","TASK_STATE_AUTH_REQUIRED","TASK_STATE_REJECTED","TASK_STATE_UNSPECIFIED"],"title":"A2AStreamEventOneOf0ResultStatusUpdateStatusState"},"A2AStreamEventOneOf0ResultStatusUpdateStatus":{"type":"object","properties":{"message":{"$ref":"#/components/schemas/A2AMessage"},"state":{"$ref":"#/components/schemas/A2AStreamEventOneOf0ResultStatusUpdateStatusState"},"timestamp":{"type":"string"}},"required":["state"],"title":"A2AStreamEventOneOf0ResultStatusUpdateStatus"},"A2AStreamEventOneOf0ResultStatusUpdate":{"type":"object","properties":{"contextId":{"type":"string"},"metadata":{"type":"object","additionalProperties":{"description":"Any type"}},"status":{"$ref":"#/components/schemas/A2AStreamEventOneOf0ResultStatusUpdateStatus"},"taskId":{"type":"string"}},"required":["contextId","status","taskId"],"title":"A2AStreamEventOneOf0ResultStatusUpdate"},"A2AStreamEventOneOf0Result":{"type":"object","properties":{"statusUpdate":{"$ref":"#/components/schemas/A2AStreamEventOneOf0ResultStatusUpdate"}},"required":["statusUpdate"],"title":"A2AStreamEventOneOf0Result"},"A2AStreamEvent0":{"type":"object","properties":{"id":{"$ref":"#/components/schemas/A2AStreamEventOneOf0Id"},"jsonrpc":{"$ref":"#/components/schemas/A2AStreamEventOneOf0Jsonrpc"},"result":{"$ref":"#/components/schemas/A2AStreamEventOneOf0Result"}},"required":["jsonrpc","result"],"title":"A2AStreamEvent0"},"A2AStreamEventOneOf1Id":{"oneOf":[{"type":"string"},{"type":"number","format":"double"}],"title":"A2AStreamEventOneOf1Id"},"A2AStreamEventOneOf1Jsonrpc":{"type":"string","enum":["2.0"],"title":"A2AStreamEventOneOf1Jsonrpc"},"A2AArtifact":{"type":"object","properties":{"artifactId":{"type":"string"},"description":{"type":"string"},"name":{"type":"string"},"parts":{"type":"array","items":{"$ref":"#/components/schemas/A2APart"}}},"required":["artifactId","parts"],"title":"A2AArtifact"},"A2AStreamEventOneOf1ResultArtifactUpdate":{"type":"object","properties":{"append":{"type":"boolean"},"artifact":{"$ref":"#/components/schemas/A2AArtifact"},"contextId":{"type":"string"},"lastChunk":{"type":"boolean"},"metadata":{"type":"object","additionalProperties":{"description":"Any type"}},"taskId":{"type":"string"}},"required":["artifact","contextId","taskId"],"title":"A2AStreamEventOneOf1ResultArtifactUpdate"},"A2AStreamEventOneOf1Result":{"type":"object","properties":{"artifactUpdate":{"$ref":"#/components/schemas/A2AStreamEventOneOf1ResultArtifactUpdate"}},"required":["artifactUpdate"],"title":"A2AStreamEventOneOf1Result"},"A2AStreamEvent1":{"type":"object","properties":{"id":{"$ref":"#/components/schemas/A2AStreamEventOneOf1Id"},"jsonrpc":{"$ref":"#/components/schemas/A2AStreamEventOneOf1Jsonrpc"},"result":{"$ref":"#/components/schemas/A2AStreamEventOneOf1Result"}},"required":["jsonrpc","result"],"title":"A2AStreamEvent1"},"A2AJsonRpcError":{"type":"object","properties":{"code":{"type":"number","format":"double"},"data":{"type":"array","items":{"description":"Any type"}},"message":{"type":"string"}},"required":["code","message"],"title":"A2AJsonRpcError"},"A2AStreamEventOneOf2Id":{"oneOf":[{"type":"string"},{"type":"number","format":"double"}],"title":"A2AStreamEventOneOf2Id"},"A2AStreamEventOneOf2Jsonrpc":{"type":"string","enum":["2.0"],"title":"A2AStreamEventOneOf2Jsonrpc"},"A2AStreamEvent2":{"type":"object","properties":{"error":{"$ref":"#/components/schemas/A2AJsonRpcError"},"id":{"$ref":"#/components/schemas/A2AStreamEventOneOf2Id"},"jsonrpc":{"$ref":"#/components/schemas/A2AStreamEventOneOf2Jsonrpc"}},"required":["error","jsonrpc"],"title":"A2AStreamEvent2"},"A2AStreamEvent":{"oneOf":[{"$ref":"#/components/schemas/A2AStreamEvent0"},{"$ref":"#/components/schemas/A2AStreamEvent1"},{"$ref":"#/components/schemas/A2AStreamEvent2"}],"title":"A2AStreamEvent"},"V1ProductsProductIdSurfacesSurfaceIdA2AWellKnownAgentCardJsonGetResponsesContentApplicationJsonSchemaAuthentication":{"type":"object","properties":{},"title":"V1ProductsProductIdSurfacesSurfaceIdA2AWellKnownAgentCardJsonGetResponsesContentApplicationJsonSchemaAuthentication"},"V1ProductsProductIdSurfacesSurfaceIdA2AWellKnownAgentCardJsonGetResponsesContentApplicationJsonSchemaCapabilities":{"type":"object","properties":{},"title":"V1ProductsProductIdSurfacesSurfaceIdA2AWellKnownAgentCardJsonGetResponsesContentApplicationJsonSchemaCapabilities"},"V1ProductsProductIdSurfacesSurfaceIdA2AWellKnownAgentCardJsonGetResponsesContentApplicationJsonSchemaProvider":{"type":"object","properties":{"organization":{"type":"string"},"url":{"type":"string"}},"required":["organization","url"],"title":"V1ProductsProductIdSurfacesSurfaceIdA2AWellKnownAgentCardJsonGetResponsesContentApplicationJsonSchemaProvider"},"V1ProductsProductIdSurfacesSurfaceIdA2AWellKnownAgentCardJsonGetResponsesContentApplicationJsonSchemaSkillsItems":{"type":"object","properties":{},"title":"V1ProductsProductIdSurfacesSurfaceIdA2AWellKnownAgentCardJsonGetResponsesContentApplicationJsonSchemaSkillsItems"},"A2A_getA2AAgentCard_Response_200":{"type":"object","properties":{"authentication":{"$ref":"#/components/schemas/V1ProductsProductIdSurfacesSurfaceIdA2AWellKnownAgentCardJsonGetResponsesContentApplicationJsonSchemaAuthentication"},"capabilities":{"$ref":"#/components/schemas/V1ProductsProductIdSurfacesSurfaceIdA2AWellKnownAgentCardJsonGetResponsesContentApplicationJsonSchemaCapabilities"},"defaultInputModes":{"type":"array","items":{"type":"string"}},"defaultOutputModes":{"type":"array","items":{"type":"string"}},"description":{"type":"string"},"iconUrl":{"type":"string"},"name":{"type":"string"},"protocolVersion":{"type":"string"},"provider":{"$ref":"#/components/schemas/V1ProductsProductIdSurfacesSurfaceIdA2AWellKnownAgentCardJsonGetResponsesContentApplicationJsonSchemaProvider"},"skills":{"type":"array","items":{"$ref":"#/components/schemas/V1ProductsProductIdSurfacesSurfaceIdA2AWellKnownAgentCardJsonGetResponsesContentApplicationJsonSchemaSkillsItems"}},"url":{"type":"string"},"version":{"type":"string"}},"required":["authentication","capabilities","defaultInputModes","defaultOutputModes","description","name","protocolVersion","skills","url","version"],"title":"A2A_getA2AAgentCard_Response_200"},"V1ProductsProductIdSurfacesSurfaceIdA2AInfoGetResponsesContentApplicationJsonSchemaA2AAuthentication":{"type":"object","properties":{"format":{"type":"string"},"header":{"type":"string"},"type":{"type":"string"}},"required":["format","header","type"],"title":"V1ProductsProductIdSurfacesSurfaceIdA2AInfoGetResponsesContentApplicationJsonSchemaA2AAuthentication"},"V1ProductsProductIdSurfacesSurfaceIdA2AInfoGetResponsesContentApplicationJsonSchemaA2A":{"type":"object","properties":{"agentCard":{"type":"string"},"authentication":{"$ref":"#/components/schemas/V1ProductsProductIdSurfacesSurfaceIdA2AInfoGetResponsesContentApplicationJsonSchemaA2AAuthentication"},"endpoint":{"type":"string"},"protocolVersion":{"type":"string"}},"required":["agentCard","authentication","endpoint","protocolVersion"],"title":"V1ProductsProductIdSurfacesSurfaceIdA2AInfoGetResponsesContentApplicationJsonSchemaA2A"},"V1ProductsProductIdSurfacesSurfaceIdA2AInfoGetResponsesContentApplicationJsonSchemaProduct":{"type":"object","properties":{"description":{"type":["string","null"]},"id":{"type":"string"},"name":{"type":"string"}},"required":["description","id","name"],"title":"V1ProductsProductIdSurfacesSurfaceIdA2AInfoGetResponsesContentApplicationJsonSchemaProduct"},"A2A_getA2ASurfaceInfo_Response_200":{"type":"object","properties":{"a2a":{"$ref":"#/components/schemas/V1ProductsProductIdSurfacesSurfaceIdA2AInfoGetResponsesContentApplicationJsonSchemaA2A"},"product":{"$ref":"#/components/schemas/V1ProductsProductIdSurfacesSurfaceIdA2AInfoGetResponsesContentApplicationJsonSchemaProduct"}},"required":["a2a","product"],"title":"A2A_getA2ASurfaceInfo_Response_200"},"V1ProductsProductIdSurfacesSurfaceIdDiscoveredToolsGetResponsesContentApplicationJsonSchemaOriginsItemsToolsItemsSource":{"type":"string","enum":["observed","probe"],"title":"V1ProductsProductIdSurfacesSurfaceIdDiscoveredToolsGetResponsesContentApplicationJsonSchemaOriginsItemsToolsItemsSource"},"V1ProductsProductIdSurfacesSurfaceIdDiscoveredToolsGetResponsesContentApplicationJsonSchemaOriginsItemsToolsItemsStatus":{"type":"string","enum":["admitted","disabled","not_in_allowlist"],"title":"V1ProductsProductIdSurfacesSurfaceIdDiscoveredToolsGetResponsesContentApplicationJsonSchemaOriginsItemsToolsItemsStatus"},"V1ProductsProductIdSurfacesSurfaceIdDiscoveredToolsGetResponsesContentApplicationJsonSchemaOriginsItemsToolsItems":{"type":"object","properties":{"description":{"type":["string","null"]},"firstSeenAt":{"type":"string"},"lastSeenAt":{"type":"string"},"parametersSchema":{"type":["object","null"],"additionalProperties":{"description":"Any type"}},"reportedPageOrigin":{"type":["string","null"]},"source":{"$ref":"#/components/schemas/V1ProductsProductIdSurfacesSurfaceIdDiscoveredToolsGetResponsesContentApplicationJsonSchemaOriginsItemsToolsItemsSource"},"status":{"$ref":"#/components/schemas/V1ProductsProductIdSurfacesSurfaceIdDiscoveredToolsGetResponsesContentApplicationJsonSchemaOriginsItemsToolsItemsStatus"},"toolName":{"type":"string"}},"required":["description","firstSeenAt","lastSeenAt","parametersSchema","reportedPageOrigin","source","status","toolName"],"title":"V1ProductsProductIdSurfacesSurfaceIdDiscoveredToolsGetResponsesContentApplicationJsonSchemaOriginsItemsToolsItems"},"V1ProductsProductIdSurfacesSurfaceIdDiscoveredToolsGetResponsesContentApplicationJsonSchemaOriginsItems":{"type":"object","properties":{"requestOrigin":{"type":"string"},"tools":{"type":"array","items":{"$ref":"#/components/schemas/V1ProductsProductIdSurfacesSurfaceIdDiscoveredToolsGetResponsesContentApplicationJsonSchemaOriginsItemsToolsItems"}}},"required":["requestOrigin","tools"],"title":"V1ProductsProductIdSurfacesSurfaceIdDiscoveredToolsGetResponsesContentApplicationJsonSchemaOriginsItems"},"Surfaces_listDiscoveredWebMcpTools_Response_200":{"type":"object","properties":{"origins":{"type":"array","items":{"$ref":"#/components/schemas/V1ProductsProductIdSurfacesSurfaceIdDiscoveredToolsGetResponsesContentApplicationJsonSchemaOriginsItems"}},"windowDays":{"type":"number","format":"double"}},"required":["origins","windowDays"],"title":"Surfaces_listDiscoveredWebMcpTools_Response_200"},"ListDiscoveredWebMcpToolsRequestUnauthorizedError":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"],"title":"ListDiscoveredWebMcpToolsRequestUnauthorizedError"},"ListDiscoveredWebMcpToolsRequestForbiddenError":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"],"title":"ListDiscoveredWebMcpToolsRequestForbiddenError"},"ListDiscoveredWebMcpToolsRequestNotFoundError":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"],"title":"ListDiscoveredWebMcpToolsRequestNotFoundError"},"V1ProductsProductIdSurfacesSurfaceIdObservedOriginsGetResponsesContentApplicationJsonSchemaOriginsItems":{"type":"object","properties":{"allowed":{"type":"boolean"},"firstSeenAt":{"type":"string"},"lastSeenAt":{"type":"string"},"origin":{"type":"string"}},"required":["allowed","firstSeenAt","lastSeenAt","origin"],"title":"V1ProductsProductIdSurfacesSurfaceIdObservedOriginsGetResponsesContentApplicationJsonSchemaOriginsItems"},"Surfaces_listObservedPageOrigins_Response_200":{"type":"object","properties":{"origins":{"type":"array","items":{"$ref":"#/components/schemas/V1ProductsProductIdSurfacesSurfaceIdObservedOriginsGetResponsesContentApplicationJsonSchemaOriginsItems"}},"windowDays":{"type":"number","format":"double"}},"required":["origins","windowDays"],"title":"Surfaces_listObservedPageOrigins_Response_200"},"ListObservedPageOriginsRequestUnauthorizedError":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"],"title":"ListObservedPageOriginsRequestUnauthorizedError"},"ListObservedPageOriginsRequestForbiddenError":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"],"title":"ListObservedPageOriginsRequestForbiddenError"},"ListObservedPageOriginsRequestNotFoundError":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"],"title":"ListObservedPageOriginsRequestNotFoundError"},"V1SurfacesGetResponsesContentApplicationJsonSchemaDataItemsInboundChannelOverridesChannelResponseMode":{"type":"string","enum":["mention","judge","always"],"title":"V1SurfacesGetResponsesContentApplicationJsonSchemaDataItemsInboundChannelOverridesChannelResponseMode"},"V1SurfacesGetResponsesContentApplicationJsonSchemaDataItemsInboundChannelOverridesEagerness":{"type":"string","enum":["conservative","balanced","eager"],"title":"V1SurfacesGetResponsesContentApplicationJsonSchemaDataItemsInboundChannelOverridesEagerness"},"V1SurfacesGetResponsesContentApplicationJsonSchemaDataItemsInboundChannelOverrides":{"type":"object","properties":{"channelResponseMode":{"$ref":"#/components/schemas/V1SurfacesGetResponsesContentApplicationJsonSchemaDataItemsInboundChannelOverridesChannelResponseMode"},"eagerness":{"$ref":"#/components/schemas/V1SurfacesGetResponsesContentApplicationJsonSchemaDataItemsInboundChannelOverridesEagerness"}},"title":"V1SurfacesGetResponsesContentApplicationJsonSchemaDataItemsInboundChannelOverrides"},"V1SurfacesGetResponsesContentApplicationJsonSchemaDataItemsInboundChannelResponseMode":{"type":"string","enum":["mention","judge","always"],"description":"When the bot answers an unmentioned channel message: mention (default for new surfaces), always, or judge (asks the platform response-gate judgment whether to reply; a failed judgment waits for a mention).","title":"V1SurfacesGetResponsesContentApplicationJsonSchemaDataItemsInboundChannelResponseMode"},"V1SurfacesGetResponsesContentApplicationJsonSchemaDataItemsInboundContextBackfillMode":{"type":"string","enum":["judged","window","none"],"title":"V1SurfacesGetResponsesContentApplicationJsonSchemaDataItemsInboundContextBackfillMode"},"V1SurfacesGetResponsesContentApplicationJsonSchemaDataItemsInboundContextBackfill":{"type":"object","properties":{"maxAgeMinutes":{"type":"integer","minimum":1,"maximum":1440},"maxMessages":{"type":"integer","minimum":1,"maximum":20},"mode":{"$ref":"#/components/schemas/V1SurfacesGetResponsesContentApplicationJsonSchemaDataItemsInboundContextBackfillMode"}},"description":"How skipped channel messages reach the conversation when the bot answers: window (default) adds up to maxMessages (default and ceiling 20) from the last maxAgeMinutes (default 360, ceiling 1440) as context; judged adds, within the same bounds, only the messages the platform response-gate judgment finds needed to understand the answered message, and falls back to window when the judgment fails; none adds nothing.","title":"V1SurfacesGetResponsesContentApplicationJsonSchemaDataItemsInboundContextBackfill"},"V1SurfacesGetResponsesContentApplicationJsonSchemaDataItemsInboundEagerness":{"type":"string","enum":["conservative","balanced","eager"],"description":"How readily judge mode replies: conservative, balanced (default) or eager. Each selects a pair of reply and silence thresholds.","title":"V1SurfacesGetResponsesContentApplicationJsonSchemaDataItemsInboundEagerness"},"V1SurfacesGetResponsesContentApplicationJsonSchemaDataItemsInboundKeywords":{"type":"object","properties":{"ignore":{"type":"array","items":{"type":"string"}},"require":{"type":"array","items":{"type":"string"}}},"description":"Whole-word, case-insensitive filter on unmentioned messages in always and judge mode; judge mode applies it before the judgment.","title":"V1SurfacesGetResponsesContentApplicationJsonSchemaDataItemsInboundKeywords"},"V1SurfacesGetResponsesContentApplicationJsonSchemaDataItemsInboundOnUncertain":{"type":"string","enum":["silent","reply"],"description":"What judge mode does when the judgment lands between the two thresholds: silent (default) or reply.","title":"V1SurfacesGetResponsesContentApplicationJsonSchemaDataItemsInboundOnUncertain"},"V1SurfacesGetResponsesContentApplicationJsonSchemaDataItemsInbound":{"type":"object","properties":{"appId":{"type":"string"},"channelOverrides":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/V1SurfacesGetResponsesContentApplicationJsonSchemaDataItemsInboundChannelOverrides"},"description":"Per-channel channelResponseMode and eagerness, keyed by channel ID."},"channelResponseMode":{"$ref":"#/components/schemas/V1SurfacesGetResponsesContentApplicationJsonSchemaDataItemsInboundChannelResponseMode","description":"When the bot answers an unmentioned channel message: mention (default for new surfaces), always, or judge (asks the platform response-gate judgment whether to reply; a failed judgment waits for a mention)."},"contextBackfill":{"$ref":"#/components/schemas/V1SurfacesGetResponsesContentApplicationJsonSchemaDataItemsInboundContextBackfill","description":"How skipped channel messages reach the conversation when the bot answers: window (default) adds up to maxMessages (default and ceiling 20) from the last maxAgeMinutes (default 360, ceiling 1440) as context; judged adds, within the same bounds, only the messages the platform response-gate judgment finds needed to understand the answered message, and falls back to window when the judgment fails; none adds nothing."},"continueThreads":{"type":"boolean"},"eagerness":{"$ref":"#/components/schemas/V1SurfacesGetResponsesContentApplicationJsonSchemaDataItemsInboundEagerness","description":"How readily judge mode replies: conservative, balanced (default) or eager. Each selects a pair of reply and silence thresholds."},"integrationId":{"type":"string"},"keywords":{"$ref":"#/components/schemas/V1SurfacesGetResponsesContentApplicationJsonSchemaDataItemsInboundKeywords","description":"Whole-word, case-insensitive filter on unmentioned messages in always and judge mode; judge mode applies it before the judgment."},"listenChannels":{"type":"array","items":{"type":"string"}},"listenDms":{"type":"boolean"},"onUncertain":{"$ref":"#/components/schemas/V1SurfacesGetResponsesContentApplicationJsonSchemaDataItemsInboundOnUncertain","description":"What judge mode does when the judgment lands between the two thresholds: silent (default) or reply."},"responseGateShadow":{"type":"boolean","description":"Opt-in. In mention or always mode, also judge each unmentioned channel message and record the decision and probability without changing what the bot does."},"responseRules":{"type":"string","maxLength":2000,"description":"Free text (up to 2000 characters) the judge-mode judgment reads as the rules for when the bot should speak, for example \"answer questions about resetting Acme account passwords\"."},"teamId":{"type":"string"},"teamName":{"type":"string"},"triggerOnMention":{"type":"boolean","description":"Deprecated; use channelResponseMode. true reads as mention, false as always.","deprecated":true}},"title":"V1SurfacesGetResponsesContentApplicationJsonSchemaDataItemsInbound"},"V1SurfacesGetResponsesContentApplicationJsonSchemaDataItems":{"type":"object","properties":{"createdAt":{"type":"string"},"endpoint":{"type":["string","null"],"description":"Canonical public URL of this surface (MCP, API, A2A, AG-UI, webhook, chat). Null for surface types reached through their own channels (Slack, email, schedule, ...). Clients should use this instead of constructing the URL themselves."},"id":{"type":"string"},"inbound":{"oneOf":[{"$ref":"#/components/schemas/V1SurfacesGetResponsesContentApplicationJsonSchemaDataItemsInbound"},{"type":"null"}]},"name":{"type":"string"},"productId":{"type":"string"},"productName":{"type":"string","description":"Name of the product this surface belongs to. Non-nullable: the list query inner-joins products (so a surface with no product cannot appear) and products.name is NOT NULL. Present so a cross-product picker can disambiguate two surfaces that share a name."},"status":{"type":"string"},"type":{"type":"string"},"updatedAt":{"type":"string"},"webhookHealth":{"$ref":"#/components/schemas/WebhookHealth"}},"required":["createdAt","endpoint","id","inbound","name","productId","productName","status","type","updatedAt","webhookHealth"],"title":"V1SurfacesGetResponsesContentApplicationJsonSchemaDataItems"},"Surfaces_listSurfaces_Response_200":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1SurfacesGetResponsesContentApplicationJsonSchemaDataItems"}},"pagination":{"$ref":"#/components/schemas/Pagination"}},"required":["data","pagination"],"title":"Surfaces_listSurfaces_Response_200"},"V1SurfacesSurfaceIdGetResponsesContentApplicationJsonSchemaItemsItems":{"type":"object","properties":{"agentId":{"type":["string","null"]},"agentType":{"type":["string","null"]},"cachedSkills":{"type":["array","null"],"items":{"description":"Any type"}},"capabilityId":{"type":"string"},"capabilityName":{"type":["string","null"]},"config":{"description":"Any type"},"createdAt":{"type":"string"},"displayOrder":{"type":["integer","null"]},"enabled":{"type":"boolean"},"endpointSlug":{"type":["string","null"]},"exposedDescription":{"type":["string","null"]},"exposedName":{"type":["string","null"]},"flowId":{"type":["string","null"]},"id":{"type":"string"},"isEntryPoint":{"type":"boolean"},"parametersSchema":{"description":"Any type"}},"required":["agentId","agentType","cachedSkills","capabilityId","capabilityName","createdAt","displayOrder","enabled","endpointSlug","exposedDescription","exposedName","flowId","id","isEntryPoint"],"title":"V1SurfacesSurfaceIdGetResponsesContentApplicationJsonSchemaItemsItems"},"V1SurfacesSurfaceIdGetResponsesContentApplicationJsonSchemaKeysItems":{"type":"object","properties":{"canReveal":{"type":"boolean"},"createdAt":{"type":"string"},"environment":{"type":"string"},"expiresAt":{"type":["string","null"]},"id":{"type":"string"},"isActive":{"type":"boolean"},"isDevelopment":{"type":"boolean"},"keyHint":{"type":["string","null"]},"keyPrefix":{"type":"string"},"lastUsedAt":{"type":["string","null"]},"name":{"type":["string","null"]},"rateLimitPerDay":{"type":["integer","null"]},"rateLimitPerMinute":{"type":["integer","null"]},"scopeTargetIds":{"type":["array","null"],"items":{"type":"string"}},"scopes":{"type":"array","items":{"type":"string"}},"usageCount":{"type":["integer","null"]}},"required":["canReveal","createdAt","environment","expiresAt","id","isActive","isDevelopment","keyHint","keyPrefix","lastUsedAt","name","rateLimitPerDay","rateLimitPerMinute","scopeTargetIds","scopes","usageCount"],"title":"V1SurfacesSurfaceIdGetResponsesContentApplicationJsonSchemaKeysItems"},"V1SurfacesSurfaceIdGetResponsesContentApplicationJsonSchemaScopeTargetsItems":{"type":"object","properties":{"capabilityId":{"type":"string"},"id":{"type":"string"},"name":{"type":"string"},"surfaceItemId":{"type":"string"}},"required":["id","name"],"title":"V1SurfacesSurfaceIdGetResponsesContentApplicationJsonSchemaScopeTargetsItems"},"Surfaces_getSurfaceDetails_Response_200":{"type":"object","properties":{"behavior":{"description":"Any type"},"createdAt":{"type":"string"},"endpoint":{"type":["string","null"],"description":"Canonical public URL of this surface (MCP, API, A2A, AG-UI, webhook, chat). Null for surface types reached through their own channels (Slack, email, schedule, ...). Clients should use this instead of constructing the URL themselves."},"id":{"type":"string"},"inbound":{"description":"Any type"},"items":{"type":"array","items":{"$ref":"#/components/schemas/V1SurfacesSurfaceIdGetResponsesContentApplicationJsonSchemaItemsItems"}},"keys":{"type":"array","items":{"$ref":"#/components/schemas/V1SurfacesSurfaceIdGetResponsesContentApplicationJsonSchemaKeysItems"}},"lastModifiedSource":{"type":["string","null"]},"name":{"type":"string"},"outbound":{"description":"Any type"},"productId":{"type":"string"},"scopeTargets":{"type":"array","items":{"$ref":"#/components/schemas/V1SurfacesSurfaceIdGetResponsesContentApplicationJsonSchemaScopeTargetsItems"}},"status":{"type":"string"},"type":{"type":"string"},"updatedAt":{"type":"string"},"webhookHealth":{"$ref":"#/components/schemas/WebhookHealth"}},"required":["createdAt","endpoint","id","items","keys","lastModifiedSource","name","productId","scopeTargets","status","type","updatedAt","webhookHealth"],"title":"Surfaces_getSurfaceDetails_Response_200"},"ChannelContextDecisionCapabilityOutcome":{"type":"string","enum":["route","clarify","decline","unanswered"],"title":"ChannelContextDecisionCapabilityOutcome"},"ChannelContextDecisionCapability":{"type":"object","properties":{"capabilityId":{"type":"string"},"outcome":{"$ref":"#/components/schemas/ChannelContextDecisionCapabilityOutcome"},"probability":{"type":"number","format":"double"}},"required":["outcome"],"description":"The capability the judgment chose on a surface with several capabilities and no entry point. In judge mode only route activates a reply.","title":"ChannelContextDecisionCapability"},"ChannelContextDecisionDecision":{"type":"string","enum":["not_judged","reply","silent","band"],"description":"The response gate decision. not_judged means no judgment answered: the mode never asks one, or the judgment failed and the message waited for a mention.","title":"ChannelContextDecisionDecision"},"ChannelContextDecisionFailure":{"type":"string","enum":["error","upstream","timeout","unanswered","no_assistant","preparation","circuit_open"],"description":"Why the judgment did not answer, when one was asked and failed. error: the model call failed for a reason other than a provider server error, for example a missing credential or a rejected request. upstream: the model provider returned a server error. timeout: the model budget ran out. unanswered: the model gave no decision. no_assistant: the surface has no product to describe. preparation: the pre-model loads failed or ran out of time. circuit_open: repeated upstream failures paused judgments, so none was asked. Absent on a decision that answered, and on decisions recorded before this field existed.","title":"ChannelContextDecisionFailure"},"ChannelContextDecision":{"type":"object","properties":{"activated":{"type":"boolean","description":"Whether the assistant ran for this message."},"capability":{"$ref":"#/components/schemas/ChannelContextDecisionCapability","description":"The capability the judgment chose on a surface with several capabilities and no entry point. In judge mode only route activates a reply."},"decision":{"$ref":"#/components/schemas/ChannelContextDecisionDecision","description":"The response gate decision. not_judged means no judgment answered: the mode never asks one, or the judgment failed and the message waited for a mention."},"failure":{"$ref":"#/components/schemas/ChannelContextDecisionFailure","description":"Why the judgment did not answer, when one was asked and failed. error: the model call failed for a reason other than a provider server error, for example a missing credential or a rejected request. upstream: the model provider returned a server error. timeout: the model budget ran out. unanswered: the model gave no decision. no_assistant: the surface has no product to describe. preparation: the pre-model loads failed or ran out of time. circuit_open: repeated upstream failures paused judgments, so none was asked. Absent on a decision that answered, and on decisions recorded before this field existed."},"probability":{"type":"number","format":"double","description":"The judged shouldReply probability; absent when not_judged."}},"required":["activated","decision"],"title":"ChannelContextDecision"},"ChannelContextLabelLabel":{"type":"string","enum":["gate_false_negative","gate_false_positive","backfill_false_negative"],"description":"gate_false_negative: the assistant stayed silent and a person mentioned it soon after. gate_false_positive: the assistant replied and a person pushed back. backfill_false_negative: after a judged context backfill, a person said the answer was already above.","title":"ChannelContextLabelLabel"},"ChannelContextLabelSource":{"type":"string","enum":["mention_after_silence","not_you_reply","negative_reaction","reply_deleted","already_said_reply"],"description":"The next-turn signal that produced the label.","title":"ChannelContextLabelSource"},"ChannelContextLabel":{"type":"object","properties":{"decision":{"$ref":"#/components/schemas/ChannelContextDecision"},"externalMessageId":{"type":"string","description":"The labeled message, whose decision the label judges."},"label":{"$ref":"#/components/schemas/ChannelContextLabelLabel","description":"gate_false_negative: the assistant stayed silent and a person mentioned it soon after. gate_false_positive: the assistant replied and a person pushed back. backfill_false_negative: after a judged context backfill, a person said the answer was already above."},"labeledAt":{"type":"string","description":"ISO timestamp the label was recorded."},"source":{"$ref":"#/components/schemas/ChannelContextLabelSource","description":"The next-turn signal that produced the label."}},"required":["decision","externalMessageId","label","labeledAt","source"],"title":"ChannelContextLabel"},"ChannelContextMessageAuthorKind":{"type":"string","enum":["user","assistant","bot"],"title":"ChannelContextMessageAuthorKind"},"ChannelContextMessage":{"type":"object","properties":{"authorId":{"type":"string"},"authorKind":{"$ref":"#/components/schemas/ChannelContextMessageAuthorKind"},"decision":{"$ref":"#/components/schemas/ChannelContextDecision"},"externalMessageId":{"type":"string"},"hasAttachment":{"type":"boolean"},"mentionsAssistant":{"type":"boolean"},"text":{"type":"string","description":"Message text, truncated to 1,000 characters."},"threadId":{"type":"string"},"timestamp":{"type":"string","description":"ISO timestamp of the provider message."}},"required":["authorId","authorKind","decision","externalMessageId","hasAttachment","mentionsAssistant","text","timestamp"],"title":"ChannelContextMessage"},"V1SurfacesSurfaceIdChannelContextGetResponsesContentApplicationJsonSchemaProvider":{"type":"string","enum":["slack","telegram","imessage"],"title":"V1SurfacesSurfaceIdChannelContextGetResponsesContentApplicationJsonSchemaProvider"},"Surfaces_readAChannelContextWindow_Response_200":{"type":"object","properties":{"channelId":{"type":"string"},"labels":{"type":"array","items":{"$ref":"#/components/schemas/ChannelContextLabel"},"description":"Labels on decisions the channel still retains (newest 50 messages, 24 hours), oldest first. Empty until a next turn produces one."},"messages":{"type":"array","items":{"$ref":"#/components/schemas/ChannelContextMessage"}},"provider":{"$ref":"#/components/schemas/V1SurfacesSurfaceIdChannelContextGetResponsesContentApplicationJsonSchemaProvider"},"surfaceId":{"type":"string"}},"required":["channelId","labels","messages","provider","surfaceId"],"title":"Surfaces_readAChannelContextWindow_Response_200"},"V1SurfacesSurfaceIdTestDeliveriesPostRequestBodyContentApplicationJsonSchemaFixture":{"type":"string","enum":["github.pull_request.opened","github.pull_request.merged_plan"],"title":"V1SurfacesSurfaceIdTestDeliveriesPostRequestBodyContentApplicationJsonSchemaFixture"},"Surfaces_sendAProviderFixtureThroughASurfacesRealIngress_Response_200":{"type":"object","properties":{},"title":"Surfaces_sendAProviderFixtureThroughASurfacesRealIngress_Response_200"},"V1ProductsProductIdSurfacesSurfaceIdMcpWellKnownMcpJsonGetResponsesContentApplicationJsonSchemaAuthentication":{"type":"object","properties":{"description":{"type":"string"},"required":{"type":"boolean"},"type":{"type":"string"}},"required":["required","type"],"title":"V1ProductsProductIdSurfacesSurfaceIdMcpWellKnownMcpJsonGetResponsesContentApplicationJsonSchemaAuthentication"},"V1ProductsProductIdSurfacesSurfaceIdMcpWellKnownMcpJsonGetResponsesContentApplicationJsonSchemaCapabilities":{"type":"object","properties":{"logging":{"type":"boolean"},"prompts":{"type":"boolean"},"resources":{"type":"boolean"},"tools":{"type":"boolean"}},"required":["logging","prompts","resources","tools"],"title":"V1ProductsProductIdSurfacesSurfaceIdMcpWellKnownMcpJsonGetResponsesContentApplicationJsonSchemaCapabilities"},"V1ProductsProductIdSurfacesSurfaceIdMcpWellKnownMcpJsonGetResponsesContentApplicationJsonSchemaToolsItems":{"type":"object","properties":{"description":{"type":"string"},"inputSchema":{"description":"Any type"},"name":{"type":"string"}},"required":["description","name"],"title":"V1ProductsProductIdSurfacesSurfaceIdMcpWellKnownMcpJsonGetResponsesContentApplicationJsonSchemaToolsItems"},"Product_MCP_mcpManifest_Response_200":{"type":"object","properties":{"authentication":{"$ref":"#/components/schemas/V1ProductsProductIdSurfacesSurfaceIdMcpWellKnownMcpJsonGetResponsesContentApplicationJsonSchemaAuthentication"},"capabilities":{"$ref":"#/components/schemas/V1ProductsProductIdSurfacesSurfaceIdMcpWellKnownMcpJsonGetResponsesContentApplicationJsonSchemaCapabilities"},"description":{"type":"string"},"icons":{"type":"array","items":{"description":"Any type"}},"name":{"type":"string"},"protocolVersion":{"type":"string"},"tools":{"type":"array","items":{"$ref":"#/components/schemas/V1ProductsProductIdSurfacesSurfaceIdMcpWellKnownMcpJsonGetResponsesContentApplicationJsonSchemaToolsItems"}},"url":{"type":"string"},"version":{"type":"string"}},"required":["authentication","capabilities","description","name","protocolVersion","tools","url","version"],"title":"Product MCP_mcpManifest_Response_200"},"Product_MCP_oAuthProtectedResourceMetadata_Response_200":{"type":"object","properties":{"authorization_servers":{"type":"array","items":{"type":"string"}},"bearer_methods_supported":{"type":"array","items":{"type":"string"}},"resource":{"type":"string"},"resource_name":{"type":"string"},"scopes_supported":{"type":"array","items":{"type":"string"}}},"required":["authorization_servers","bearer_methods_supported","resource"],"title":"Product MCP_oAuthProtectedResourceMetadata_Response_200"},"V1ProductsProductIdSurfacesSurfaceIdMcpInfoGetResponsesContentApplicationJsonSchemaMcpAuthentication":{"type":"object","properties":{"format":{"type":"string"},"header":{"type":"string"},"type":{"type":"string"}},"required":["format","header","type"],"title":"V1ProductsProductIdSurfacesSurfaceIdMcpInfoGetResponsesContentApplicationJsonSchemaMcpAuthentication"},"V1ProductsProductIdSurfacesSurfaceIdMcpInfoGetResponsesContentApplicationJsonSchemaMcp":{"type":"object","properties":{"authentication":{"$ref":"#/components/schemas/V1ProductsProductIdSurfacesSurfaceIdMcpInfoGetResponsesContentApplicationJsonSchemaMcpAuthentication"},"endpoint":{"type":"string"},"manifest":{"type":"string"},"protocolVersion":{"type":"string"}},"required":["authentication","endpoint","manifest","protocolVersion"],"title":"V1ProductsProductIdSurfacesSurfaceIdMcpInfoGetResponsesContentApplicationJsonSchemaMcp"},"V1ProductsProductIdSurfacesSurfaceIdMcpInfoGetResponsesContentApplicationJsonSchemaProduct":{"type":"object","properties":{"description":{"type":["string","null"]},"id":{"type":"string"},"name":{"type":"string"}},"required":["description","id","name"],"title":"V1ProductsProductIdSurfacesSurfaceIdMcpInfoGetResponsesContentApplicationJsonSchemaProduct"},"Product_MCP_mcpSurfaceInfo_Response_200":{"type":"object","properties":{"mcp":{"$ref":"#/components/schemas/V1ProductsProductIdSurfacesSurfaceIdMcpInfoGetResponsesContentApplicationJsonSchemaMcp"},"product":{"$ref":"#/components/schemas/V1ProductsProductIdSurfacesSurfaceIdMcpInfoGetResponsesContentApplicationJsonSchemaProduct"}},"required":["mcp","product"],"title":"Product MCP_mcpSurfaceInfo_Response_200"},"Product_MCP_executeAnMcpSurfaceToolDashboardTest_Response_200":{"type":"object","properties":{"duration":{"type":"number","format":"double"},"isError":{"type":"boolean"},"success":{"type":"boolean"},"text":{"type":"string"}},"required":["duration","isError","success","text"],"title":"Product MCP_executeAnMcpSurfaceToolDashboardTest_Response_200"},"V1ProductsProductIdSurfacesSurfaceIdMcpToolsTestPostResponsesContentApplicationJsonSchemaSurface":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"status":{"type":"string"}},"required":["id","name","status"],"title":"V1ProductsProductIdSurfacesSurfaceIdMcpToolsTestPostResponsesContentApplicationJsonSchemaSurface"},"V1ProductsProductIdSurfacesSurfaceIdMcpToolsTestPostResponsesContentApplicationJsonSchemaToolsItems":{"type":"object","properties":{"description":{"type":"string"},"inputSchema":{"description":"Any type"},"name":{"type":"string"}},"required":["description","name"],"title":"V1ProductsProductIdSurfacesSurfaceIdMcpToolsTestPostResponsesContentApplicationJsonSchemaToolsItems"},"Product_MCP_listMcpSurfaceToolsDashboardTest_Response_200":{"type":"object","properties":{"success":{"type":"boolean"},"surface":{"$ref":"#/components/schemas/V1ProductsProductIdSurfacesSurfaceIdMcpToolsTestPostResponsesContentApplicationJsonSchemaSurface"},"tools":{"type":"array","items":{"$ref":"#/components/schemas/V1ProductsProductIdSurfacesSurfaceIdMcpToolsTestPostResponsesContentApplicationJsonSchemaToolsItems"}}},"required":["success","surface","tools"],"title":"Product MCP_listMcpSurfaceToolsDashboardTest_Response_200"},"V1PromptsGetParametersDirection":{"type":"string","enum":["next","prev"],"description":"Pagination direction","title":"V1PromptsGetParametersDirection"},"V1PromptsGetParametersView":{"type":"string","enum":["full","compact"],"description":"Response representation. `full` (default) preserves complete values; `compact` shortens every string value longer than 100 characters to a 100-character preview followed by `…`.","title":"V1PromptsGetParametersView"},"V1PromptsGetResponsesContentApplicationJsonSchemaDataItems":{"type":"object","properties":{"createdAt":{"type":"string"},"estimatedCost":{"type":["string","null"]},"estimatedTokens":{"type":["integer","null"]},"id":{"type":"string"},"model":{"type":"string"},"name":{"type":"string"},"order":{"type":"integer"},"responseFormat":{"type":"string"},"systemPrompt":{"type":["string","null"]},"text":{"type":"string"},"updatedAt":{"type":"string"},"userId":{"type":"string"},"userPrompt":{"type":["string","null"]}},"required":["createdAt","estimatedCost","estimatedTokens","id","model","name","responseFormat","text","updatedAt"],"title":"V1PromptsGetResponsesContentApplicationJsonSchemaDataItems"},"Prompts_listPrompts_Response_200":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1PromptsGetResponsesContentApplicationJsonSchemaDataItems"}},"filtersApplied":{"type":"object","additionalProperties":{"description":"Any type"}},"pagination":{"$ref":"#/components/schemas/Pagination"}},"required":["data"],"title":"Prompts_listPrompts_Response_200"},"V1PromptsPostRequestBodyContentApplicationJsonSchemaResponseFormat":{"type":"string","enum":["json","markdown","text","html","xml"],"default":"json","title":"V1PromptsPostRequestBodyContentApplicationJsonSchemaResponseFormat"},"Prompts_createAPrompt_Response_201":{"type":"object","properties":{"createdAt":{"type":"string"},"estimatedCost":{"type":["string","null"]},"estimatedTokens":{"type":["integer","null"]},"id":{"type":"string"},"model":{"type":"string"},"name":{"type":"string"},"organizationId":{"type":["string","null"]},"responseFormat":{"type":"string"},"systemPrompt":{"type":["string","null"]},"text":{"type":"string"},"updatedAt":{"type":"string"},"userId":{"type":"string"},"userPrompt":{"type":["string","null"]}},"required":["createdAt","estimatedCost","estimatedTokens","id","model","name","organizationId","responseFormat","text","updatedAt","userId"],"title":"Prompts_createAPrompt_Response_201"},"V1PromptsIdGetResponsesContentApplicationJsonSchemaFlowsItems":{"type":"object","properties":{"flowId":{"type":"string"},"flowName":{"type":"string"},"order":{"type":"integer"}},"required":["flowId","flowName","order"],"title":"V1PromptsIdGetResponsesContentApplicationJsonSchemaFlowsItems"},"Prompts_getPromptDetails_Response_200":{"type":"object","properties":{"createdAt":{"type":"string"},"estimatedCost":{"type":["string","null"]},"estimatedTokens":{"type":["integer","null"]},"flowCount":{"type":"integer"},"flowId":{"type":["string","null"]},"flowName":{"type":["string","null"]},"flows":{"type":"array","items":{"$ref":"#/components/schemas/V1PromptsIdGetResponsesContentApplicationJsonSchemaFlowsItems"}},"id":{"type":"string"},"model":{"type":"string"},"name":{"type":"string"},"responseFormat":{"type":"string"},"text":{"type":"string"},"updatedAt":{"type":"string"},"userId":{"type":"string"}},"required":["createdAt","estimatedCost","estimatedTokens","flowCount","flowId","flowName","flows","id","model","name","responseFormat","text","updatedAt","userId"],"title":"Prompts_getPromptDetails_Response_200"},"V1PromptsIdPutRequestBodyContentApplicationJsonSchemaResponseFormat":{"type":"string","enum":["json","markdown","text","html","xml"],"default":"json","title":"V1PromptsIdPutRequestBodyContentApplicationJsonSchemaResponseFormat"},"Prompts_updateAPrompt_Response_200":{"type":"object","properties":{"createdAt":{"type":"string"},"estimatedCost":{"type":["string","null"]},"estimatedTokens":{"type":["integer","null"]},"id":{"type":"string"},"model":{"type":"string"},"name":{"type":"string"},"organizationId":{"type":["string","null"]},"responseFormat":{"type":"string"},"systemPrompt":{"type":["string","null"]},"text":{"type":"string"},"updatedAt":{"type":"string"},"userId":{"type":"string"},"userPrompt":{"type":["string","null"]}},"required":["createdAt","estimatedCost","estimatedTokens","id","model","name","organizationId","responseFormat","text","updatedAt","userId"],"title":"Prompts_updateAPrompt_Response_200"},"V1ProviderKeysGetResponsesContentApplicationJsonSchemaProviderKeysItems":{"type":"object","properties":{"createdAt":{"type":"string"},"id":{"type":"string"},"isActive":{"type":"boolean"},"isDefault":{"type":"boolean"},"keyPreview":{"type":["string","null"]},"lastUsedAt":{"type":["string","null"]},"name":{"type":"string"},"provider":{"type":"string"},"settings":{"type":["object","null"],"additionalProperties":{"description":"Any type"}},"updatedAt":{"type":"string"},"usageCount":{"type":"number","format":"double"}},"required":["createdAt","id","isActive","isDefault","keyPreview","lastUsedAt","name","provider","updatedAt","usageCount"],"title":"V1ProviderKeysGetResponsesContentApplicationJsonSchemaProviderKeysItems"},"Provider_Keys_listProviderKeys_Response_200":{"type":"object","properties":{"providerKeys":{"type":"array","items":{"$ref":"#/components/schemas/V1ProviderKeysGetResponsesContentApplicationJsonSchemaProviderKeysItems"}}},"required":["providerKeys"],"title":"Provider Keys_listProviderKeys_Response_200"},"V1ProviderKeysPostRequestBodyContentApplicationJsonSchemaProvider":{"type":"string","enum":["openai","anthropic","google","xai","mixlayer","vertex","vertex-anthropic","bedrock","weaviate","vectorize","browser-rendering","tinfoil","vercel","generic-openai","braintrust"],"title":"V1ProviderKeysPostRequestBodyContentApplicationJsonSchemaProvider"},"V1ProviderKeysPostResponsesContentApplicationJsonSchemaProviderKey":{"type":"object","properties":{"createdAt":{"type":"string"},"id":{"type":"string"},"isActive":{"type":"boolean"},"isDefault":{"type":"boolean"},"keyPreview":{"type":["string","null"]},"lastUsedAt":{"type":["string","null"]},"name":{"type":"string"},"provider":{"type":"string"},"settings":{"type":["object","null"],"additionalProperties":{"description":"Any type"}},"updatedAt":{"type":"string"},"usageCount":{"type":"number","format":"double"}},"required":["createdAt","id","isActive","isDefault","keyPreview","lastUsedAt","name","provider","updatedAt","usageCount"],"title":"V1ProviderKeysPostResponsesContentApplicationJsonSchemaProviderKey"},"Provider_Keys_createAProviderKey_Response_201":{"type":"object","properties":{"providerKey":{"$ref":"#/components/schemas/V1ProviderKeysPostResponsesContentApplicationJsonSchemaProviderKey"}},"required":["providerKey"],"title":"Provider Keys_createAProviderKey_Response_201"},"V1ProviderKeysDiscoverModelsPostResponsesContentApplicationJsonSchemaModelsItems":{"type":"object","properties":{"id":{"type":"string"},"ownedBy":{"type":"string"}},"required":["id"],"title":"V1ProviderKeysDiscoverModelsPostResponsesContentApplicationJsonSchemaModelsItems"},"Provider_Keys_discoverModelsFromEndpoint_Response_200":{"type":"object","properties":{"models":{"type":"array","items":{"$ref":"#/components/schemas/V1ProviderKeysDiscoverModelsPostResponsesContentApplicationJsonSchemaModelsItems"}}},"required":["models"],"title":"Provider Keys_discoverModelsFromEndpoint_Response_200"},"V1ProviderKeysOrganizationPolicyPutRequestBodyContentApplicationJsonSchemaOneOf0Provider":{"type":"string","enum":["openai","anthropic","google","xai","mixlayer","vercel","tinfoil","bedrock","generic-openai","vertex","vertex-anthropic"],"title":"V1ProviderKeysOrganizationPolicyPutRequestBodyContentApplicationJsonSchemaOneOf0Provider"},"V1ProviderKeysOrganizationPolicyPutRequestBodyContentApplicationJsonSchemaOneOf0Selection":{"type":"object","properties":{"connectionId":{"type":"string","minLength":1}},"required":["connectionId"],"title":"V1ProviderKeysOrganizationPolicyPutRequestBodyContentApplicationJsonSchemaOneOf0Selection"},"ProviderKeysSelectOrganizationModelProviderCredentialCustodyRequest0":{"type":"object","properties":{"provider":{"$ref":"#/components/schemas/V1ProviderKeysOrganizationPolicyPutRequestBodyContentApplicationJsonSchemaOneOf0Provider"},"selection":{"$ref":"#/components/schemas/V1ProviderKeysOrganizationPolicyPutRequestBodyContentApplicationJsonSchemaOneOf0Selection"}},"required":["provider","selection"],"title":"ProviderKeysSelectOrganizationModelProviderCredentialCustodyRequest0"},"V1ProviderKeysOrganizationPolicyPutRequestBodyContentApplicationJsonSchemaOneOf1Provider":{"type":"string","enum":["openai","anthropic","google","xai","mixlayer","vercel"],"title":"V1ProviderKeysOrganizationPolicyPutRequestBodyContentApplicationJsonSchemaOneOf1Provider"},"V1ProviderKeysOrganizationPolicyPutRequestBodyContentApplicationJsonSchemaOneOf1Selection":{"type":"string","enum":["platform"],"title":"V1ProviderKeysOrganizationPolicyPutRequestBodyContentApplicationJsonSchemaOneOf1Selection"},"ProviderKeysSelectOrganizationModelProviderCredentialCustodyRequest1":{"type":"object","properties":{"provider":{"$ref":"#/components/schemas/V1ProviderKeysOrganizationPolicyPutRequestBodyContentApplicationJsonSchemaOneOf1Provider"},"selection":{"$ref":"#/components/schemas/V1ProviderKeysOrganizationPolicyPutRequestBodyContentApplicationJsonSchemaOneOf1Selection"}},"required":["provider","selection"],"title":"ProviderKeysSelectOrganizationModelProviderCredentialCustodyRequest1"},"Provider_Keys_selectOrganizationModelProviderCredentialCustody_Request":{"oneOf":[{"$ref":"#/components/schemas/ProviderKeysSelectOrganizationModelProviderCredentialCustodyRequest0"},{"$ref":"#/components/schemas/ProviderKeysSelectOrganizationModelProviderCredentialCustodyRequest1"}],"title":"Provider Keys_selectOrganizationModelProviderCredentialCustody_Request"},"Provider_Keys_selectOrganizationModelProviderCredentialCustody_Response_200":{"type":"object","properties":{"connectionId":{"type":["string","null"]},"policy":{"type":"string"},"provider":{"type":"string"}},"required":["connectionId","policy","provider"],"title":"Provider Keys_selectOrganizationModelProviderCredentialCustody_Response_200"},"V1ProviderKeysProviderProviderGetResponsesContentApplicationJsonSchemaOrganizationPolicy":{"type":"string","enum":["organization-byok-required","organization-byok-with-platform-fallback","platform-managed"],"title":"V1ProviderKeysProviderProviderGetResponsesContentApplicationJsonSchemaOrganizationPolicy"},"V1ProviderKeysProviderProviderGetResponsesContentApplicationJsonSchemaProviderKeysItems":{"type":"object","properties":{"createdAt":{"type":"string"},"id":{"type":"string"},"isActive":{"type":"boolean"},"isDefault":{"type":"boolean"},"keyPreview":{"type":["string","null"]},"lastUsedAt":{"type":["string","null"]},"name":{"type":"string"},"provider":{"type":"string"},"settings":{"type":["object","null"],"additionalProperties":{"description":"Any type"}},"updatedAt":{"type":"string"},"usageCount":{"type":"number","format":"double"}},"required":["createdAt","id","isActive","isDefault","keyPreview","lastUsedAt","name","provider","updatedAt","usageCount"],"title":"V1ProviderKeysProviderProviderGetResponsesContentApplicationJsonSchemaProviderKeysItems"},"Provider_Keys_listProviderKeysByProvider_Response_200":{"type":"object","properties":{"organizationPolicy":{"$ref":"#/components/schemas/V1ProviderKeysProviderProviderGetResponsesContentApplicationJsonSchemaOrganizationPolicy"},"providerKeys":{"type":"array","items":{"$ref":"#/components/schemas/V1ProviderKeysProviderProviderGetResponsesContentApplicationJsonSchemaProviderKeysItems"}}},"required":["providerKeys"],"title":"Provider Keys_listProviderKeysByProvider_Response_200"},"Provider_Keys_deleteAProviderKey_Response_200":{"type":"object","properties":{"success":{"type":"boolean"}},"required":["success"],"title":"Provider Keys_deleteAProviderKey_Response_200"},"V1ProviderKeysIdDeleteResponsesContentApplicationJsonSchemaOneOf0Code":{"type":"string","enum":["ORGANIZATION_CONNECTION_MIGRATED"],"title":"V1ProviderKeysIdDeleteResponsesContentApplicationJsonSchemaOneOf0Code"},"DeleteAProviderKeyRequestConflictError0":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/V1ProviderKeysIdDeleteResponsesContentApplicationJsonSchemaOneOf0Code"},"error":{"type":"string"},"replacementId":{"type":"string"}},"required":["code","error","replacementId"],"title":"DeleteAProviderKeyRequestConflictError0"},"V1ProviderKeysIdDeleteResponsesContentApplicationJsonSchemaOneOf1Code":{"type":"string","enum":["ORGANIZATION_MODEL_CONFIG_MIGRATED"],"title":"V1ProviderKeysIdDeleteResponsesContentApplicationJsonSchemaOneOf1Code"},"DeleteAProviderKeyRequestConflictError1":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/V1ProviderKeysIdDeleteResponsesContentApplicationJsonSchemaOneOf1Code"},"configId":{"type":"string"},"details":{"type":"string"},"error":{"type":"string"}},"required":["code","configId","details","error"],"title":"DeleteAProviderKeyRequestConflictError1"},"DeleteAProviderKeyRequestConflictError":{"oneOf":[{"$ref":"#/components/schemas/DeleteAProviderKeyRequestConflictError0"},{"$ref":"#/components/schemas/DeleteAProviderKeyRequestConflictError1"}],"title":"DeleteAProviderKeyRequestConflictError"},"V1ProviderKeysIdPatchResponsesContentApplicationJsonSchemaProviderKey":{"type":"object","properties":{"createdAt":{"type":"string"},"id":{"type":"string"},"isActive":{"type":"boolean"},"isDefault":{"type":"boolean"},"keyPreview":{"type":["string","null"]},"lastUsedAt":{"type":["string","null"]},"name":{"type":"string"},"provider":{"type":"string"},"settings":{"type":["object","null"],"additionalProperties":{"description":"Any type"}},"updatedAt":{"type":"string"},"usageCount":{"type":"number","format":"double"}},"required":["createdAt","id","isActive","isDefault","keyPreview","lastUsedAt","name","provider","updatedAt","usageCount"],"title":"V1ProviderKeysIdPatchResponsesContentApplicationJsonSchemaProviderKey"},"Provider_Keys_updateAProviderKey_Response_200":{"type":"object","properties":{"providerKey":{"$ref":"#/components/schemas/V1ProviderKeysIdPatchResponsesContentApplicationJsonSchemaProviderKey"}},"required":["providerKey"],"title":"Provider Keys_updateAProviderKey_Response_200"},"V1ProviderKeysIdPatchResponsesContentApplicationJsonSchemaCode":{"type":"string","enum":["ORGANIZATION_CONNECTION_MIGRATED"],"title":"V1ProviderKeysIdPatchResponsesContentApplicationJsonSchemaCode"},"UpdateAProviderKeyRequestConflictError":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/V1ProviderKeysIdPatchResponsesContentApplicationJsonSchemaCode"},"error":{"type":"string"},"replacementId":{"type":"string"}},"required":["code","error","replacementId"],"title":"UpdateAProviderKeyRequestConflictError"},"V1ProviderKeysIdDiscoverModelsPostResponsesContentApplicationJsonSchemaModelsItems":{"type":"object","properties":{"id":{"type":"string"},"ownedBy":{"type":"string"}},"required":["id"],"title":"V1ProviderKeysIdDiscoverModelsPostResponsesContentApplicationJsonSchemaModelsItems"},"Provider_Keys_discoverModelsFromExistingKey_Response_200":{"type":"object","properties":{"models":{"type":"array","items":{"$ref":"#/components/schemas/V1ProviderKeysIdDiscoverModelsPostResponsesContentApplicationJsonSchemaModelsItems"}}},"required":["models"],"title":"Provider Keys_discoverModelsFromExistingKey_Response_200"},"V1ProviderKeysIdSyncModelsPostRequestBodyContentApplicationJsonSchemaModelsItemsMidConversationSystemMessages":{"type":"string","enum":["preserve","hoist"],"description":"Where a system message that follows a conversation turn lands on this endpoint. Omitted keeps it at its position (Mistral- and Gemma-family ids fold it into the leading prompt); \"hoist\" folds it for any endpoint whose chat template rejects a non-leading system role.","title":"V1ProviderKeysIdSyncModelsPostRequestBodyContentApplicationJsonSchemaModelsItemsMidConversationSystemMessages"},"V1ProviderKeysIdSyncModelsPostRequestBodyContentApplicationJsonSchemaModelsItemsReasoning":{"type":"object","properties":{"defaultEffort":{"type":"string","minLength":1,"maxLength":32},"supported":{"type":"boolean"}},"required":["supported"],"title":"V1ProviderKeysIdSyncModelsPostRequestBodyContentApplicationJsonSchemaModelsItemsReasoning"},"V1ProviderKeysIdSyncModelsPostRequestBodyContentApplicationJsonSchemaModelsItems":{"type":"object","properties":{"displayName":{"type":"string"},"id":{"type":"string","minLength":1,"maxLength":85},"inputCostPer1kTokens":{"type":"number","format":"double","minimum":0},"maxOutputTokens":{"type":"integer","exclusiveMinimum":0},"midConversationSystemMessages":{"$ref":"#/components/schemas/V1ProviderKeysIdSyncModelsPostRequestBodyContentApplicationJsonSchemaModelsItemsMidConversationSystemMessages","description":"Where a system message that follows a conversation turn lands on this endpoint. Omitted keeps it at its position (Mistral- and Gemma-family ids fold it into the leading prompt); \"hoist\" folds it for any endpoint whose chat template rejects a non-leading system role."},"outputCostPer1kTokens":{"type":"number","format":"double","minimum":0},"reasoning":{"$ref":"#/components/schemas/V1ProviderKeysIdSyncModelsPostRequestBodyContentApplicationJsonSchemaModelsItemsReasoning"},"supportedResponseFormats":{"type":"array","items":{"type":"string"}},"supportsStreaming":{"type":"boolean"}},"required":["id"],"title":"V1ProviderKeysIdSyncModelsPostRequestBodyContentApplicationJsonSchemaModelsItems"},"Provider_Keys_syncModelsForAProviderKey_Response_200":{"type":"object","properties":{"success":{"type":"boolean"},"syncedCount":{"type":"number","format":"double"}},"required":["success","syncedCount"],"title":"Provider Keys_syncModelsForAProviderKey_Response_200"},"V1ProviderKeysIdSyncModelsPostResponsesContentApplicationJsonSchemaOneOf0Code":{"type":"string","enum":["ORGANIZATION_CONNECTION_MIGRATED"],"title":"V1ProviderKeysIdSyncModelsPostResponsesContentApplicationJsonSchemaOneOf0Code"},"SyncModelsForAProviderKeyRequestConflictError0":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/V1ProviderKeysIdSyncModelsPostResponsesContentApplicationJsonSchemaOneOf0Code"},"error":{"type":"string"},"replacementId":{"type":"string"}},"required":["code","error","replacementId"],"title":"SyncModelsForAProviderKeyRequestConflictError0"},"V1ProviderKeysIdSyncModelsPostResponsesContentApplicationJsonSchemaOneOf1Code":{"type":"string","enum":["ORGANIZATION_MODEL_CONFIG_MIGRATED"],"title":"V1ProviderKeysIdSyncModelsPostResponsesContentApplicationJsonSchemaOneOf1Code"},"SyncModelsForAProviderKeyRequestConflictError1":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/V1ProviderKeysIdSyncModelsPostResponsesContentApplicationJsonSchemaOneOf1Code"},"configId":{"type":"string"},"details":{"type":"string"},"error":{"type":"string"}},"required":["code","configId","details","error"],"title":"SyncModelsForAProviderKeyRequestConflictError1"},"SyncModelsForAProviderKeyRequestConflictError":{"oneOf":[{"$ref":"#/components/schemas/SyncModelsForAProviderKeyRequestConflictError0"},{"$ref":"#/components/schemas/SyncModelsForAProviderKeyRequestConflictError1"}],"title":"SyncModelsForAProviderKeyRequestConflictError"},"V1ProviderStatusGetResponsesContentApplicationJsonSchemaEmbeddingModels":{"type":"object","properties":{"capabilities":{"type":"object","additionalProperties":{"description":"Any type"}},"configured":{"type":"boolean"},"integrationId":{"type":"string"},"lastUsed":{"type":"string"},"metadata":{"type":"object","additionalProperties":{"description":"Any type"}}},"required":["configured"],"title":"V1ProviderStatusGetResponsesContentApplicationJsonSchemaEmbeddingModels"},"V1ProviderStatusGetResponsesContentApplicationJsonSchemaIntegrations":{"type":"object","properties":{"capabilities":{"type":"object","additionalProperties":{"description":"Any type"}},"configured":{"type":"boolean"},"integrationId":{"type":"string"},"lastUsed":{"type":"string"},"metadata":{"type":"object","additionalProperties":{"description":"Any type"}}},"required":["configured"],"title":"V1ProviderStatusGetResponsesContentApplicationJsonSchemaIntegrations"},"V1ProviderStatusGetResponsesContentApplicationJsonSchemaPlatformConfig":{"type":"object","properties":{"postgresVectorEnabled":{"type":"boolean"}},"required":["postgresVectorEnabled"],"title":"V1ProviderStatusGetResponsesContentApplicationJsonSchemaPlatformConfig"},"V1ProviderStatusGetResponsesContentApplicationJsonSchemaVectorDatabases":{"type":"object","properties":{"capabilities":{"type":"object","additionalProperties":{"description":"Any type"}},"configured":{"type":"boolean"},"integrationId":{"type":"string"},"lastUsed":{"type":"string"},"metadata":{"type":"object","additionalProperties":{"description":"Any type"}}},"required":["configured"],"title":"V1ProviderStatusGetResponsesContentApplicationJsonSchemaVectorDatabases"},"Provider_Status_getProviderStatus_Response_200":{"type":"object","properties":{"embeddingModels":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/V1ProviderStatusGetResponsesContentApplicationJsonSchemaEmbeddingModels"}},"integrations":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/V1ProviderStatusGetResponsesContentApplicationJsonSchemaIntegrations"}},"lastUpdated":{"type":"string"},"platformConfig":{"$ref":"#/components/schemas/V1ProviderStatusGetResponsesContentApplicationJsonSchemaPlatformConfig"},"vectorDatabases":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/V1ProviderStatusGetResponsesContentApplicationJsonSchemaVectorDatabases"}}},"required":["embeddingModels","integrations","lastUpdated","platformConfig","vectorDatabases"],"title":"Provider Status_getProviderStatus_Response_200"},"V1ProviderStatusEmbeddingModelsGetResponsesContentApplicationJsonSchemaModelsItemsSource":{"type":"string","enum":["api","integration"],"title":"V1ProviderStatusEmbeddingModelsGetResponsesContentApplicationJsonSchemaModelsItemsSource"},"V1ProviderStatusEmbeddingModelsGetResponsesContentApplicationJsonSchemaModelsItemsStatus":{"type":"string","enum":["available","needs_config","not_configured"],"title":"V1ProviderStatusEmbeddingModelsGetResponsesContentApplicationJsonSchemaModelsItemsStatus"},"V1ProviderStatusEmbeddingModelsGetResponsesContentApplicationJsonSchemaModelsItems":{"type":"object","properties":{"customKeyProvider":{"type":"string"},"dimensions":{"type":"number","format":"double"},"id":{"type":"string"},"maxTokens":{"type":"number","format":"double"},"name":{"type":"string"},"provider":{"type":"string"},"requiresIntegration":{"type":"string"},"source":{"$ref":"#/components/schemas/V1ProviderStatusEmbeddingModelsGetResponsesContentApplicationJsonSchemaModelsItemsSource"},"status":{"$ref":"#/components/schemas/V1ProviderStatusEmbeddingModelsGetResponsesContentApplicationJsonSchemaModelsItemsStatus"}},"required":["id","name","provider","source","status"],"title":"V1ProviderStatusEmbeddingModelsGetResponsesContentApplicationJsonSchemaModelsItems"},"Provider_Status_getAvailableEmbeddingModels_Response_200":{"type":"object","properties":{"models":{"type":"array","items":{"$ref":"#/components/schemas/V1ProviderStatusEmbeddingModelsGetResponsesContentApplicationJsonSchemaModelsItems"}}},"required":["models"],"title":"Provider Status_getAvailableEmbeddingModels_Response_200"},"FlowValidationResultContext":{"type":"object","properties":{"accountChecksPerformed":{"type":"boolean"},"accountChecksSkipped":{"type":"boolean"},"authenticated":{"type":"boolean"}},"required":["accountChecksPerformed","accountChecksSkipped","authenticated"],"title":"FlowValidationResultContext"},"FlowValidationIssueStep":{"type":"object","properties":{"index":{"type":"integer"},"name":{"type":"string"},"type":{"type":"string"}},"required":["index","name","type"],"title":"FlowValidationIssueStep"},"FlowValidationIssue":{"type":"object","properties":{"code":{"type":"string"},"details":{"description":"Any type"},"message":{"type":"string"},"path":{"type":"string"},"step":{"$ref":"#/components/schemas/FlowValidationIssueStep"}},"required":["code","message"],"title":"FlowValidationIssue"},"FlowValidationResult":{"type":"object","properties":{"context":{"$ref":"#/components/schemas/FlowValidationResultContext"},"errors":{"type":"array","items":{"$ref":"#/components/schemas/FlowValidationIssue"}},"recommendations":{"type":"array","items":{"$ref":"#/components/schemas/FlowValidationIssue"}},"valid":{"type":"boolean"},"warnings":{"type":"array","items":{"$ref":"#/components/schemas/FlowValidationIssue"}}},"required":["context","errors","recommendations","valid","warnings"],"title":"FlowValidationResult"},"V1PublicFlowsValidatePostResponsesContentApplicationJsonSchemaDetailsItems":{"type":"object","properties":{"code":{"type":"string","description":"Stable Runtype validation code (e.g. MISSING_REQUIRED_FIELD, INVALID_ENUM)."},"message":{"type":"string"},"path":{"type":"string","description":"Dotted JSON path to the offending field."},"suggestion":{"type":"string","description":"Actionable hint (allowed values, accepted range, …)."}},"required":["message"],"title":"V1PublicFlowsValidatePostResponsesContentApplicationJsonSchemaDetailsItems"},"ValidateAProspectiveFlowPayloadRequestBadRequestError":{"type":"object","properties":{"code":{"type":"string","description":"Stable error code. `insufficient_scope` marks an API key that lacks a scope this request needs."},"details":{"type":"array","items":{"$ref":"#/components/schemas/V1PublicFlowsValidatePostResponsesContentApplicationJsonSchemaDetailsItems"}},"error":{"type":"string"},"requiredScopes":{"type":"array","items":{"type":"string"},"description":"On `insufficient_scope`: every API key scope this request needs."}},"required":["error"],"title":"ValidateAProspectiveFlowPayloadRequestBadRequestError"},"V1PublicProductsValidatePostResponsesContentApplicationJsonSchemaErrorsItems":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"path":{"type":"string"},"severity":{"type":"string"}},"required":["code","message","path","severity"],"title":"V1PublicProductsValidatePostResponsesContentApplicationJsonSchemaErrorsItems"},"V1PublicProductsValidatePostResponsesContentApplicationJsonSchemaRecommendationsItems":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"path":{"type":"string"},"severity":{"type":"string"}},"required":["code","message","path","severity"],"title":"V1PublicProductsValidatePostResponsesContentApplicationJsonSchemaRecommendationsItems"},"V1PublicProductsValidatePostResponsesContentApplicationJsonSchemaWarningsItems":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"path":{"type":"string"},"severity":{"type":"string"}},"required":["code","message","path","severity"],"title":"V1PublicProductsValidatePostResponsesContentApplicationJsonSchemaWarningsItems"},"Product_Validation_validateAFullProductObjectFpo_Response_200":{"type":"object","properties":{"errors":{"type":"array","items":{"$ref":"#/components/schemas/V1PublicProductsValidatePostResponsesContentApplicationJsonSchemaErrorsItems"}},"recommendations":{"type":"array","items":{"$ref":"#/components/schemas/V1PublicProductsValidatePostResponsesContentApplicationJsonSchemaRecommendationsItems"}},"valid":{"type":"boolean"},"warnings":{"type":"array","items":{"$ref":"#/components/schemas/V1PublicProductsValidatePostResponsesContentApplicationJsonSchemaWarningsItems"}}},"required":["errors","recommendations","valid","warnings"],"title":"Product Validation_validateAFullProductObjectFpo_Response_200"},"ValidateAFullProductObjectFpoRequestInternalServerError":{"type":"object","properties":{"errors":{"type":"array","items":{"$ref":"#/components/schemas/V1PublicProductsValidatePostResponsesContentApplicationJsonSchemaErrorsItems"}},"recommendations":{"type":"array","items":{"$ref":"#/components/schemas/V1PublicProductsValidatePostResponsesContentApplicationJsonSchemaRecommendationsItems"}},"valid":{"type":"boolean"},"warnings":{"type":"array","items":{"$ref":"#/components/schemas/V1PublicProductsValidatePostResponsesContentApplicationJsonSchemaWarningsItems"}}},"required":["errors","recommendations","valid","warnings"],"title":"ValidateAFullProductObjectFpoRequestInternalServerError"},"V1PublicProductsValidateTemplatePostResponsesContentApplicationJsonSchemaErrorsItems":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"path":{"type":"string"},"severity":{"type":"string"}},"required":["code","message","path","severity"],"title":"V1PublicProductsValidateTemplatePostResponsesContentApplicationJsonSchemaErrorsItems"},"V1PublicProductsValidateTemplatePostResponsesContentApplicationJsonSchemaRecommendationsItems":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"path":{"type":"string"},"severity":{"type":"string"}},"required":["code","message","path","severity"],"title":"V1PublicProductsValidateTemplatePostResponsesContentApplicationJsonSchemaRecommendationsItems"},"V1PublicProductsValidateTemplatePostResponsesContentApplicationJsonSchemaWarningsItems":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"path":{"type":"string"},"severity":{"type":"string"}},"required":["code","message","path","severity"],"title":"V1PublicProductsValidateTemplatePostResponsesContentApplicationJsonSchemaWarningsItems"},"Product_Validation_validateAProductTemplate_Response_200":{"type":"object","properties":{"errors":{"type":"array","items":{"$ref":"#/components/schemas/V1PublicProductsValidateTemplatePostResponsesContentApplicationJsonSchemaErrorsItems"}},"recommendations":{"type":"array","items":{"$ref":"#/components/schemas/V1PublicProductsValidateTemplatePostResponsesContentApplicationJsonSchemaRecommendationsItems"}},"valid":{"type":"boolean"},"warnings":{"type":"array","items":{"$ref":"#/components/schemas/V1PublicProductsValidateTemplatePostResponsesContentApplicationJsonSchemaWarningsItems"}}},"required":["errors","recommendations","valid","warnings"],"title":"Product Validation_validateAProductTemplate_Response_200"},"ValidateAProductTemplateRequestInternalServerError":{"type":"object","properties":{"errors":{"type":"array","items":{"$ref":"#/components/schemas/V1PublicProductsValidateTemplatePostResponsesContentApplicationJsonSchemaErrorsItems"}},"recommendations":{"type":"array","items":{"$ref":"#/components/schemas/V1PublicProductsValidateTemplatePostResponsesContentApplicationJsonSchemaRecommendationsItems"}},"valid":{"type":"boolean"},"warnings":{"type":"array","items":{"$ref":"#/components/schemas/V1PublicProductsValidateTemplatePostResponsesContentApplicationJsonSchemaWarningsItems"}}},"required":["errors","recommendations","valid","warnings"],"title":"ValidateAProductTemplateRequestInternalServerError"},"V1PublicProductsValidateAgentPostResponsesContentApplicationJsonSchemaErrorsItems":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"path":{"type":"string"},"severity":{"type":"string"}},"required":["code","message","path","severity"],"title":"V1PublicProductsValidateAgentPostResponsesContentApplicationJsonSchemaErrorsItems"},"V1PublicProductsValidateAgentPostResponsesContentApplicationJsonSchemaRecommendationsItems":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"path":{"type":"string"},"severity":{"type":"string"}},"required":["code","message","path","severity"],"title":"V1PublicProductsValidateAgentPostResponsesContentApplicationJsonSchemaRecommendationsItems"},"V1PublicProductsValidateAgentPostResponsesContentApplicationJsonSchemaWarningsItems":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"path":{"type":"string"},"severity":{"type":"string"}},"required":["code","message","path","severity"],"title":"V1PublicProductsValidateAgentPostResponsesContentApplicationJsonSchemaWarningsItems"},"Product_Validation_validateAStandaloneAgentDefinition_Response_200":{"type":"object","properties":{"errors":{"type":"array","items":{"$ref":"#/components/schemas/V1PublicProductsValidateAgentPostResponsesContentApplicationJsonSchemaErrorsItems"}},"recommendations":{"type":"array","items":{"$ref":"#/components/schemas/V1PublicProductsValidateAgentPostResponsesContentApplicationJsonSchemaRecommendationsItems"}},"valid":{"type":"boolean"},"warnings":{"type":"array","items":{"$ref":"#/components/schemas/V1PublicProductsValidateAgentPostResponsesContentApplicationJsonSchemaWarningsItems"}}},"required":["errors","recommendations","valid","warnings"],"title":"Product Validation_validateAStandaloneAgentDefinition_Response_200"},"ValidateAStandaloneAgentDefinitionRequestInternalServerError":{"type":"object","properties":{"errors":{"type":"array","items":{"$ref":"#/components/schemas/V1PublicProductsValidateAgentPostResponsesContentApplicationJsonSchemaErrorsItems"}},"recommendations":{"type":"array","items":{"$ref":"#/components/schemas/V1PublicProductsValidateAgentPostResponsesContentApplicationJsonSchemaRecommendationsItems"}},"valid":{"type":"boolean"},"warnings":{"type":"array","items":{"$ref":"#/components/schemas/V1PublicProductsValidateAgentPostResponsesContentApplicationJsonSchemaWarningsItems"}}},"required":["errors","recommendations","valid","warnings"],"title":"ValidateAStandaloneAgentDefinitionRequestInternalServerError"},"V1PublicProductsValidateFlowPostResponsesContentApplicationJsonSchemaErrorsItems":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"path":{"type":"string"},"severity":{"type":"string"}},"required":["code","message","path","severity"],"title":"V1PublicProductsValidateFlowPostResponsesContentApplicationJsonSchemaErrorsItems"},"V1PublicProductsValidateFlowPostResponsesContentApplicationJsonSchemaRecommendationsItems":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"path":{"type":"string"},"severity":{"type":"string"}},"required":["code","message","path","severity"],"title":"V1PublicProductsValidateFlowPostResponsesContentApplicationJsonSchemaRecommendationsItems"},"V1PublicProductsValidateFlowPostResponsesContentApplicationJsonSchemaWarningsItems":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"path":{"type":"string"},"severity":{"type":"string"}},"required":["code","message","path","severity"],"title":"V1PublicProductsValidateFlowPostResponsesContentApplicationJsonSchemaWarningsItems"},"Product_Validation_validateAStandaloneFlowDefinition_Response_200":{"type":"object","properties":{"errors":{"type":"array","items":{"$ref":"#/components/schemas/V1PublicProductsValidateFlowPostResponsesContentApplicationJsonSchemaErrorsItems"}},"recommendations":{"type":"array","items":{"$ref":"#/components/schemas/V1PublicProductsValidateFlowPostResponsesContentApplicationJsonSchemaRecommendationsItems"}},"valid":{"type":"boolean"},"warnings":{"type":"array","items":{"$ref":"#/components/schemas/V1PublicProductsValidateFlowPostResponsesContentApplicationJsonSchemaWarningsItems"}}},"required":["errors","recommendations","valid","warnings"],"title":"Product Validation_validateAStandaloneFlowDefinition_Response_200"},"ValidateAStandaloneFlowDefinitionRequestInternalServerError":{"type":"object","properties":{"errors":{"type":"array","items":{"$ref":"#/components/schemas/V1PublicProductsValidateFlowPostResponsesContentApplicationJsonSchemaErrorsItems"}},"recommendations":{"type":"array","items":{"$ref":"#/components/schemas/V1PublicProductsValidateFlowPostResponsesContentApplicationJsonSchemaRecommendationsItems"}},"valid":{"type":"boolean"},"warnings":{"type":"array","items":{"$ref":"#/components/schemas/V1PublicProductsValidateFlowPostResponsesContentApplicationJsonSchemaWarningsItems"}}},"required":["errors","recommendations","valid","warnings"],"title":"ValidateAStandaloneFlowDefinitionRequestInternalServerError"},"V1PublicProductsValidateSurfacePostResponsesContentApplicationJsonSchemaErrorsItems":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"path":{"type":"string"},"severity":{"type":"string"}},"required":["code","message","path","severity"],"title":"V1PublicProductsValidateSurfacePostResponsesContentApplicationJsonSchemaErrorsItems"},"V1PublicProductsValidateSurfacePostResponsesContentApplicationJsonSchemaRecommendationsItems":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"path":{"type":"string"},"severity":{"type":"string"}},"required":["code","message","path","severity"],"title":"V1PublicProductsValidateSurfacePostResponsesContentApplicationJsonSchemaRecommendationsItems"},"V1PublicProductsValidateSurfacePostResponsesContentApplicationJsonSchemaWarningsItems":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"path":{"type":"string"},"severity":{"type":"string"}},"required":["code","message","path","severity"],"title":"V1PublicProductsValidateSurfacePostResponsesContentApplicationJsonSchemaWarningsItems"},"Product_Validation_validateAStandaloneSurfaceDefinition_Response_200":{"type":"object","properties":{"errors":{"type":"array","items":{"$ref":"#/components/schemas/V1PublicProductsValidateSurfacePostResponsesContentApplicationJsonSchemaErrorsItems"}},"recommendations":{"type":"array","items":{"$ref":"#/components/schemas/V1PublicProductsValidateSurfacePostResponsesContentApplicationJsonSchemaRecommendationsItems"}},"valid":{"type":"boolean"},"warnings":{"type":"array","items":{"$ref":"#/components/schemas/V1PublicProductsValidateSurfacePostResponsesContentApplicationJsonSchemaWarningsItems"}}},"required":["errors","recommendations","valid","warnings"],"title":"Product Validation_validateAStandaloneSurfaceDefinition_Response_200"},"ValidateAStandaloneSurfaceDefinitionRequestInternalServerError":{"type":"object","properties":{"errors":{"type":"array","items":{"$ref":"#/components/schemas/V1PublicProductsValidateSurfacePostResponsesContentApplicationJsonSchemaErrorsItems"}},"recommendations":{"type":"array","items":{"$ref":"#/components/schemas/V1PublicProductsValidateSurfacePostResponsesContentApplicationJsonSchemaRecommendationsItems"}},"valid":{"type":"boolean"},"warnings":{"type":"array","items":{"$ref":"#/components/schemas/V1PublicProductsValidateSurfacePostResponsesContentApplicationJsonSchemaWarningsItems"}}},"required":["errors","recommendations","valid","warnings"],"title":"ValidateAStandaloneSurfaceDefinitionRequestInternalServerError"},"V1PublicProductsValidateToolPostResponsesContentApplicationJsonSchemaErrorsItems":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"path":{"type":"string"},"severity":{"type":"string"}},"required":["code","message","path","severity"],"title":"V1PublicProductsValidateToolPostResponsesContentApplicationJsonSchemaErrorsItems"},"V1PublicProductsValidateToolPostResponsesContentApplicationJsonSchemaRecommendationsItems":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"path":{"type":"string"},"severity":{"type":"string"}},"required":["code","message","path","severity"],"title":"V1PublicProductsValidateToolPostResponsesContentApplicationJsonSchemaRecommendationsItems"},"V1PublicProductsValidateToolPostResponsesContentApplicationJsonSchemaWarningsItems":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"path":{"type":"string"},"severity":{"type":"string"}},"required":["code","message","path","severity"],"title":"V1PublicProductsValidateToolPostResponsesContentApplicationJsonSchemaWarningsItems"},"Product_Validation_validateAStandaloneToolDefinition_Response_200":{"type":"object","properties":{"errors":{"type":"array","items":{"$ref":"#/components/schemas/V1PublicProductsValidateToolPostResponsesContentApplicationJsonSchemaErrorsItems"}},"recommendations":{"type":"array","items":{"$ref":"#/components/schemas/V1PublicProductsValidateToolPostResponsesContentApplicationJsonSchemaRecommendationsItems"}},"valid":{"type":"boolean"},"warnings":{"type":"array","items":{"$ref":"#/components/schemas/V1PublicProductsValidateToolPostResponsesContentApplicationJsonSchemaWarningsItems"}}},"required":["errors","recommendations","valid","warnings"],"title":"Product Validation_validateAStandaloneToolDefinition_Response_200"},"ValidateAStandaloneToolDefinitionRequestInternalServerError":{"type":"object","properties":{"errors":{"type":"array","items":{"$ref":"#/components/schemas/V1PublicProductsValidateToolPostResponsesContentApplicationJsonSchemaErrorsItems"}},"recommendations":{"type":"array","items":{"$ref":"#/components/schemas/V1PublicProductsValidateToolPostResponsesContentApplicationJsonSchemaRecommendationsItems"}},"valid":{"type":"boolean"},"warnings":{"type":"array","items":{"$ref":"#/components/schemas/V1PublicProductsValidateToolPostResponsesContentApplicationJsonSchemaWarningsItems"}}},"required":["errors","recommendations","valid","warnings"],"title":"ValidateAStandaloneToolDefinitionRequestInternalServerError"},"V1QuestionSetsGetParametersDirection":{"type":"string","enum":["next","prev"],"title":"V1QuestionSetsGetParametersDirection"},"QuestionSetListItem":{"type":"object","properties":{"createdAt":{"type":"string"},"createdByUserId":{"type":["string","null"]},"currentVersionId":{"type":["string","null"],"description":"The published version executions resolve when they name no version; null until a publish."},"description":{"type":["string","null"]},"id":{"type":"string"},"lastModifiedSource":{"type":["string","null"],"description":"The surface that last wrote the set; `sdk` or `terraform` means it is managed by code through ensure."},"name":{"type":"string"},"organizationId":{"type":"string"},"slug":{"type":"string"},"updatedAt":{"type":"string"},"currentVersionNumber":{"type":["integer","null"]},"latestVersionNumber":{"type":"integer"}},"required":["createdAt","createdByUserId","currentVersionId","description","id","name","organizationId","slug","updatedAt","currentVersionNumber","latestVersionNumber"],"title":"QuestionSetListItem"},"Question_Sets_listQuestionSets_Response_200":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/QuestionSetListItem"}},"pagination":{"$ref":"#/components/schemas/Pagination"}},"required":["data","pagination"],"title":"Question Sets_listQuestionSets_Response_200"},"QuestionSetErrorDetailsItems":{"type":"object","properties":{"code":{"type":"string","description":"Stable Runtype validation code (e.g. MISSING_REQUIRED_FIELD, INVALID_ENUM)."},"message":{"type":"string"},"path":{"type":"string","description":"Dotted JSON path to the offending field."},"suggestion":{"type":"string","description":"Actionable hint (allowed values, accepted range, …)."}},"required":["message"],"title":"QuestionSetErrorDetailsItems"},"QuestionSetError":{"type":"object","properties":{"code":{"type":"string","description":"Stable code, e.g. QUESTION_SET_INVALID or QUESTION_SET_UNRESOLVED."},"details":{"type":"array","items":{"$ref":"#/components/schemas/QuestionSetErrorDetailsItems"}},"error":{"type":"string"},"requiredScopes":{"type":"array","items":{"type":"string"},"description":"On `insufficient_scope`: every API key scope this request needs."}},"required":["error"],"title":"QuestionSetError"},"QuestionSet":{"type":"object","properties":{"createdAt":{"type":"string"},"createdByUserId":{"type":["string","null"]},"currentVersionId":{"type":["string","null"],"description":"The published version executions resolve when they name no version; null until a publish."},"description":{"type":["string","null"]},"id":{"type":"string"},"lastModifiedSource":{"type":["string","null"],"description":"The surface that last wrote the set; `sdk` or `terraform` means it is managed by code through ensure."},"name":{"type":"string"},"organizationId":{"type":"string"},"slug":{"type":"string"},"updatedAt":{"type":"string"}},"required":["createdAt","createdByUserId","currentVersionId","description","id","name","organizationId","slug","updatedAt"],"title":"QuestionSet"},"QuestionSetVersion":{"type":"object","properties":{"createdAt":{"type":"string"},"createdByUserId":{"type":["string","null"]},"currentCalibrationId":{"type":["string","null"]},"id":{"type":"string"},"inputMapping":{"type":["object","null"],"additionalProperties":{"type":"string"}},"model":{"type":["string","null"],"description":"Requested judgment model id; null uses the platform default."},"publishedAt":{"type":["string","null"],"description":"Set once, at the first publish; a published version never changes."},"questionSetId":{"type":"string"},"questions":{"type":"object","additionalProperties":{"description":"Any type"},"description":"Judgment questions keyed by question id. Each is `{ type: \"boolean\" | \"choice\" | \"score\", instructions, criteria }`. The id is never sent to the model, so instructions and criteria carry the meaning."},"versionNumber":{"type":"integer"}},"required":["createdAt","createdByUserId","currentCalibrationId","id","inputMapping","model","publishedAt","questionSetId","questions","versionNumber"],"title":"QuestionSetVersion"},"Question_Sets_createAQuestionSet_Response_201":{"type":"object","properties":{"questionSet":{"$ref":"#/components/schemas/QuestionSet"},"version":{"$ref":"#/components/schemas/QuestionSetVersion"}},"required":["questionSet","version"],"title":"Question Sets_createAQuestionSet_Response_201"},"V1QuestionSetsEnsurePostRequestBodyContentApplicationJsonSchemaDefinition":{"type":"object","properties":{"description":{"type":["string","null"]},"inputMapping":{"type":["object","null"],"additionalProperties":{"type":"string","minLength":1}},"model":{"type":["string","null"],"minLength":1},"name":{"type":"string","minLength":1,"maxLength":255},"questions":{"type":"object","additionalProperties":{"description":"Any type"},"description":"Judgment questions keyed by question id, validated like `POST /v1/question-sets`."}},"required":["name","questions"],"title":"V1QuestionSetsEnsurePostRequestBodyContentApplicationJsonSchemaDefinition"},"V1QuestionSetsEnsurePostRequestBodyContentApplicationJsonSchemaOnConflict":{"type":"string","enum":["error","overwrite"],"title":"V1QuestionSetsEnsurePostRequestBodyContentApplicationJsonSchemaOnConflict"},"V1QuestionSetsEnsurePostRequestBodyContentApplicationJsonSchemaRelease":{"type":"string","enum":["none","publish"],"title":"V1QuestionSetsEnsurePostRequestBodyContentApplicationJsonSchemaRelease"},"QuestionSetEnsureResponseOneOf0Result":{"type":"string","enum":["unchanged","created","updated"],"title":"QuestionSetEnsureResponseOneOf0Result"},"QuestionSetEnsureResponse0":{"type":"object","properties":{"contentHash":{"type":"string","description":"Server-computed canonical content hash. Clients should echo this hash in probes."},"publishedVersionNumber":{"type":["integer","null"],"description":"The version executions resolve when they name none; null until a publish."},"questionSetId":{"type":"string"},"result":{"$ref":"#/components/schemas/QuestionSetEnsureResponseOneOf0Result"},"versionId":{"type":["string","null"],"description":"The latest version, which the converged definition matches."},"versionNumber":{"type":["integer","null"]}},"required":["contentHash","publishedVersionNumber","questionSetId","result","versionId","versionNumber"],"title":"QuestionSetEnsureResponse0"},"QuestionSetEnsureResponseOneOf1Result":{"type":"string","enum":["definitionRequired"],"title":"QuestionSetEnsureResponseOneOf1Result"},"QuestionSetEnsureResponse1":{"type":"object","properties":{"result":{"$ref":"#/components/schemas/QuestionSetEnsureResponseOneOf1Result"}},"required":["result"],"title":"QuestionSetEnsureResponse1"},"QuestionSetEnsureResponseOneOf2Changes":{"type":"string","enum":["none","create","update"],"title":"QuestionSetEnsureResponseOneOf2Changes"},"QuestionSetEnsureResponseOneOf2Result":{"type":"string","enum":["plan"],"title":"QuestionSetEnsureResponseOneOf2Result"},"QuestionSetEnsureResponse2":{"type":"object","properties":{"changedKeys":{"type":"array","items":{"type":"string"}},"changes":{"$ref":"#/components/schemas/QuestionSetEnsureResponseOneOf2Changes"},"contentHash":{"type":"string"},"questionSetId":{"type":"string"},"remoteHash":{"type":"string"},"result":{"$ref":"#/components/schemas/QuestionSetEnsureResponseOneOf2Result"}},"required":["changedKeys","changes","contentHash","result"],"title":"QuestionSetEnsureResponse2"},"QuestionSetEnsureResponse":{"oneOf":[{"$ref":"#/components/schemas/QuestionSetEnsureResponse0"},{"$ref":"#/components/schemas/QuestionSetEnsureResponse1"},{"$ref":"#/components/schemas/QuestionSetEnsureResponse2"}],"title":"QuestionSetEnsureResponse"},"V1QuestionSetsEnsurePostResponsesContentApplicationJsonSchemaDetailsItems":{"type":"object","properties":{"code":{"type":"string","description":"Stable Runtype validation code (e.g. MISSING_REQUIRED_FIELD, INVALID_ENUM)."},"message":{"type":"string"},"path":{"type":"string","description":"Dotted JSON path to the offending field."},"suggestion":{"type":"string","description":"Actionable hint (allowed values, accepted range, …)."}},"required":["message"],"title":"V1QuestionSetsEnsurePostResponsesContentApplicationJsonSchemaDetailsItems"},"EnsureQuestionSetConfigAsCodeConvergeRequestBadRequestError":{"type":"object","properties":{"code":{"type":"string","description":"Stable error code. `insufficient_scope` marks an API key that lacks a scope this request needs."},"details":{"type":"array","items":{"$ref":"#/components/schemas/V1QuestionSetsEnsurePostResponsesContentApplicationJsonSchemaDetailsItems"}},"error":{"type":"string"},"requiredScopes":{"type":"array","items":{"type":"string"},"description":"On `insufficient_scope`: every API key scope this request needs."}},"required":["error"],"title":"EnsureQuestionSetConfigAsCodeConvergeRequestBadRequestError"},"EnsureQuestionSetConfigAsCodeConvergeRequestNotFoundError":{"type":"object","properties":{"code":{"type":"string","description":"Stable error code. `insufficient_scope` marks an API key that lacks a scope this request needs."},"details":{"type":"array","items":{"$ref":"#/components/schemas/V1QuestionSetsEnsurePostResponsesContentApplicationJsonSchemaDetailsItems"}},"error":{"type":"string"},"requiredScopes":{"type":"array","items":{"type":"string"},"description":"On `insufficient_scope`: every API key scope this request needs."}},"required":["error"],"title":"EnsureQuestionSetConfigAsCodeConvergeRequestNotFoundError"},"QuestionSetEnsureConflict":{"type":"object","properties":{"code":{"type":"string","description":"external_modification, remote_changed, or a question set code such as QUESTION_SET_SLUG_TAKEN."},"currentHash":{"type":["string","null"]},"error":{"type":"string"},"lastModifiedSource":{"type":"string"},"modifiedAt":{"type":["string","null"]}},"required":["code","error"],"title":"QuestionSetEnsureConflict"},"QuestionSetEnsureHashMismatchCode":{"type":"string","enum":["content_hash_mismatch"],"title":"QuestionSetEnsureHashMismatchCode"},"QuestionSetEnsureHashMismatch":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/QuestionSetEnsureHashMismatchCode"},"contentHash":{"type":"string","description":"The server-computed canonical hash of the submitted definition."},"error":{"type":"string"}},"required":["code","contentHash","error"],"title":"QuestionSetEnsureHashMismatch"},"QuestionSetPullResponseDefinition":{"type":"object","properties":{"description":{"type":["string","null"]},"inputMapping":{"type":["object","null"],"additionalProperties":{"type":"string"}},"model":{"type":["string","null"]},"name":{"type":"string"},"questions":{"type":"object","additionalProperties":{"description":"Any type"}},"slug":{"type":"string"}},"required":["name","questions","slug"],"title":"QuestionSetPullResponseDefinition"},"QuestionSetPullResponse":{"type":"object","properties":{"contentHash":{"type":"string"},"definition":{"$ref":"#/components/schemas/QuestionSetPullResponseDefinition"},"lastModifiedSource":{"type":["string","null"]},"publishedVersionNumber":{"type":["integer","null"]},"questionSetId":{"type":"string"},"updatedAt":{"type":["string","null"]},"versionNumber":{"type":["integer","null"]}},"required":["contentHash","definition","lastModifiedSource","publishedVersionNumber","questionSetId","updatedAt","versionNumber"],"title":"QuestionSetPullResponse"},"Question_Sets_getAQuestionSet_Response_200":{"type":"object","properties":{"questionSet":{"$ref":"#/components/schemas/QuestionSet"},"versions":{"type":"array","items":{"$ref":"#/components/schemas/QuestionSetVersion"}}},"required":["questionSet","versions"],"title":"Question Sets_getAQuestionSet_Response_200"},"V1QuestionSetsIdPutResponsesContentApplicationJsonSchemaVersion":{"type":"object","properties":{"createdAt":{"type":"string"},"createdByUserId":{"type":["string","null"]},"currentCalibrationId":{"type":["string","null"]},"id":{"type":"string"},"inputMapping":{"type":["object","null"],"additionalProperties":{"type":"string"}},"model":{"type":["string","null"],"description":"Requested judgment model id; null uses the platform default."},"publishedAt":{"type":["string","null"],"description":"Set once, at the first publish; a published version never changes."},"questionSetId":{"type":"string"},"questions":{"type":"object","additionalProperties":{"description":"Any type"},"description":"Judgment questions keyed by question id. Each is `{ type: \"boolean\" | \"choice\" | \"score\", instructions, criteria }`. The id is never sent to the model, so instructions and criteria carry the meaning."},"versionNumber":{"type":"integer"}},"required":["createdAt","createdByUserId","currentCalibrationId","id","inputMapping","model","publishedAt","questionSetId","questions","versionNumber"],"description":"The new draft version, or null for a metadata-only update.","title":"V1QuestionSetsIdPutResponsesContentApplicationJsonSchemaVersion"},"Question_Sets_updateAQuestionSet_Response_200":{"type":"object","properties":{"questionSet":{"$ref":"#/components/schemas/QuestionSet"},"version":{"oneOf":[{"$ref":"#/components/schemas/V1QuestionSetsIdPutResponsesContentApplicationJsonSchemaVersion"},{"type":"null"}],"description":"The new draft version, or null for a metadata-only update."}},"required":["questionSet","version"],"title":"Question Sets_updateAQuestionSet_Response_200"},"ResolvedQuestionSetCalibrationSource":{"type":"string","enum":["eval_suite","customer"],"title":"ResolvedQuestionSetCalibrationSource"},"ResolvedQuestionSetCalibration":{"type":"object","properties":{"createdAt":{"type":"string"},"id":{"type":"string"},"measuredModel":{"type":"string"},"record":{"type":"object","additionalProperties":{"description":"Any type"}},"source":{"$ref":"#/components/schemas/ResolvedQuestionSetCalibrationSource"}},"required":["createdAt","id","measuredModel","record","source"],"title":"ResolvedQuestionSetCalibration"},"ResolvedQuestionSet":{"type":"object","properties":{"calibration":{"oneOf":[{"$ref":"#/components/schemas/ResolvedQuestionSetCalibration"},{"type":"null"}]},"id":{"type":"string"},"inputMapping":{"type":["object","null"],"additionalProperties":{"type":"string"}},"model":{"type":["string","null"]},"questions":{"type":"object","additionalProperties":{"description":"Any type"},"description":"Judgment questions keyed by question id. Each is `{ type: \"boolean\" | \"choice\" | \"score\", instructions, criteria }`. The id is never sent to the model, so instructions and criteria carry the meaning."},"slug":{"type":"string"},"version":{"type":"integer"}},"required":["calibration","id","inputMapping","model","questions","slug","version"],"title":"ResolvedQuestionSet"},"Question_Sets_listAQuestionSetsVersions_Response_200":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/QuestionSetVersion"}}},"required":["data"],"title":"Question Sets_listAQuestionSetsVersions_Response_200"},"JudgmentCalibrationRecordSource":{"type":"string","enum":["eval_suite","customer"],"description":"Derived: `eval_suite` only when the posted `evalRunId` resolved to an eval run in this account.","title":"JudgmentCalibrationRecordSource"},"JudgmentCalibrationRecord":{"type":"object","properties":{"createdAt":{"type":"string"},"createdByUserId":{"type":["string","null"]},"evalRunId":{"type":["string","null"]},"id":{"type":"string"},"measuredModel":{"type":"string"},"questionSetVersionId":{"type":"string"},"record":{"type":"object","additionalProperties":{"description":"Any type"},"description":"The calibration record as posted."},"source":{"$ref":"#/components/schemas/JudgmentCalibrationRecordSource","description":"Derived: `eval_suite` only when the posted `evalRunId` resolved to an eval run in this account."}},"required":["createdAt","createdByUserId","evalRunId","id","measuredModel","questionSetVersionId","record","source"],"title":"JudgmentCalibrationRecord"},"Question_Sets_listAQuestionSetVersionsCalibrations_Response_200":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/JudgmentCalibrationRecord"}},"pagination":{"$ref":"#/components/schemas/Pagination"}},"required":["data","pagination"],"title":"Question Sets_listAQuestionSetVersionsCalibrations_Response_200"},"V1QuestionSetsIdVersionsVersionNumberCalibrationsPostRequestBodyContentApplicationJsonSchemaRecordPerQuestion":{"type":"object","properties":{"ece":{"type":"number","format":"double","minimum":0,"maximum":1},"handledRate":{"type":"number","format":"double","minimum":0,"maximum":1},"heldOutAccuracy":{"type":"number","format":"double","minimum":0,"maximum":1},"targetAccuracy":{"type":"number","format":"double","minimum":0,"maximum":1},"threshold":{"type":"number","format":"double","minimum":0,"maximum":1}},"required":["ece","handledRate","heldOutAccuracy","targetAccuracy","threshold"],"title":"V1QuestionSetsIdVersionsVersionNumberCalibrationsPostRequestBodyContentApplicationJsonSchemaRecordPerQuestion"},"V1QuestionSetsIdVersionsVersionNumberCalibrationsPostRequestBodyContentApplicationJsonSchemaRecord":{"type":"object","properties":{"labeledSetRef":{"type":"string","minLength":1},"measuredModel":{"type":"string","minLength":1},"perQuestion":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/V1QuestionSetsIdVersionsVersionNumberCalibrationsPostRequestBodyContentApplicationJsonSchemaRecordPerQuestion"}}},"required":["labeledSetRef","measuredModel","perQuestion"],"title":"V1QuestionSetsIdVersionsVersionNumberCalibrationsPostRequestBodyContentApplicationJsonSchemaRecord"},"Question_Sets_recordACalibrationForAQuestionSetVersion_Response_201":{"type":"object","properties":{"calibration":{"$ref":"#/components/schemas/JudgmentCalibrationRecord"},"version":{"$ref":"#/components/schemas/QuestionSetVersion"}},"required":["calibration","version"],"title":"Question Sets_recordACalibrationForAQuestionSetVersion_Response_201"},"V1QuestionSetsIdVersionsVersionNumberPublishPostParametersOnConflict":{"type":"string","enum":["error","overwrite"],"description":"A set managed by code (`lastModifiedSource` is `sdk` or `terraform`) answers 409 `managed_by_code_conflict` unless this is `overwrite`.","title":"V1QuestionSetsIdVersionsVersionNumberPublishPostParametersOnConflict"},"Question_Sets_publishAQuestionSetVersion_Response_200":{"type":"object","properties":{"questionSet":{"$ref":"#/components/schemas/QuestionSet"},"version":{"$ref":"#/components/schemas/QuestionSetVersion"}},"required":["questionSet","version"],"title":"Question Sets_publishAQuestionSetVersion_Response_200"},"V1RecordsGetParametersView":{"type":"string","enum":["full","compact"],"description":"Response representation. `full` (default) preserves complete values; `compact` shortens every string value longer than 100 characters to a 100-character preview followed by `…`.","title":"V1RecordsGetParametersView"},"V1RecordsGetResponsesContentApplicationJsonSchemaDataItemsMetadataSchema":{"type":"object","properties":{"keys":{"type":"array","items":{"type":"string"}}},"required":["keys"],"title":"V1RecordsGetResponsesContentApplicationJsonSchemaDataItemsMetadataSchema"},"V1RecordsGetResponsesContentApplicationJsonSchemaDataItems":{"type":"object","properties":{"availableFields":{"type":"array","items":{"type":"string"}},"createdAt":{"type":"string"},"id":{"type":"string"},"messages":{"type":["array","null"],"items":{"description":"Any type"}},"metadata":{"type":"object","additionalProperties":{"description":"Any type"}},"metadataLabels":{"type":"object","additionalProperties":{"type":"string"}},"metadataSchema":{"$ref":"#/components/schemas/V1RecordsGetResponsesContentApplicationJsonSchemaDataItemsMetadataSchema"},"name":{"type":"string"},"organizationId":{"type":["string","null"]},"ownerId":{"type":["string","null"]},"productSurfaceId":{"type":["string","null"]},"schemaValid":{"type":["boolean","null"]},"type":{"type":"string"},"updatedAt":{"type":"string"},"userId":{"type":"string"}},"required":["createdAt","id","messages","metadata","name","organizationId","ownerId","productSurfaceId","schemaValid","type","updatedAt","userId"],"title":"V1RecordsGetResponsesContentApplicationJsonSchemaDataItems"},"V1RecordsGetResponsesContentApplicationJsonSchemaSummariesItems":{"type":"object","properties":{"latestUpdatedAt":{"type":["string","null"]},"total":{"type":"integer"},"type":{"type":"string"}},"required":["latestUpdatedAt","total","type"],"title":"V1RecordsGetResponsesContentApplicationJsonSchemaSummariesItems"},"Records_listRecords_Response_200":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1RecordsGetResponsesContentApplicationJsonSchemaDataItems"}},"filtersApplied":{"type":"object","additionalProperties":{"description":"Any type"}},"pagination":{"$ref":"#/components/schemas/Pagination"},"summaries":{"type":"array","items":{"$ref":"#/components/schemas/V1RecordsGetResponsesContentApplicationJsonSchemaSummariesItems"},"description":"Per-type record counts and latest write timestamps when distinct=types and includeSummary=true."}},"required":["data","pagination"],"title":"Records_listRecords_Response_200"},"V1RecordsPostRequestBodyContentApplicationJsonSchemaMessagesItemsContent":{"oneOf":[{"type":"string"},{"type":"array","items":{"description":"Any type"}}],"title":"V1RecordsPostRequestBodyContentApplicationJsonSchemaMessagesItemsContent"},"V1RecordsPostRequestBodyContentApplicationJsonSchemaMessagesItemsRole":{"type":"string","enum":["user","assistant"],"title":"V1RecordsPostRequestBodyContentApplicationJsonSchemaMessagesItemsRole"},"V1RecordsPostRequestBodyContentApplicationJsonSchemaMessagesItems":{"type":"object","properties":{"content":{"$ref":"#/components/schemas/V1RecordsPostRequestBodyContentApplicationJsonSchemaMessagesItemsContent"},"role":{"$ref":"#/components/schemas/V1RecordsPostRequestBodyContentApplicationJsonSchemaMessagesItemsRole"}},"required":["content","role"],"title":"V1RecordsPostRequestBodyContentApplicationJsonSchemaMessagesItems"},"V1RecordsPostResponsesContentApplicationJsonSchemaMetadataSchema":{"type":"object","properties":{"keys":{"type":"array","items":{"type":"string"}}},"required":["keys"],"title":"V1RecordsPostResponsesContentApplicationJsonSchemaMetadataSchema"},"V1RecordsPostResponsesContentApplicationJsonSchemaSchemaWarningsItems":{"type":"object","properties":{"code":{"type":"string"},"field":{"type":"string"},"message":{"type":"string"}},"required":["code","field","message"],"title":"V1RecordsPostResponsesContentApplicationJsonSchemaSchemaWarningsItems"},"V1RecordsPostResponsesContentApplicationJsonSchemaWarningsItemsCode":{"type":"string","enum":["KEY_RENAMED"],"title":"V1RecordsPostResponsesContentApplicationJsonSchemaWarningsItemsCode"},"V1RecordsPostResponsesContentApplicationJsonSchemaWarningsItems":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/V1RecordsPostResponsesContentApplicationJsonSchemaWarningsItemsCode"},"from":{"type":"string"},"to":{"type":"string"}},"required":["code","from","to"],"title":"V1RecordsPostResponsesContentApplicationJsonSchemaWarningsItems"},"Records_createRecord_Response_201":{"type":"object","properties":{"createdAt":{"type":"string"},"id":{"type":"string"},"messages":{"type":["array","null"],"items":{"description":"Any type"}},"metadata":{"type":"object","additionalProperties":{"description":"Any type"}},"metadataLabels":{"type":"object","additionalProperties":{"type":"string"}},"metadataSchema":{"$ref":"#/components/schemas/V1RecordsPostResponsesContentApplicationJsonSchemaMetadataSchema"},"name":{"type":"string"},"organizationId":{"type":["string","null"]},"ownerId":{"type":["string","null"]},"productSurfaceId":{"type":["string","null"]},"schemaValid":{"type":["boolean","null"]},"schemaWarnings":{"type":"array","items":{"$ref":"#/components/schemas/V1RecordsPostResponsesContentApplicationJsonSchemaSchemaWarningsItems"}},"type":{"type":"string"},"updatedAt":{"type":"string"},"userId":{"type":"string"},"warnings":{"type":"array","items":{"$ref":"#/components/schemas/V1RecordsPostResponsesContentApplicationJsonSchemaWarningsItems"}}},"required":["createdAt","id","messages","metadata","name","organizationId","ownerId","productSurfaceId","schemaValid","type","updatedAt","userId"],"title":"Records_createRecord_Response_201"},"Records_bulkDeleteRecords_Response_200":{"type":"object","properties":{"deleted":{"type":"integer"},"deletedIds":{"type":"array","items":{"type":"string"}},"notFoundIds":{"type":"array","items":{"type":"string"}},"success":{"type":"boolean"}},"required":["deleted","deletedIds","success"],"title":"Records_bulkDeleteRecords_Response_200"},"V1RecordsBulkEditPostRequestBodyContentApplicationJsonSchemaConditionsItemsOperator":{"type":"string","enum":["equals","equals_ci","not_equals","contains","not_contains"],"title":"V1RecordsBulkEditPostRequestBodyContentApplicationJsonSchemaConditionsItemsOperator"},"V1RecordsBulkEditPostRequestBodyContentApplicationJsonSchemaConditionsItemsValue":{"oneOf":[{"type":"string"},{"type":"number","format":"double"},{"type":"boolean"}],"title":"V1RecordsBulkEditPostRequestBodyContentApplicationJsonSchemaConditionsItemsValue"},"V1RecordsBulkEditPostRequestBodyContentApplicationJsonSchemaConditionsItems":{"type":"object","properties":{"field":{"type":"string","minLength":1},"operator":{"$ref":"#/components/schemas/V1RecordsBulkEditPostRequestBodyContentApplicationJsonSchemaConditionsItemsOperator"},"value":{"$ref":"#/components/schemas/V1RecordsBulkEditPostRequestBodyContentApplicationJsonSchemaConditionsItemsValue"}},"required":["field","operator","value"],"title":"V1RecordsBulkEditPostRequestBodyContentApplicationJsonSchemaConditionsItems"},"V1RecordsBulkEditPostRequestBodyContentApplicationJsonSchemaRecordFilterWhereOneOf1ConditionsItemsOneOf1Op":{"type":"string","enum":["and","or"],"title":"V1RecordsBulkEditPostRequestBodyContentApplicationJsonSchemaRecordFilterWhereOneOf1ConditionsItemsOneOf1Op"},"V1RecordsBulkEditPostRequestBodyContentApplicationJsonSchemaRecordFilterWhereOneOf1ConditionsItems1":{"type":"object","properties":{"conditions":{"type":"array","items":{"$ref":"#/components/schemas/RecordFilterCondition"}},"op":{"$ref":"#/components/schemas/V1RecordsBulkEditPostRequestBodyContentApplicationJsonSchemaRecordFilterWhereOneOf1ConditionsItemsOneOf1Op"}},"required":["conditions","op"],"title":"V1RecordsBulkEditPostRequestBodyContentApplicationJsonSchemaRecordFilterWhereOneOf1ConditionsItems1"},"V1RecordsBulkEditPostRequestBodyContentApplicationJsonSchemaRecordFilterWhereOneOf1ConditionsItems":{"oneOf":[{"$ref":"#/components/schemas/RecordFilterCondition"},{"$ref":"#/components/schemas/V1RecordsBulkEditPostRequestBodyContentApplicationJsonSchemaRecordFilterWhereOneOf1ConditionsItems1"}],"title":"V1RecordsBulkEditPostRequestBodyContentApplicationJsonSchemaRecordFilterWhereOneOf1ConditionsItems"},"V1RecordsBulkEditPostRequestBodyContentApplicationJsonSchemaRecordFilterWhereOneOf1Op":{"type":"string","enum":["and","or"],"title":"V1RecordsBulkEditPostRequestBodyContentApplicationJsonSchemaRecordFilterWhereOneOf1Op"},"V1RecordsBulkEditPostRequestBodyContentApplicationJsonSchemaRecordFilterWhere1":{"type":"object","properties":{"conditions":{"type":"array","items":{"$ref":"#/components/schemas/V1RecordsBulkEditPostRequestBodyContentApplicationJsonSchemaRecordFilterWhereOneOf1ConditionsItems"}},"op":{"$ref":"#/components/schemas/V1RecordsBulkEditPostRequestBodyContentApplicationJsonSchemaRecordFilterWhereOneOf1Op"}},"required":["conditions","op"],"title":"V1RecordsBulkEditPostRequestBodyContentApplicationJsonSchemaRecordFilterWhere1"},"V1RecordsBulkEditPostRequestBodyContentApplicationJsonSchemaRecordFilterWhere":{"oneOf":[{"$ref":"#/components/schemas/RecordFilterCondition"},{"$ref":"#/components/schemas/V1RecordsBulkEditPostRequestBodyContentApplicationJsonSchemaRecordFilterWhere1"}],"title":"V1RecordsBulkEditPostRequestBodyContentApplicationJsonSchemaRecordFilterWhere"},"V1RecordsBulkEditPostRequestBodyContentApplicationJsonSchemaRecordFilter":{"type":"object","properties":{"type":{"type":"string","minLength":1,"maxLength":255},"where":{"$ref":"#/components/schemas/V1RecordsBulkEditPostRequestBodyContentApplicationJsonSchemaRecordFilterWhere"}},"required":["type"],"title":"V1RecordsBulkEditPostRequestBodyContentApplicationJsonSchemaRecordFilter"},"V1RecordsBulkEditPostResponsesContentApplicationJsonSchemaDataItems":{"type":"object","properties":{"after":{"type":"object","additionalProperties":{"description":"Any type"}},"before":{"type":"object","additionalProperties":{"description":"Any type"}},"id":{"type":"string"}},"required":["after","before","id"],"title":"V1RecordsBulkEditPostResponsesContentApplicationJsonSchemaDataItems"},"V1RecordsBulkEditPostResponsesContentApplicationJsonSchemaSchemaWarningsItemsErrorsItems":{"type":"object","properties":{"code":{"type":"string"},"field":{"type":"string"},"message":{"type":"string"}},"required":["code","field","message"],"title":"V1RecordsBulkEditPostResponsesContentApplicationJsonSchemaSchemaWarningsItemsErrorsItems"},"V1RecordsBulkEditPostResponsesContentApplicationJsonSchemaSchemaWarningsItems":{"type":"object","properties":{"errors":{"type":"array","items":{"$ref":"#/components/schemas/V1RecordsBulkEditPostResponsesContentApplicationJsonSchemaSchemaWarningsItemsErrorsItems"}},"recordId":{"type":"string"}},"required":["errors","recordId"],"title":"V1RecordsBulkEditPostResponsesContentApplicationJsonSchemaSchemaWarningsItems"},"V1RecordsBulkEditPostResponsesContentApplicationJsonSchemaWarningsItemsCode":{"type":"string","enum":["KEY_RENAMED"],"title":"V1RecordsBulkEditPostResponsesContentApplicationJsonSchemaWarningsItemsCode"},"V1RecordsBulkEditPostResponsesContentApplicationJsonSchemaWarningsItems":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/V1RecordsBulkEditPostResponsesContentApplicationJsonSchemaWarningsItemsCode"},"from":{"type":"string"},"to":{"type":"string"}},"required":["code","from","to"],"title":"V1RecordsBulkEditPostResponsesContentApplicationJsonSchemaWarningsItems"},"Records_bulkEditRecords_Response_200":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1RecordsBulkEditPostResponsesContentApplicationJsonSchemaDataItems"}},"recordIds":{"type":"array","items":{"type":"string"}},"schemaWarnings":{"type":"array","items":{"$ref":"#/components/schemas/V1RecordsBulkEditPostResponsesContentApplicationJsonSchemaSchemaWarningsItems"}},"warnings":{"type":"array","items":{"$ref":"#/components/schemas/V1RecordsBulkEditPostResponsesContentApplicationJsonSchemaWarningsItems"}}},"required":["data","recordIds"],"title":"Records_bulkEditRecords_Response_200"},"BulkEditErrorDetailsItems":{"type":"object","properties":{"code":{"type":"string","description":"Stable Runtype validation code (e.g. MISSING_REQUIRED_FIELD, INVALID_ENUM)."},"message":{"type":"string"},"path":{"type":"string","description":"Dotted JSON path to the offending field."},"suggestion":{"type":"string","description":"Actionable hint (allowed values, accepted range, …)."}},"required":["message"],"title":"BulkEditErrorDetailsItems"},"BulkEditError":{"type":"object","properties":{"code":{"type":"string","description":"Stable error code. `insufficient_scope` marks an API key that lacks a scope this request needs."},"details":{"type":"array","items":{"$ref":"#/components/schemas/BulkEditErrorDetailsItems"}},"error":{"type":"string"},"requiredScopes":{"type":"array","items":{"type":"string"},"description":"On `insufficient_scope`: every API key scope this request needs."},"limit":{"type":"integer","description":"On `bulk_edit_too_many_records`: the most records one bulk edit can target (5000)."},"message":{"type":"string","description":"On `bulk_edit_too_many_records`: what was refused and how to narrow the edit."}},"required":["error"],"title":"BulkEditError"},"V1RecordsFieldValuesGetResponsesContentApplicationJsonSchemaValuesItems":{"type":"object","properties":{"count":{"type":"integer"},"value":{"description":"Any type"}},"required":["count"],"title":"V1RecordsFieldValuesGetResponsesContentApplicationJsonSchemaValuesItems"},"Records_getFieldValues_Response_200":{"type":"object","properties":{"field":{"type":"string"},"truncated":{"type":"boolean"},"type":{"type":"string"},"values":{"type":"array","items":{"$ref":"#/components/schemas/V1RecordsFieldValuesGetResponsesContentApplicationJsonSchemaValuesItems"}}},"required":["field","truncated","type","values"],"title":"Records_getFieldValues_Response_200"},"V1RecordsPreviewFilterPostRequestBodyContentApplicationJsonSchemaWhereOneOf1ConditionsItemsOneOf1Op":{"type":"string","enum":["and","or"],"title":"V1RecordsPreviewFilterPostRequestBodyContentApplicationJsonSchemaWhereOneOf1ConditionsItemsOneOf1Op"},"V1RecordsPreviewFilterPostRequestBodyContentApplicationJsonSchemaWhereOneOf1ConditionsItems1":{"type":"object","properties":{"conditions":{"type":"array","items":{"$ref":"#/components/schemas/RecordFilterCondition"}},"op":{"$ref":"#/components/schemas/V1RecordsPreviewFilterPostRequestBodyContentApplicationJsonSchemaWhereOneOf1ConditionsItemsOneOf1Op"}},"required":["conditions","op"],"title":"V1RecordsPreviewFilterPostRequestBodyContentApplicationJsonSchemaWhereOneOf1ConditionsItems1"},"V1RecordsPreviewFilterPostRequestBodyContentApplicationJsonSchemaWhereOneOf1ConditionsItems":{"oneOf":[{"$ref":"#/components/schemas/RecordFilterCondition"},{"$ref":"#/components/schemas/V1RecordsPreviewFilterPostRequestBodyContentApplicationJsonSchemaWhereOneOf1ConditionsItems1"}],"title":"V1RecordsPreviewFilterPostRequestBodyContentApplicationJsonSchemaWhereOneOf1ConditionsItems"},"V1RecordsPreviewFilterPostRequestBodyContentApplicationJsonSchemaWhereOneOf1Op":{"type":"string","enum":["and","or"],"title":"V1RecordsPreviewFilterPostRequestBodyContentApplicationJsonSchemaWhereOneOf1Op"},"V1RecordsPreviewFilterPostRequestBodyContentApplicationJsonSchemaWhere1":{"type":"object","properties":{"conditions":{"type":"array","items":{"$ref":"#/components/schemas/V1RecordsPreviewFilterPostRequestBodyContentApplicationJsonSchemaWhereOneOf1ConditionsItems"}},"op":{"$ref":"#/components/schemas/V1RecordsPreviewFilterPostRequestBodyContentApplicationJsonSchemaWhereOneOf1Op"}},"required":["conditions","op"],"title":"V1RecordsPreviewFilterPostRequestBodyContentApplicationJsonSchemaWhere1"},"V1RecordsPreviewFilterPostRequestBodyContentApplicationJsonSchemaWhere":{"oneOf":[{"$ref":"#/components/schemas/RecordFilterCondition"},{"$ref":"#/components/schemas/V1RecordsPreviewFilterPostRequestBodyContentApplicationJsonSchemaWhere1"}],"title":"V1RecordsPreviewFilterPostRequestBodyContentApplicationJsonSchemaWhere"},"V1RecordsPreviewFilterPostResponsesContentApplicationJsonSchemaSamplesItems":{"type":"object","properties":{"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{"description":"Any type"}},"name":{"type":"string"}},"required":["id","metadata","name"],"title":"V1RecordsPreviewFilterPostResponsesContentApplicationJsonSchemaSamplesItems"},"Records_previewRecordFilter_Response_200":{"type":"object","properties":{"matchedCount":{"type":"integer"},"samples":{"type":"array","items":{"$ref":"#/components/schemas/V1RecordsPreviewFilterPostResponsesContentApplicationJsonSchemaSamplesItems"}},"truncated":{"type":"boolean"},"type":{"type":"string"}},"required":["matchedCount","samples","truncated","type"],"title":"Records_previewRecordFilter_Response_200"},"Records_discoverRecordSchema_Response_200":{"type":"object","properties":{"fields":{"type":"array","items":{"description":"Any type"}},"sampledAt":{"type":"string"},"sampledRecords":{"type":"integer"},"totalRecords":{"type":"integer"},"type":{"type":"string"}},"required":["fields","sampledAt","sampledRecords","totalRecords","type"],"title":"Records_discoverRecordSchema_Response_200"},"V1RecordsUploadCsvPostResponsesContentApplicationJsonSchemaRecordsItems":{"type":"object","properties":{"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{"description":"Any type"}},"name":{"type":"string"},"type":{"type":"string"}},"required":["id","metadata","name","type"],"title":"V1RecordsUploadCsvPostResponsesContentApplicationJsonSchemaRecordsItems"},"V1RecordsUploadCsvPostResponsesContentApplicationJsonSchemaWarningsItemsCode":{"type":"string","enum":["KEY_RENAMED"],"title":"V1RecordsUploadCsvPostResponsesContentApplicationJsonSchemaWarningsItemsCode"},"V1RecordsUploadCsvPostResponsesContentApplicationJsonSchemaWarningsItems":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/V1RecordsUploadCsvPostResponsesContentApplicationJsonSchemaWarningsItemsCode"},"from":{"type":"string"},"to":{"type":"string"}},"required":["code","from","to"],"title":"V1RecordsUploadCsvPostResponsesContentApplicationJsonSchemaWarningsItems"},"Records_uploadCsvRecords_Response_201":{"type":"object","properties":{"created":{"type":"integer"},"errorDetails":{"type":"array","items":{"type":"string"}},"errors":{"type":"integer"},"message":{"type":"string"},"records":{"type":"array","items":{"$ref":"#/components/schemas/V1RecordsUploadCsvPostResponsesContentApplicationJsonSchemaRecordsItems"}},"success":{"type":"boolean"},"warnings":{"type":"array","items":{"$ref":"#/components/schemas/V1RecordsUploadCsvPostResponsesContentApplicationJsonSchemaWarningsItems"}}},"required":["created","errorDetails","errors","message","records","success"],"title":"Records_uploadCsvRecords_Response_201"},"V1RecordsIdGetResponsesContentApplicationJsonSchemaMetadataSchema":{"type":"object","properties":{"keys":{"type":"array","items":{"type":"string"}}},"required":["keys"],"title":"V1RecordsIdGetResponsesContentApplicationJsonSchemaMetadataSchema"},"Records_getRecordDetails_Response_200":{"type":"object","properties":{"createdAt":{"type":"string"},"id":{"type":"string"},"messages":{"type":["array","null"],"items":{"description":"Any type"}},"metadata":{"type":"object","additionalProperties":{"description":"Any type"}},"metadataLabels":{"type":"object","additionalProperties":{"type":"string"}},"metadataSchema":{"$ref":"#/components/schemas/V1RecordsIdGetResponsesContentApplicationJsonSchemaMetadataSchema"},"name":{"type":"string"},"organizationId":{"type":["string","null"]},"ownerId":{"type":["string","null"]},"productSurfaceId":{"type":["string","null"]},"schemaValid":{"type":["boolean","null"]},"type":{"type":"string"},"updatedAt":{"type":"string"},"userId":{"type":"string"}},"required":["createdAt","id","messages","metadata","name","organizationId","ownerId","productSurfaceId","schemaValid","type","updatedAt","userId"],"title":"Records_getRecordDetails_Response_200"},"V1RecordsIdPutRequestBodyContentApplicationJsonSchemaMessagesItemsContent":{"oneOf":[{"type":"string"},{"type":"array","items":{"description":"Any type"}}],"title":"V1RecordsIdPutRequestBodyContentApplicationJsonSchemaMessagesItemsContent"},"V1RecordsIdPutRequestBodyContentApplicationJsonSchemaMessagesItemsRole":{"type":"string","enum":["user","assistant"],"title":"V1RecordsIdPutRequestBodyContentApplicationJsonSchemaMessagesItemsRole"},"V1RecordsIdPutRequestBodyContentApplicationJsonSchemaMessagesItems":{"type":"object","properties":{"content":{"$ref":"#/components/schemas/V1RecordsIdPutRequestBodyContentApplicationJsonSchemaMessagesItemsContent"},"role":{"$ref":"#/components/schemas/V1RecordsIdPutRequestBodyContentApplicationJsonSchemaMessagesItemsRole"}},"required":["content","role"],"title":"V1RecordsIdPutRequestBodyContentApplicationJsonSchemaMessagesItems"},"V1RecordsIdPutResponsesContentApplicationJsonSchemaMetadataSchema":{"type":"object","properties":{"keys":{"type":"array","items":{"type":"string"}}},"required":["keys"],"title":"V1RecordsIdPutResponsesContentApplicationJsonSchemaMetadataSchema"},"V1RecordsIdPutResponsesContentApplicationJsonSchemaSchemaWarningsItems":{"type":"object","properties":{"code":{"type":"string"},"field":{"type":"string"},"message":{"type":"string"}},"required":["code","field","message"],"title":"V1RecordsIdPutResponsesContentApplicationJsonSchemaSchemaWarningsItems"},"V1RecordsIdPutResponsesContentApplicationJsonSchemaWarningsItemsCode":{"type":"string","enum":["KEY_RENAMED"],"title":"V1RecordsIdPutResponsesContentApplicationJsonSchemaWarningsItemsCode"},"V1RecordsIdPutResponsesContentApplicationJsonSchemaWarningsItems":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/V1RecordsIdPutResponsesContentApplicationJsonSchemaWarningsItemsCode"},"from":{"type":"string"},"to":{"type":"string"}},"required":["code","from","to"],"title":"V1RecordsIdPutResponsesContentApplicationJsonSchemaWarningsItems"},"Records_updateRecord_Response_200":{"type":"object","properties":{"createdAt":{"type":"string"},"id":{"type":"string"},"messages":{"type":["array","null"],"items":{"description":"Any type"}},"metadata":{"type":"object","additionalProperties":{"description":"Any type"}},"metadataLabels":{"type":"object","additionalProperties":{"type":"string"}},"metadataSchema":{"$ref":"#/components/schemas/V1RecordsIdPutResponsesContentApplicationJsonSchemaMetadataSchema"},"name":{"type":"string"},"organizationId":{"type":["string","null"]},"ownerId":{"type":["string","null"]},"productSurfaceId":{"type":["string","null"]},"schemaValid":{"type":["boolean","null"]},"schemaWarnings":{"type":"array","items":{"$ref":"#/components/schemas/V1RecordsIdPutResponsesContentApplicationJsonSchemaSchemaWarningsItems"}},"type":{"type":"string"},"updatedAt":{"type":"string"},"userId":{"type":"string"},"warnings":{"type":"array","items":{"$ref":"#/components/schemas/V1RecordsIdPutResponsesContentApplicationJsonSchemaWarningsItems"}}},"required":["createdAt","id","messages","metadata","name","organizationId","ownerId","productSurfaceId","schemaValid","type","updatedAt","userId"],"title":"Records_updateRecord_Response_200"},"V1RecordsIdCostsGetResponsesContentApplicationJsonSchemaModelBreakdownItems":{"type":"object","properties":{"cost":{"type":"number","format":"double"},"count":{"type":"integer"},"model":{"type":"string"},"tokens":{"type":"integer"}},"required":["cost","count","model","tokens"],"title":"V1RecordsIdCostsGetResponsesContentApplicationJsonSchemaModelBreakdownItems"},"Records_getRecordCosts_Response_200":{"type":"object","properties":{"completionTokens":{"type":"integer"},"executionCount":{"type":"integer"},"modelBreakdown":{"type":"array","items":{"$ref":"#/components/schemas/V1RecordsIdCostsGetResponsesContentApplicationJsonSchemaModelBreakdownItems"}},"promptTokens":{"type":"integer"},"totalCost":{"type":"number","format":"double"},"totalTokens":{"type":"integer"}},"required":["completionTokens","executionCount","modelBreakdown","promptTokens","totalCost","totalTokens"],"title":"Records_getRecordCosts_Response_200"},"V1RecordsIdResultsGetResponsesContentApplicationJsonSchemaDataItemsExecutionEngine":{"type":"string","enum":["runtime","legacy","external"],"description":"Engine that actually executed this record execution ('runtime' | 'legacy' | 'external'). Recorded at write time from the committed lane decision; never inferred later. 'external' marks a run a customer executed outside Runtype and reported through ingest. Null for rows written before attribution shipped and for units that never started executing.","title":"V1RecordsIdResultsGetResponsesContentApplicationJsonSchemaDataItemsExecutionEngine"},"V1RecordsIdResultsGetResponsesContentApplicationJsonSchemaDataItems":{"type":"object","properties":{"createdAt":{"type":"string"},"estimatedCost":{"type":["string","null"],"description":"Deprecated alias for `modelCost`; identical value.","deprecated":true},"executionEngine":{"$ref":"#/components/schemas/V1RecordsIdResultsGetResponsesContentApplicationJsonSchemaDataItemsExecutionEngine","description":"Engine that actually executed this record execution ('runtime' | 'legacy' | 'external'). Recorded at write time from the committed lane decision; never inferred later. 'external' marks a run a customer executed outside Runtype and reported through ingest. Null for rows written before attribution shipped and for units that never started executing."},"executionTimeMs":{"type":["integer","null"]},"flowId":{"type":["string","null"]},"flowName":{"type":["string","null"]},"id":{"type":"string"},"modelCost":{"type":["string","null"]},"modelUsed":{"type":["string","null"]},"promptId":{"type":["string","null"]},"promptName":{"type":["string","null"]},"recordId":{"type":"string"},"result":{"description":"Any type"},"status":{"type":"string"},"toolCost":{"type":["string","null"],"description":"Built-in tool spend for this execution, as a decimal string. `null` means unknown, not zero: rows written before per-run cost was split into model and tool portions carry no tool figure. A run that genuinely used no billable tool records `\"0\"`. Sum with `modelCost` for the run total, and treat `null` as unknown rather than zero."},"totalTokens":{"type":["integer","null"]}},"required":["createdAt","estimatedCost","executionTimeMs","flowId","flowName","id","modelCost","modelUsed","promptId","promptName","recordId","status","toolCost","totalTokens"],"title":"V1RecordsIdResultsGetResponsesContentApplicationJsonSchemaDataItems"},"V1RecordsIdResultsGetResponsesContentApplicationJsonSchemaPagination":{"type":"object","properties":{"hasMore":{"type":"boolean"},"hasNextPage":{"type":"boolean"},"hasPrev":{"type":"boolean"},"hasPrevPage":{"type":"boolean"},"limit":{"type":"integer"},"page":{"type":"integer"},"total":{"type":"integer"},"totalPages":{"type":"integer"}},"required":["hasMore","hasPrev","limit","page"],"title":"V1RecordsIdResultsGetResponsesContentApplicationJsonSchemaPagination"},"Records_getRecordResults_Response_200":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1RecordsIdResultsGetResponsesContentApplicationJsonSchemaDataItems"}},"pagination":{"$ref":"#/components/schemas/V1RecordsIdResultsGetResponsesContentApplicationJsonSchemaPagination"}},"required":["data","pagination"],"title":"Records_getRecordResults_Response_200"},"V1RecordsIdStepResultsGetResponsesContentApplicationJsonSchemaDataItemsExecutionEngine":{"type":"string","enum":["runtime","legacy","external"],"description":"Engine that actually executed this step ('runtime' | 'legacy' | 'external'). Recorded at write time from the committed lane decision; never inferred later. 'external' marks a run a customer executed outside Runtype and reported through ingest. Null for rows written before attribution shipped and for units that never started executing.","title":"V1RecordsIdStepResultsGetResponsesContentApplicationJsonSchemaDataItemsExecutionEngine"},"V1RecordsIdStepResultsGetResponsesContentApplicationJsonSchemaDataItemsSourcesItems":{"type":"object","properties":{"title":{"type":"string"},"url":{"type":"string"}},"required":["url"],"title":"V1RecordsIdStepResultsGetResponsesContentApplicationJsonSchemaDataItemsSourcesItems"},"V1RecordsIdStepResultsGetResponsesContentApplicationJsonSchemaDataItems":{"type":"object","properties":{"batchExecutionId":{"type":["string","null"]},"cacheReadTokens":{"type":["integer","null"]},"cacheWriteTokens":{"type":["integer","null"]},"completedAt":{"type":["string","null"]},"completionTokens":{"type":["integer","null"]},"createdAt":{"type":"string"},"durationMs":{"type":["integer","null"]},"errorMessage":{"type":["string","null"]},"estimatedCost":{"type":["string","null"]},"executionEngine":{"$ref":"#/components/schemas/V1RecordsIdStepResultsGetResponsesContentApplicationJsonSchemaDataItemsExecutionEngine","description":"Engine that actually executed this step ('runtime' | 'legacy' | 'external'). Recorded at write time from the committed lane decision; never inferred later. 'external' marks a run a customer executed outside Runtype and reported through ingest. Null for rows written before attribution shipped and for units that never started executing."},"executionSessionId":{"type":["string","null"]},"flowId":{"type":["string","null"]},"flowVersionId":{"type":["string","null"]},"id":{"type":"string"},"inputVariables":{"description":"Any type"},"modelUsed":{"type":["string","null"]},"order":{"type":["integer","null"]},"organizationId":{"type":["string","null"]},"outputPreview":{"type":["string","null"]},"promptTokens":{"type":["integer","null"]},"reasoningConfig":{"description":"Any type"},"reasoningRejection":{"description":"Any type"},"reasoningRequested":{"description":"Any type"},"reasoningTokens":{"type":["integer","null"]},"recordId":{"type":["string","null"]},"recordMetadata":{"description":"Any type"},"recordName":{"type":["string","null"]},"resolvedPrompt":{"type":["string","null"]},"retryCount":{"type":["integer","null"]},"sources":{"type":["array","null"],"items":{"$ref":"#/components/schemas/V1RecordsIdStepResultsGetResponsesContentApplicationJsonSchemaDataItemsSourcesItems"}},"startedAt":{"type":["string","null"]},"status":{"type":"string"},"stepConfig":{"description":"Any type"},"stepId":{"type":["string","null"]},"stepName":{"type":"string"},"stepType":{"type":"string"},"totalTokens":{"type":["integer","null"]},"userId":{"type":"string"}},"required":["batchExecutionId","completedAt","createdAt","durationMs","executionSessionId","flowId","flowVersionId","id","order","organizationId","outputPreview","recordId","recordName","startedAt","status","stepId","stepName","stepType","userId"],"title":"V1RecordsIdStepResultsGetResponsesContentApplicationJsonSchemaDataItems"},"V1RecordsIdStepResultsGetResponsesContentApplicationJsonSchemaPagination":{"type":"object","properties":{"hasMore":{"type":"boolean"},"limit":{"type":"integer"},"offset":{"type":"integer"},"returned":{"type":"integer"}},"required":["hasMore","limit","offset","returned"],"title":"V1RecordsIdStepResultsGetResponsesContentApplicationJsonSchemaPagination"},"Records_getRecordStepResults_Response_200":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1RecordsIdStepResultsGetResponsesContentApplicationJsonSchemaDataItems"}},"pagination":{"$ref":"#/components/schemas/V1RecordsIdStepResultsGetResponsesContentApplicationJsonSchemaPagination"}},"required":["data","pagination"],"title":"Records_getRecordStepResults_Response_200"},"V1ResourcesGetResponsesContentApplicationJsonSchemaMcpServersItemsToolsItems":{"type":"object","properties":{"description":{"type":"string"},"name":{"type":"string"}},"required":["description","name"],"title":"V1ResourcesGetResponsesContentApplicationJsonSchemaMcpServersItemsToolsItems"},"V1ResourcesGetResponsesContentApplicationJsonSchemaMcpServersItems":{"type":"object","properties":{"id":{"type":"string"},"isActive":{"type":"boolean"},"name":{"type":"string"},"tools":{"type":"array","items":{"$ref":"#/components/schemas/V1ResourcesGetResponsesContentApplicationJsonSchemaMcpServersItemsToolsItems"}}},"required":["id","isActive","name","tools"],"title":"V1ResourcesGetResponsesContentApplicationJsonSchemaMcpServersItems"},"V1ResourcesGetResponsesContentApplicationJsonSchemaModelsEnabledItems":{"type":"object","properties":{"displayName":{"type":"string"},"id":{"type":"string"},"isDefault":{"type":"boolean"},"modelId":{"type":"string"},"provider":{"type":"string"}},"required":["displayName","id","isDefault","modelId","provider"],"title":"V1ResourcesGetResponsesContentApplicationJsonSchemaModelsEnabledItems"},"V1ResourcesGetResponsesContentApplicationJsonSchemaModels":{"type":"object","properties":{"enabled":{"type":"array","items":{"$ref":"#/components/schemas/V1ResourcesGetResponsesContentApplicationJsonSchemaModelsEnabledItems"}}},"required":["enabled"],"title":"V1ResourcesGetResponsesContentApplicationJsonSchemaModels"},"V1ResourcesGetResponsesContentApplicationJsonSchemaToolsBuiltInItems":{"type":"object","properties":{"category":{"type":"string"},"description":{"type":"string"},"id":{"type":"string"},"name":{"type":"string"}},"required":["category","description","id","name"],"title":"V1ResourcesGetResponsesContentApplicationJsonSchemaToolsBuiltInItems"},"V1ResourcesGetResponsesContentApplicationJsonSchemaToolsCustomItems":{"type":"object","properties":{"description":{"type":["string","null"]},"id":{"type":"string"},"name":{"type":"string"},"toolType":{"type":"string"}},"required":["description","id","name","toolType"],"title":"V1ResourcesGetResponsesContentApplicationJsonSchemaToolsCustomItems"},"V1ResourcesGetResponsesContentApplicationJsonSchemaToolsIntegrationItems":{"type":"object","properties":{"description":{"type":"string"},"displayName":{"type":"string"},"name":{"type":"string"},"serverId":{"type":"string"},"serverName":{"type":"string"},"toolId":{"type":"string"}},"required":["description","displayName","name","serverId","serverName","toolId"],"title":"V1ResourcesGetResponsesContentApplicationJsonSchemaToolsIntegrationItems"},"V1ResourcesGetResponsesContentApplicationJsonSchemaTools":{"type":"object","properties":{"builtIn":{"type":"array","items":{"$ref":"#/components/schemas/V1ResourcesGetResponsesContentApplicationJsonSchemaToolsBuiltInItems"}},"custom":{"type":"array","items":{"$ref":"#/components/schemas/V1ResourcesGetResponsesContentApplicationJsonSchemaToolsCustomItems"}},"integration":{"type":"array","items":{"$ref":"#/components/schemas/V1ResourcesGetResponsesContentApplicationJsonSchemaToolsIntegrationItems"}}},"required":["builtIn","custom","integration"],"title":"V1ResourcesGetResponsesContentApplicationJsonSchemaTools"},"Resources_getAvailableResources_Response_200":{"type":"object","properties":{"mcpServers":{"type":"array","items":{"$ref":"#/components/schemas/V1ResourcesGetResponsesContentApplicationJsonSchemaMcpServersItems"}},"models":{"$ref":"#/components/schemas/V1ResourcesGetResponsesContentApplicationJsonSchemaModels"},"tools":{"$ref":"#/components/schemas/V1ResourcesGetResponsesContentApplicationJsonSchemaTools"}},"required":["mcpServers","models","tools"],"title":"Resources_getAvailableResources_Response_200"},"V1RunsGetParametersAgentId":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Filter by agent id; repeat for a set.","title":"V1RunsGetParametersAgentId"},"V1RunsGetParametersFlowId":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Filter by flow id; repeat for a set.","title":"V1RunsGetParametersFlowId"},"V1RunsGetParametersConversationId":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Filter by conversation id; repeat for a set (at most 100 per request).","title":"V1RunsGetParametersConversationId"},"V1RunsGetParametersBatchExecutionId":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Filter by batch id; repeat for a set.","title":"V1RunsGetParametersBatchExecutionId"},"V1RunsGetParametersIncludeChildren":{"type":"string","enum":["true","false"],"description":"true restores the flat enumeration on the UNSCOPED feed, in which a subagent run and a nested-flow run list beside their parent. The unscoped feed is roots only by default: a row whose parentExecutionId is set folds under its parent and is read with parentExecutionId=<executionId>. Any filter that scopes to a resource — agentId, flowId, conversationId, surfaceId, recordId, batchExecutionId, parentExecutionId, rootExecutionId or executionId — is already an explicit selection and never folds, so an agent that only ever runs as a subagent still lists under agentId. This parameter changes nothing on a scoped request.","title":"V1RunsGetParametersIncludeChildren"},"V1RunsGetParametersExecutionId":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Read specific runs by id; at most 100 per request.","title":"V1RunsGetParametersExecutionId"},"V1RunsGetParametersSource":{"type":"string","enum":["hosted","ingested"],"description":"Filter by producing lane.","title":"V1RunsGetParametersSource"},"V1RunsGetParametersStatus":{"type":"string","enum":["running","completed","failed"],"description":"status accepts only running, completed or failed. queued, awaiting and cancelled exist only in the live overlay, which may never change which rows a page holds, so the server cannot filter on them.","title":"V1RunsGetParametersStatus"},"V1RunsGetParametersTraffic":{"type":"string","enum":["live","test","eval","sim","all"],"description":"live keeps runs real users and integrations started; test keeps runs started from the dashboard (Test, step tests, Ask); eval keeps eval-batch runs; sim keeps simulation turns; all, or omitted, keeps every run. A simulation turn is sim even when a schedule started it, a schedule run is live, and an eval batch run is eval whoever started it.","title":"V1RunsGetParametersTraffic"},"V1RunsGetParametersView":{"type":"string","enum":["compact","full"],"description":"full (the default) returns every field. compact omits exactly these 17: model, stopReason, iterations, inputPreview, flowVersionId, agentVersionId, agentVersionLabel, agentVersionNumber, agentTargetResolution, otelProducer, lastHeartbeatAt, expiresAt, cancelRequestedAt, progress, pendingApproval, budgetExhausted and inputMessages. The status is still overlay-corrected on a compact page; only the fields differ.","title":"V1RunsGetParametersView"},"V1RunsGetParametersOverlay":{"type":"string","enum":["live","none"],"description":"live adds control-plane fields; defaults to live for a session, none for an API key.","title":"V1RunsGetParametersOverlay"},"RunListRowCompleteness":{"type":"string","enum":["partial","complete","conflicted","expired","deleted"],"description":"Storage completeness; null on a row the control-plane arm served.","title":"RunListRowCompleteness"},"RunListRowExternalAgentProtocol":{"type":"string","enum":["a2a","runtype-stream"],"description":"The wire protocol the external agent answered over.","title":"RunListRowExternalAgentProtocol"},"RunListRowExternalAgent":{"type":"object","properties":{"endpointHost":{"type":["string","null"],"maxLength":253,"description":"Hostname of the endpoint that answered, never its path or query."},"framework":{"type":["string","null"],"maxLength":253,"description":"The framework the agent's config declares, a builder-chosen label; null when unset."},"protocol":{"$ref":"#/components/schemas/RunListRowExternalAgentProtocol","description":"The wire protocol the external agent answered over."}},"required":["endpointHost","framework","protocol"],"description":"Set when an external agent (A2A or runtype-stream) answered the turn: the protocol, declared framework and endpoint host stamped on the run header when it was invoked. Null on any other run, and on an external-agent run whose header predates the stamp. A repointed agent keeps one agentId, so this is what tells two of its runs apart.","title":"RunListRowExternalAgent"},"RunListRowKind":{"type":"string","enum":["agent","flow"],"description":"Whether an agent or a flow ran.","title":"RunListRowKind"},"RunListRowOrigin":{"type":"string","enum":["dashboard","api","internal"],"description":"Where the run was dispatched from, taken from the caller's authenticated principal and never from a request field. ANY entrance that resolves a principal stamps it: a Clerk session answers dashboard; a management API key answers api, which includes the Runtype MCP server's tools and Code Mode, since both reach dispatch with a management key; and Runtype's own internal caller answers internal, for example the hosted /v1/mcp proxy. A lane that resolves NO principal carries NULL BY DESIGN: schedule, webhook, messaging, A2A, an agent exposed AS an MCP surface, subagent, nested flow, a client-token product surface (an end user is none of the three origins) and an ingested OTLP run. So NULL says \"no authenticated principal at this entrance\" rather than \"unknown caller\". The one NULL that is not a statement about the lane is a row whose header predates the field or came from the backfill: it stamps nothing even for a run that did resolve a principal.","title":"RunListRowOrigin"},"RunListRowSignalsResultsItemsAnswersBand":{"type":"string","enum":["act","review","low"],"title":"RunListRowSignalsResultsItemsAnswersBand"},"RunListRowSignalsResultsItemsAnswersSource":{"type":"object","properties":{"end":{"type":"integer","minimum":0},"field":{"type":"string"},"spanId":{"type":"string"},"start":{"type":"integer","minimum":0}},"required":["end","field","spanId","start"],"title":"RunListRowSignalsResultsItemsAnswersSource"},"RunListRowSignalsResultsItemsAnswersSourcesItems":{"type":"object","properties":{"end":{"type":"integer","minimum":0},"field":{"type":"string"},"spanId":{"type":"string"},"start":{"type":"integer","minimum":0}},"required":["end","field","spanId","start"],"title":"RunListRowSignalsResultsItemsAnswersSourcesItems"},"RunListRowSignalsResultsItemsAnswers":{"type":"object","properties":{"band":{"$ref":"#/components/schemas/RunListRowSignalsResultsItemsAnswersBand"},"confidence":{"type":"number","format":"double","minimum":0,"maximum":1},"distribution":{"type":"object","additionalProperties":{"type":"number","format":"double"}},"fired":{"type":"boolean"},"pNull":{"type":"number","format":"double"},"refused":{"type":"boolean"},"source":{"$ref":"#/components/schemas/RunListRowSignalsResultsItemsAnswersSource"},"sources":{"type":"array","items":{"$ref":"#/components/schemas/RunListRowSignalsResultsItemsAnswersSourcesItems"}},"value":{"description":"Any type"}},"required":["band"],"title":"RunListRowSignalsResultsItemsAnswers"},"RunListRowSignalsResultsItemsSample":{"type":"string","enum":["uniform","filtered"],"title":"RunListRowSignalsResultsItemsSample"},"RunListRowSignalsResultsItemsSignalSet":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"version":{"type":"integer"}},"required":["id","name","version"],"title":"RunListRowSignalsResultsItemsSignalSet"},"RunListRowSignalsResultsItemsStatus":{"type":"string","enum":["complete","failed","skipped_budget","skipped_policy","skipped_billing"],"title":"RunListRowSignalsResultsItemsStatus"},"RunListRowSignalsResultsItemsTarget":{"type":"object","properties":{"executionId":{"type":"string"},"spanId":{"type":["string","null"]},"turnIndex":{"type":["integer","null"]}},"required":["executionId","spanId","turnIndex"],"title":"RunListRowSignalsResultsItemsTarget"},"RunListRowSignalsResultsItemsUnit":{"type":"string","enum":["turn","conversation","run"],"title":"RunListRowSignalsResultsItemsUnit"},"RunListRowSignalsResultsItems":{"type":"object","properties":{"answers":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/RunListRowSignalsResultsItemsAnswers"}},"bindingId":{"type":"string"},"computedAt":{"type":"string"},"error":{"type":"string"},"fired":{"type":"array","items":{"type":"string"}},"sample":{"$ref":"#/components/schemas/RunListRowSignalsResultsItemsSample"},"signalSet":{"$ref":"#/components/schemas/RunListRowSignalsResultsItemsSignalSet"},"status":{"$ref":"#/components/schemas/RunListRowSignalsResultsItemsStatus"},"target":{"$ref":"#/components/schemas/RunListRowSignalsResultsItemsTarget"},"unit":{"$ref":"#/components/schemas/RunListRowSignalsResultsItemsUnit"},"values":{"type":"object","additionalProperties":{"description":"Any type"}}},"required":["answers","bindingId","computedAt","fired","sample","signalSet","status","target","unit","values"],"title":"RunListRowSignalsResultsItems"},"RunListRowSignalsStatus":{"type":"string","enum":["complete","pending","partial","none","unavailable"],"title":"RunListRowSignalsStatus"},"RunListRowSignals":{"type":"object","properties":{"fired":{"type":"array","items":{"type":"string"}},"results":{"type":"array","items":{"$ref":"#/components/schemas/RunListRowSignalsResultsItems"}},"status":{"$ref":"#/components/schemas/RunListRowSignalsStatus"}},"required":["fired","status"],"description":"Trace signals. A list row carries status and fired only; GET /v1/runs/{id} adds results. Omitted entirely until the organization binds a signal set.","title":"RunListRowSignals"},"RunListRowSource":{"type":"string","enum":["hosted","ingested"],"description":"hosted, or ingested for an OTLP export. An ingested run is never reported running.","title":"RunListRowSource"},"RunListRowStatus":{"type":"string","enum":["queued","running","awaiting","completed","failed","cancelled"],"description":"Customer-facing status, derived by runStatusFrom.","title":"RunListRowStatus"},"RunListRowViaKind":{"type":"string","enum":["schedule","surface","api","mcp","cli","test","eval","simulation"],"description":"One word for the way the run started.","title":"RunListRowViaKind"},"RunListRowVia":{"type":"object","properties":{"id":{"type":["string","null"],"description":"The thing that started it: the schedule id (schedule), product surface id (surface), API key id (api), the acting user id (cli), eval suite id (eval) or simulation run id (simulation). Null for mcp and test, and for an api run whose header predates key stamping."},"kind":{"$ref":"#/components/schemas/RunListRowViaKind","description":"One word for the way the run started."},"label":{"type":["string","null"],"description":"Its display name when the API could resolve one: schedule name, surface name, API key name as it was at dispatch, MCP client name, the acting user's first name, or eval suite name. Null when unresolved, for example a deleted schedule."}},"required":["id","kind","label"],"description":"How the run started, for a Via column. Forward-only for schedule, api key, cli, mcp and eval detail: a header written before those stamps reads null, or falls back to the coarse origin/surface facts when they alone answer it. A label is a snapshot or a lookup and never authority; mcp, cli and sdk are self-declared by the client.","title":"RunListRowVia"},"RunListRow":{"type":"object","properties":{"agentId":{"type":["string","null"],"description":"Agent that ran."},"agentTargetResolution":{"type":["string","null"],"description":"How the run chose its version: alias, version or legacy-live-row. Absent means the overlay did not answer, which is not false and not null."},"agentVersionId":{"type":["string","null"],"description":"Agent version that ran. Absent means the overlay did not answer, which is not false and not null."},"agentVersionLabel":{"type":["string","null"],"description":"Version label. Absent means the overlay did not answer, which is not false and not null."},"agentVersionNumber":{"type":["number","null"],"format":"double","description":"Version number, for a version chip and version grouping. Absent means the overlay did not answer, which is not false and not null."},"batchExecutionId":{"type":["string","null"],"description":"Batch this run belongs to."},"budgetExhausted":{"type":["boolean","null"],"description":"Budget exhausted. Absent means the overlay did not answer, which is not false and not null."},"cacheReadTokens":{"type":["number","null"],"format":"double","description":"Prompt-cache reads summed over the run's model calls (a subset of inputTokens). Returned by GET /v1/runs/{executionId} only; null means no model call reported one."},"cacheWriteTokens":{"type":["number","null"],"format":"double","description":"Prompt-cache writes summed over the run's model calls (a subset of inputTokens). Returned by GET /v1/runs/{executionId} only; null means no model call reported one."},"cancelRequestedAt":{"type":["string","null"],"description":"Cancel request. Absent means the overlay did not answer, which is not false and not null."},"childCount":{"type":["number","null"],"format":"double","description":"How many runs name this one as their parent. The unscoped feed returns roots only, so this is the size of the fold underneath a row; read the children with parentExecutionId=<executionId>. It is populated on a resource-scoped page too, where nothing is folded, so a surface can still offer the same expansion. WHICH children are counted depends on the arm that served the row: the span store counts every child, agent and nested-flow alike, while the legacy control-plane fallback counts agent children only, so on that arm a parent whose only child is a nested flow reports 0. That is deliberate — the fallback arm cannot enumerate a nested-flow child either, so counting one would advertise a fold that opens on nothing. It counts only children the CALLER may read: a credential holding one execution family (AGENTS:READ or FLOWS:READ alone) counts the children of that family and no others, so a count never discloses a run the same credential could not list. NULL means the arm cannot count children at all, which is not zero."},"completeness":{"$ref":"#/components/schemas/RunListRowCompleteness","description":"Storage completeness; null on a row the control-plane arm served."},"conversationId":{"type":["string","null"],"description":"Conversation this run belongs to."},"durationMs":{"type":["number","null"],"format":"double","description":"Wall-clock duration in milliseconds."},"endedAt":{"type":["string","null"],"description":"ISO instant the run ended; null while it is still running."},"executionId":{"type":"string","description":"Runtime execution id; the key for /v1/logs and /v1/runs/{id}."},"expiresAt":{"type":["string","null"],"description":"Budget expiry. Absent means the overlay did not answer, which is not false and not null."},"externalAgent":{"oneOf":[{"$ref":"#/components/schemas/RunListRowExternalAgent"},{"type":"null"}],"description":"Set when an external agent (A2A or runtype-stream) answered the turn: the protocol, declared framework and endpoint host stamped on the run header when it was invoked. Null on any other run, and on an external-agent run whose header predates the stamp. A repointed agent keeps one agentId, so this is what tells two of its runs apart."},"fidelityTier":{"type":["string","null"],"description":"Fidelity of the projection behind this row."},"flowId":{"type":["string","null"],"description":"Flow that ran."},"flowVersionId":{"type":["string","null"],"description":"Exact saved flow version or test capture that ran. Absent means the overlay did not answer, which is not false and not null."},"inlineDefinition":{"type":["boolean","null"],"description":"True when the dispatch carried a complete inline agent definition (name and model) beside or instead of an agentId, so the run executed that inline config and no stored version; such a row stamps no agentVersionId. False when the run executed the saved definition by reference. NULL when the header states nothing: a flow run, a lane that resolves no agent definition, or a row that predates the field."},"inputMessages":{"description":"Messages the run started from. Absent means the overlay did not answer, which is not false and not null."},"inputPreview":{"type":["string","null"],"description":"The run's first user message, secret-scrubbed and cut to 160 characters, so a list can say what a run was asked to do without reading content. Absent means no input text is recorded for this run, which is not an empty message: the span store holds no run-level input at all, so a run with no control-plane row (a flow leg, a storeResults:false run) has none."},"inputTokens":{"type":["number","null"],"format":"double","description":"Input tokens reported."},"iterations":{"type":["number","null"],"format":"double","description":"Loop iterations from the terminal frame."},"kind":{"$ref":"#/components/schemas/RunListRowKind","description":"Whether an agent or a flow ran."},"lastHeartbeatAt":{"type":["string","null"],"description":"Last heartbeat. Absent means the overlay did not answer, which is not false and not null."},"model":{"type":["string","null"],"description":"Model of the run's first model call (served model when reported, otherwise requested model); null when no model call recorded one."},"origin":{"$ref":"#/components/schemas/RunListRowOrigin","description":"Where the run was dispatched from, taken from the caller's authenticated principal and never from a request field. ANY entrance that resolves a principal stamps it: a Clerk session answers dashboard; a management API key answers api, which includes the Runtype MCP server's tools and Code Mode, since both reach dispatch with a management key; and Runtype's own internal caller answers internal, for example the hosted /v1/mcp proxy. A lane that resolves NO principal carries NULL BY DESIGN: schedule, webhook, messaging, A2A, an agent exposed AS an MCP surface, subagent, nested flow, a client-token product surface (an end user is none of the three origins) and an ingested OTLP run. So NULL says \"no authenticated principal at this entrance\" rather than \"unknown caller\". The one NULL that is not a statement about the lane is a row whose header predates the field or came from the backfill: it stamps nothing even for a run that did resolve a principal."},"otelProducer":{"description":"Framework identity the producer reported, for a versionless run group. Absent means the overlay did not answer, which is not false and not null."},"outputTokens":{"type":["number","null"],"format":"double","description":"Output tokens reported."},"parentExecutionId":{"type":["string","null"],"description":"Run that spawned this one."},"parentToolCallId":{"type":["string","null"],"description":"Parent's tool call that spawned this run."},"pendingApproval":{"description":"Approval awaiting a human. Absent means the overlay did not answer, which is not false and not null."},"progress":{"description":"Live progress document. Absent means the overlay did not answer, which is not false and not null."},"reasoningTokens":{"type":["number","null"],"format":"double","description":"Reasoning tokens summed over the run's model calls (a subset of outputTokens). Returned by GET /v1/runs/{executionId} only; null means no model call reported one."},"recordId":{"type":["string","null"],"description":"Record this run processed."},"requestedFlowId":{"type":["string","null"],"maxLength":128,"description":"The flow.id an inline /v1/dispatch named when the caller's organization does not own a flow with that id. Such a run executes as the \"virtual\" flow, so flowId reads \"virtual\" and this field carries the caller's id (control characters stripped, cut to 128 characters) so the caller can still recognise its runs. It is a label only: it grants nothing, is never used as a sender or resume identity, and is not a list filter; filter with flowId=virtual and match on this field. Absent when the run executed under the id it named."},"retentionElided":{"type":"boolean","description":"Retention removed the spans; the run still lists and reads as completed."},"rootExecutionId":{"type":["string","null"],"description":"Outermost run of the tree."},"selfReportedCost":{"type":["string","null"],"description":"Cost the producer reported."},"signals":{"$ref":"#/components/schemas/RunListRowSignals","description":"Trace signals. A list row carries status and fired only; GET /v1/runs/{id} adds results. Omitted entirely until the organization binds a signal set."},"source":{"$ref":"#/components/schemas/RunListRowSource","description":"hosted, or ingested for an OTLP export. An ingested run is never reported running."},"spanCount":{"type":["number","null"],"format":"double","description":"Spans the projection wrote."},"startedAt":{"type":"string","description":"ISO instant the run started."},"status":{"$ref":"#/components/schemas/RunListRowStatus","description":"Customer-facing status, derived by runStatusFrom."},"stopReason":{"type":["string","null"],"description":"Stop reason from the terminal frame."},"storeResults":{"type":["boolean","null"],"description":"The persistence posture the dispatch declared. FALSE means the run wrote no control-plane row, no journal outputs and no span content, so a surface that reports a missing transcript keys on this and never on origin. NULL means the header states nothing, which is not \"true\": a lane that takes no such flag carries no stamp, and an ingested (OTLP) run declared none. A row served from the legacy control-plane lane answers true, because that row exists only when the run stored."},"surfaceId":{"type":["string","null"],"description":"Product surface that entered this run."},"surfaceType":{"type":["string","null"],"description":"Surface family (api, chat, webhook, schedule, ...)."},"test":{"type":["boolean","null"],"description":"DEPRECATED: a derived alias of origin, kept for one release — read origin instead. True when the run came from the dashboard, i.e. origin === \"dashboard\"; NULL exactly when origin is NULL. It is never derived from storeResults, which defaults to false across the whole flow lane and which an API caller sets for its own privacy reasons: reading it as \"test\" labelled production runs as tests. A run whose header predates origin therefore reads NULL rather than claiming either answer.","deprecated":true},"totalCost":{"type":["string","null"],"description":"Metered cost as a decimal string."},"traceId":{"type":["string","null"],"description":"Trace id in the span store; null on a row the control-plane arm served."},"via":{"oneOf":[{"$ref":"#/components/schemas/RunListRowVia"},{"type":"null"}],"description":"How the run started, for a Via column. Forward-only for schedule, api key, cli, mcp and eval detail: a header written before those stamps reads null, or falls back to the coarse origin/surface facts when they alone answer it. A label is a snapshot or a lookup and never authority; mcp, cli and sdk are self-declared by the client."}},"required":["agentId","batchExecutionId","childCount","completeness","conversationId","durationMs","endedAt","executionId","fidelityTier","flowId","inlineDefinition","inputTokens","kind","origin","outputTokens","parentExecutionId","parentToolCallId","recordId","rootExecutionId","selfReportedCost","source","spanCount","startedAt","status","storeResults","surfaceId","surfaceType","test","totalCost","traceId"],"title":"RunListRow"},"V1RunsGetResponsesContentApplicationJsonSchemaPagination":{"type":"object","properties":{"cursorReset":{"type":"boolean","description":"True when the supplied cursor could not be honoured and the read restarted at page one. A paging client must stop rather than follow the fresh cursor. Absent otherwise."},"hasMore":{"type":"boolean"},"hasPrev":{"type":"boolean"},"limit":{"type":"integer"},"nextCursor":{"type":["string","null"]},"totalCount":{"type":"integer","description":"The runs the request's filters match within its window, ignoring the cursor and limit, counted up to 1000. Present only when `includeCount=true`."},"totalCountCapped":{"type":"boolean","description":"True when more than 1000 runs matched, so `totalCount` is the cap rather than the total. Present only when `includeCount=true`."}},"required":["hasMore","hasPrev","limit","nextCursor"],"title":"V1RunsGetResponsesContentApplicationJsonSchemaPagination"},"V1RunsGetResponsesContentApplicationJsonSchemaWindow":{"type":"object","properties":{"from":{"type":"string"},"to":{"type":"string"}},"required":["from","to"],"description":"The started_at window the query resolved to, after defaults.","title":"V1RunsGetResponsesContentApplicationJsonSchemaWindow"},"Runs_listRuns_Response_200":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/RunListRow"}},"pagination":{"$ref":"#/components/schemas/V1RunsGetResponsesContentApplicationJsonSchemaPagination"},"window":{"$ref":"#/components/schemas/V1RunsGetResponsesContentApplicationJsonSchemaWindow","description":"The started_at window the query resolved to, after defaults."}},"required":["data","pagination","window"],"title":"Runs_listRuns_Response_200"},"RunStoreUnavailableErrorCode":{"type":"string","enum":["RUN_STORE_UNAVAILABLE"],"description":"Stable error code. `insufficient_scope` marks an API key that lacks a scope this request needs.","title":"RunStoreUnavailableErrorCode"},"RunStoreUnavailableErrorDetailsItems":{"type":"object","properties":{"code":{"type":"string","description":"Stable Runtype validation code (e.g. MISSING_REQUIRED_FIELD, INVALID_ENUM)."},"message":{"type":"string"},"path":{"type":"string","description":"Dotted JSON path to the offending field."},"suggestion":{"type":"string","description":"Actionable hint (allowed values, accepted range, …)."}},"required":["message"],"title":"RunStoreUnavailableErrorDetailsItems"},"RunStoreUnavailableError":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/RunStoreUnavailableErrorCode","description":"Stable error code. `insufficient_scope` marks an API key that lacks a scope this request needs."},"details":{"type":"array","items":{"$ref":"#/components/schemas/RunStoreUnavailableErrorDetailsItems"}},"error":{"type":"string"},"requiredScopes":{"type":"array","items":{"type":"string"},"description":"On `insufficient_scope`: every API key scope this request needs."}},"required":["code","error"],"title":"RunStoreUnavailableError"},"V1RunsStatsGetParametersAgentId":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Filter by agent id; repeat for a set.","title":"V1RunsStatsGetParametersAgentId"},"V1RunsStatsGetParametersFlowId":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Filter by flow id; repeat for a set.","title":"V1RunsStatsGetParametersFlowId"},"V1RunsStatsGetParametersConversationId":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Filter by conversation id; repeat for a set (at most 100 per request).","title":"V1RunsStatsGetParametersConversationId"},"V1RunsStatsGetParametersBatchExecutionId":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Filter by batch id; repeat for a set.","title":"V1RunsStatsGetParametersBatchExecutionId"},"V1RunsStatsGetParametersIncludeChildren":{"type":"string","enum":["true","false"],"description":"true restores the flat enumeration on the UNSCOPED feed, in which a subagent run and a nested-flow run list beside their parent. The unscoped feed is roots only by default: a row whose parentExecutionId is set folds under its parent and is read with parentExecutionId=<executionId>. Any filter that scopes to a resource — agentId, flowId, conversationId, surfaceId, recordId, batchExecutionId, parentExecutionId, rootExecutionId or executionId — is already an explicit selection and never folds, so an agent that only ever runs as a subagent still lists under agentId. This parameter changes nothing on a scoped request.","title":"V1RunsStatsGetParametersIncludeChildren"},"V1RunsStatsGetParametersSource":{"type":"string","enum":["hosted","ingested"],"description":"Filter by producing lane.","title":"V1RunsStatsGetParametersSource"},"V1RunsStatsGetParametersStatus":{"type":"string","enum":["running","completed","failed"],"description":"status accepts only running, completed or failed. queued, awaiting and cancelled exist only in the live overlay, which may never change which rows a page holds, so the server cannot filter on them.","title":"V1RunsStatsGetParametersStatus"},"V1RunsStatsGetParametersTraffic":{"type":"string","enum":["live","test","eval","sim","all"],"description":"live keeps runs real users and integrations started; test keeps runs started from the dashboard (Test, step tests, Ask); eval keeps eval-batch runs; sim keeps simulation turns; all, or omitted, keeps every run. A simulation turn is sim even when a schedule started it, a schedule run is live, and an eval batch run is eval whoever started it.","title":"V1RunsStatsGetParametersTraffic"},"RunStatsByAgentIdCost":{"type":"object","properties":{"known":{"type":"number","format":"double","description":"Sum of total cost over runs whose cost is known. Never includes an unknown cost as 0."},"pricedRuns":{"type":"integer","description":"Settled runs with a known cost."},"unpricedRuns":{"type":"integer","description":"Settled runs with no known cost, usually a model or tool with no price set. When this is above 0, `known` is a lower bound."}},"required":["known","pricedRuns","unpricedRuns"],"title":"RunStatsByAgentIdCost"},"RunStatsByAgentId":{"type":"object","properties":{"cost":{"$ref":"#/components/schemas/RunStatsByAgentIdCost"},"failed":{"type":"integer","description":"Runs that read as failed in `/v1/runs` (the same predicate as `status=failed`)."},"lastStartedAt":{"type":["string","null"],"description":"Start of the newest run in the bucket (ISO 8601)."},"p50DurationMs":{"type":["number","null"],"format":"double","description":"Median duration of settled runs, or null when none settled."},"p95DurationMs":{"type":["number","null"],"format":"double","description":"95th percentile duration of settled runs, or null when none settled."},"running":{"type":"integer","description":"Runs still running."},"total":{"type":"integer","description":"Runs in the bucket."}},"required":["cost","failed","lastStartedAt","p50DurationMs","p95DurationMs","running","total"],"title":"RunStatsByAgentId"},"RunStatsByAgentSurfaceCost":{"type":"object","properties":{"known":{"type":"number","format":"double","description":"Sum of total cost over runs whose cost is known. Never includes an unknown cost as 0."},"pricedRuns":{"type":"integer","description":"Settled runs with a known cost."},"unpricedRuns":{"type":"integer","description":"Settled runs with no known cost, usually a model or tool with no price set. When this is above 0, `known` is a lower bound."}},"required":["known","pricedRuns","unpricedRuns"],"title":"RunStatsByAgentSurfaceCost"},"RunStatsByAgentSurface":{"type":"object","properties":{"cost":{"$ref":"#/components/schemas/RunStatsByAgentSurfaceCost"},"failed":{"type":"integer","description":"Runs that read as failed in `/v1/runs` (the same predicate as `status=failed`)."},"lastStartedAt":{"type":["string","null"],"description":"Start of the newest run in the bucket (ISO 8601)."},"p50DurationMs":{"type":["number","null"],"format":"double","description":"Median duration of settled runs, or null when none settled."},"p95DurationMs":{"type":["number","null"],"format":"double","description":"95th percentile duration of settled runs, or null when none settled."},"running":{"type":"integer","description":"Runs still running."},"total":{"type":"integer","description":"Runs in the bucket."}},"required":["cost","failed","lastStartedAt","p50DurationMs","p95DurationMs","running","total"],"title":"RunStatsByAgentSurface"},"RunStatsByFlowIdCost":{"type":"object","properties":{"known":{"type":"number","format":"double","description":"Sum of total cost over runs whose cost is known. Never includes an unknown cost as 0."},"pricedRuns":{"type":"integer","description":"Settled runs with a known cost."},"unpricedRuns":{"type":"integer","description":"Settled runs with no known cost, usually a model or tool with no price set. When this is above 0, `known` is a lower bound."}},"required":["known","pricedRuns","unpricedRuns"],"title":"RunStatsByFlowIdCost"},"RunStatsByFlowId":{"type":"object","properties":{"cost":{"$ref":"#/components/schemas/RunStatsByFlowIdCost"},"failed":{"type":"integer","description":"Runs that read as failed in `/v1/runs` (the same predicate as `status=failed`)."},"lastStartedAt":{"type":["string","null"],"description":"Start of the newest run in the bucket (ISO 8601)."},"p50DurationMs":{"type":["number","null"],"format":"double","description":"Median duration of settled runs, or null when none settled."},"p95DurationMs":{"type":["number","null"],"format":"double","description":"95th percentile duration of settled runs, or null when none settled."},"running":{"type":"integer","description":"Runs still running."},"total":{"type":"integer","description":"Runs in the bucket."}},"required":["cost","failed","lastStartedAt","p50DurationMs","p95DurationMs","running","total"],"title":"RunStatsByFlowId"},"RunStatsByFlowSurfaceCost":{"type":"object","properties":{"known":{"type":"number","format":"double","description":"Sum of total cost over runs whose cost is known. Never includes an unknown cost as 0."},"pricedRuns":{"type":"integer","description":"Settled runs with a known cost."},"unpricedRuns":{"type":"integer","description":"Settled runs with no known cost, usually a model or tool with no price set. When this is above 0, `known` is a lower bound."}},"required":["known","pricedRuns","unpricedRuns"],"title":"RunStatsByFlowSurfaceCost"},"RunStatsByFlowSurface":{"type":"object","properties":{"cost":{"$ref":"#/components/schemas/RunStatsByFlowSurfaceCost"},"failed":{"type":"integer","description":"Runs that read as failed in `/v1/runs` (the same predicate as `status=failed`)."},"lastStartedAt":{"type":["string","null"],"description":"Start of the newest run in the bucket (ISO 8601)."},"p50DurationMs":{"type":["number","null"],"format":"double","description":"Median duration of settled runs, or null when none settled."},"p95DurationMs":{"type":["number","null"],"format":"double","description":"95th percentile duration of settled runs, or null when none settled."},"running":{"type":"integer","description":"Runs still running."},"total":{"type":"integer","description":"Runs in the bucket."}},"required":["cost","failed","lastStartedAt","p50DurationMs","p95DurationMs","running","total"],"title":"RunStatsByFlowSurface"},"RunStatsBySurfaceIdCost":{"type":"object","properties":{"known":{"type":"number","format":"double","description":"Sum of total cost over runs whose cost is known. Never includes an unknown cost as 0."},"pricedRuns":{"type":"integer","description":"Settled runs with a known cost."},"unpricedRuns":{"type":"integer","description":"Settled runs with no known cost, usually a model or tool with no price set. When this is above 0, `known` is a lower bound."}},"required":["known","pricedRuns","unpricedRuns"],"title":"RunStatsBySurfaceIdCost"},"RunStatsBySurfaceId":{"type":"object","properties":{"cost":{"$ref":"#/components/schemas/RunStatsBySurfaceIdCost"},"failed":{"type":"integer","description":"Runs that read as failed in `/v1/runs` (the same predicate as `status=failed`)."},"lastStartedAt":{"type":["string","null"],"description":"Start of the newest run in the bucket (ISO 8601)."},"p50DurationMs":{"type":["number","null"],"format":"double","description":"Median duration of settled runs, or null when none settled."},"p95DurationMs":{"type":["number","null"],"format":"double","description":"95th percentile duration of settled runs, or null when none settled."},"running":{"type":"integer","description":"Runs still running."},"total":{"type":"integer","description":"Runs in the bucket."}},"required":["cost","failed","lastStartedAt","p50DurationMs","p95DurationMs","running","total"],"title":"RunStatsBySurfaceId"},"RunStatsByTrafficEval":{"type":"object","properties":{"failed":{"type":"integer","description":"Failed runs of this traffic kind in the window."},"total":{"type":"integer","description":"Runs of this traffic kind in the window."}},"required":["failed","total"],"title":"RunStatsByTrafficEval"},"RunStatsByTrafficLive":{"type":"object","properties":{"failed":{"type":"integer","description":"Failed runs of this traffic kind in the window."},"total":{"type":"integer","description":"Runs of this traffic kind in the window."}},"required":["failed","total"],"title":"RunStatsByTrafficLive"},"RunStatsByTrafficSim":{"type":"object","properties":{"failed":{"type":"integer","description":"Failed runs of this traffic kind in the window."},"total":{"type":"integer","description":"Runs of this traffic kind in the window."}},"required":["failed","total"],"title":"RunStatsByTrafficSim"},"RunStatsByTrafficTest":{"type":"object","properties":{"failed":{"type":"integer","description":"Failed runs of this traffic kind in the window."},"total":{"type":"integer","description":"Runs of this traffic kind in the window."}},"required":["failed","total"],"title":"RunStatsByTrafficTest"},"RunStatsByTraffic":{"type":"object","properties":{"eval":{"$ref":"#/components/schemas/RunStatsByTrafficEval"},"live":{"$ref":"#/components/schemas/RunStatsByTrafficLive"},"sim":{"$ref":"#/components/schemas/RunStatsByTrafficSim"},"test":{"$ref":"#/components/schemas/RunStatsByTrafficTest"}},"required":["eval","live","sim","test"],"description":"The same runs before the `traffic` filter, split by kind, so a live view can say \"plus 4 test runs\".","title":"RunStatsByTraffic"},"RunStatsTotalsCost":{"type":"object","properties":{"known":{"type":"number","format":"double","description":"Sum of total cost over runs whose cost is known. Never includes an unknown cost as 0."},"pricedRuns":{"type":"integer","description":"Settled runs with a known cost."},"unpricedRuns":{"type":"integer","description":"Settled runs with no known cost, usually a model or tool with no price set. When this is above 0, `known` is a lower bound."}},"required":["known","pricedRuns","unpricedRuns"],"title":"RunStatsTotalsCost"},"RunStatsTotals":{"type":"object","properties":{"cost":{"$ref":"#/components/schemas/RunStatsTotalsCost"},"failed":{"type":"integer","description":"Runs that read as failed in `/v1/runs` (the same predicate as `status=failed`)."},"lastStartedAt":{"type":["string","null"],"description":"Start of the newest run in the bucket (ISO 8601)."},"p50DurationMs":{"type":["number","null"],"format":"double","description":"Median duration of settled runs, or null when none settled."},"p95DurationMs":{"type":["number","null"],"format":"double","description":"95th percentile duration of settled runs, or null when none settled."},"running":{"type":"integer","description":"Runs still running."},"total":{"type":"integer","description":"Runs in the bucket."}},"required":["cost","failed","lastStartedAt","p50DurationMs","p95DurationMs","running","total"],"description":"Every run the filters match, `traffic` included.","title":"RunStatsTotals"},"RunStats":{"type":"object","properties":{"byAgentId":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/RunStatsByAgentId"},"description":"Runs grouped by agent id."},"byAgentSurface":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/RunStatsByAgentSurface"},"description":"Runs grouped by agent and surface, keyed `<agentId>:<surfaceId>`."},"byFlowId":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/RunStatsByFlowId"},"description":"Runs grouped by flow id."},"byFlowSurface":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/RunStatsByFlowSurface"},"description":"Runs grouped by flow and surface, keyed `<flowId>:<surfaceId>`."},"bySurfaceId":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/RunStatsBySurfaceId"},"description":"Runs grouped by surface id."},"byTraffic":{"$ref":"#/components/schemas/RunStatsByTraffic","description":"The same runs before the `traffic` filter, split by kind, so a live view can say \"plus 4 test runs\"."},"totals":{"$ref":"#/components/schemas/RunStatsTotals","description":"Every run the filters match, `traffic` included."}},"required":["byAgentId","byAgentSurface","byFlowId","byFlowSurface","bySurfaceId","byTraffic","totals"],"title":"RunStats"},"V1RunsStatsGetResponsesContentApplicationJsonSchemaWindow":{"type":"object","properties":{"from":{"type":"string"},"to":{"type":"string"}},"required":["from","to"],"description":"The started_at window the query resolved to, after defaults.","title":"V1RunsStatsGetResponsesContentApplicationJsonSchemaWindow"},"Runs_countRuns_Response_200":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/RunStats"},"window":{"$ref":"#/components/schemas/V1RunsStatsGetResponsesContentApplicationJsonSchemaWindow","description":"The started_at window the query resolved to, after defaults."}},"required":["data","window"],"title":"Runs_countRuns_Response_200"},"V1RunsStatsProductsGetParametersTraffic":{"type":"string","enum":["live","test","eval","sim","all"],"description":"live keeps runs real users and integrations started; test keeps runs started from the dashboard (Test, step tests, Ask); eval keeps eval-batch runs; sim keeps simulation turns; all, or omitted, keeps every run. A simulation turn is sim even when a schedule started it, a schedule run is live, and an eval batch run is eval whoever started it.","title":"V1RunsStatsProductsGetParametersTraffic"},"RunProductStatsByProductId":{"type":"object","properties":{"failed":{"type":"integer","description":"Of those, the runs that read as failed in `/v1/runs` (the same predicate as `status=failed`)."},"total":{"type":"integer","description":"Runs of the product's flows plus runs of its agents."}},"required":["failed","total"],"title":"RunProductStatsByProductId"},"RunProductStats":{"type":"object","properties":{"byProductId":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/RunProductStatsByProductId"},"description":"One entry per named product the caller owns, a product with no flow or agent reading zero. Each sums `/v1/runs/stats` for its flows and for its agents, read one family at a time."}},"required":["byProductId"],"title":"RunProductStats"},"V1RunsStatsProductsGetResponsesContentApplicationJsonSchemaWindow":{"type":"object","properties":{"from":{"type":"string"},"to":{"type":"string"}},"required":["from","to"],"description":"The started_at window the query resolved to, after defaults.","title":"V1RunsStatsProductsGetResponsesContentApplicationJsonSchemaWindow"},"Runs_countRunsPerProduct_Response_200":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/RunProductStats"},"window":{"$ref":"#/components/schemas/V1RunsStatsProductsGetResponsesContentApplicationJsonSchemaWindow","description":"The started_at window the query resolved to, after defaults."}},"required":["data","window"],"title":"Runs_countRunsPerProduct_Response_200"},"V1RunsExecutionIdGetParametersOverlay":{"type":"string","enum":["live","none"],"description":"live adds control-plane fields; defaults to live for a session, none for an API key.","title":"V1RunsExecutionIdGetParametersOverlay"},"V1RunsExecutionIdGetParametersView":{"type":"string","enum":["compact","full"],"description":"full (the default) returns every field. compact omits exactly these 17: model, stopReason, iterations, inputPreview, flowVersionId, agentVersionId, agentVersionLabel, agentVersionNumber, agentTargetResolution, otelProducer, lastHeartbeatAt, expiresAt, cancelRequestedAt, progress, pendingApproval, budgetExhausted and inputMessages. The status is still overlay-corrected on a compact page; only the fields differ.","title":"V1RunsExecutionIdGetParametersView"},"Runs_readOneRun_Response_200":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/RunListRow"}},"required":["data"],"title":"Runs_readOneRun_Response_200"},"V1RuntimeCrawlPostRequestBodyContentApplicationJsonSchemaLimits":{"type":"object","properties":{"completionTimeoutMs":{"type":"number","format":"double","description":"Overall completion timeout for the crawl job (default 120000, floored at pollIntervalMs)."},"depth":{"type":"number","format":"double","description":"Crawl depth from the seed URL (min-1 normalized server-side)."},"maxPages":{"type":"number","format":"double","description":"Maximum number of pages to crawl (min-1 normalized server-side)."},"pollIntervalMs":{"type":"number","format":"double","description":"Poll interval for the server-side completion loop (default 2000, floor 1)."}},"title":"V1RuntimeCrawlPostRequestBodyContentApplicationJsonSchemaLimits"},"V1RuntimeCrawlPostRequestBodyContentApplicationJsonSchemaOptionsAuthenticate":{"type":"object","properties":{"password":{"type":"string"},"username":{"type":"string"}},"title":"V1RuntimeCrawlPostRequestBodyContentApplicationJsonSchemaOptionsAuthenticate"},"V1RuntimeCrawlPostRequestBodyContentApplicationJsonSchemaOptionsJsonOptions":{"type":"object","properties":{"prompt":{"type":"string"},"schema":{"type":"object","additionalProperties":{"description":"Any type"}}},"title":"V1RuntimeCrawlPostRequestBodyContentApplicationJsonSchemaOptionsJsonOptions"},"V1RuntimeCrawlPostRequestBodyContentApplicationJsonSchemaOptionsOptions":{"type":"object","properties":{"allowExternalLinks":{"type":"boolean"},"allowSubdomains":{"type":"boolean"},"excludePatterns":{"type":"array","items":{"type":"string"}},"ignoreSitemap":{"type":"boolean"},"includePatterns":{"type":"array","items":{"type":"string"}},"sitemapOnly":{"type":"boolean"}},"title":"V1RuntimeCrawlPostRequestBodyContentApplicationJsonSchemaOptionsOptions"},"V1RuntimeCrawlPostRequestBodyContentApplicationJsonSchemaOptionsRejectRequestPattern":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"title":"V1RuntimeCrawlPostRequestBodyContentApplicationJsonSchemaOptionsRejectRequestPattern"},"V1RuntimeCrawlPostRequestBodyContentApplicationJsonSchemaOptions":{"type":"object","properties":{"authenticate":{"$ref":"#/components/schemas/V1RuntimeCrawlPostRequestBodyContentApplicationJsonSchemaOptionsAuthenticate"},"cookies":{"type":"array","items":{"type":"object","additionalProperties":{"description":"Any type"}}},"formats":{"type":"array","items":{"type":"string"}},"gotoOptions":{"type":"object","additionalProperties":{"description":"Any type"}},"jsonOptions":{"$ref":"#/components/schemas/V1RuntimeCrawlPostRequestBodyContentApplicationJsonSchemaOptionsJsonOptions"},"maxAge":{"type":"integer","minimum":0},"modifiedSince":{"type":"string"},"options":{"$ref":"#/components/schemas/V1RuntimeCrawlPostRequestBodyContentApplicationJsonSchemaOptionsOptions"},"rejectRequestPattern":{"$ref":"#/components/schemas/V1RuntimeCrawlPostRequestBodyContentApplicationJsonSchemaOptionsRejectRequestPattern"},"rejectResourceTypes":{"type":"array","items":{"type":"string"}},"render":{"type":"boolean"},"setExtraHTTPHeaders":{"type":"object","additionalProperties":{"type":"string"}},"source":{"type":"string"},"userAgent":{"type":"string"},"waitForSelector":{"type":"string"}},"title":"V1RuntimeCrawlPostRequestBodyContentApplicationJsonSchemaOptions"},"V1RuntimeCrawlPostResponsesContentApplicationJsonSchemaMetadataCredentialSource":{"type":"string","enum":["user","platform"],"title":"V1RuntimeCrawlPostResponsesContentApplicationJsonSchemaMetadataCredentialSource"},"V1RuntimeCrawlPostResponsesContentApplicationJsonSchemaMetadata":{"type":"object","properties":{"crawlId":{"type":"string"},"credentialSource":{"$ref":"#/components/schemas/V1RuntimeCrawlPostResponsesContentApplicationJsonSchemaMetadataCredentialSource"},"pagesFetched":{"type":"number","format":"double"},"resultPagesTruncated":{"type":"boolean"},"status":{"type":"string"}},"required":["crawlId","credentialSource","pagesFetched","resultPagesTruncated","status"],"description":"Implementation metadata folded into the runtime step’s result metadata.","title":"V1RuntimeCrawlPostResponsesContentApplicationJsonSchemaMetadata"},"V1RuntimeCrawlPostResponsesContentApplicationJsonSchemaPagesItems":{"type":"object","properties":{"browserSecondsUsed":{"type":"number","format":"double","description":"Browser rendering seconds consumed."},"cursor":{"type":"string","description":"Cursor for the next result page (absent on last)."},"finished":{"type":"number","format":"double","description":"Number of pages that finished crawling."},"records":{"type":"array","items":{"type":"object","additionalProperties":{"description":"Any type"}},"description":"Crawled page records in this result page."},"status":{"type":"string","description":"Status of the crawl job at the time this page was fetched."},"total":{"type":"number","format":"double","description":"Total pages discovered by the crawl."}},"required":["status"],"title":"V1RuntimeCrawlPostResponsesContentApplicationJsonSchemaPagesItems"},"Self-hosting_executeASynchronousSiteCrawl_Response_200":{"type":"object","properties":{"metadata":{"$ref":"#/components/schemas/V1RuntimeCrawlPostResponsesContentApplicationJsonSchemaMetadata","description":"Implementation metadata folded into the runtime step’s result metadata."},"pages":{"type":"array","items":{"$ref":"#/components/schemas/V1RuntimeCrawlPostResponsesContentApplicationJsonSchemaPagesItems"},"description":"All collected result pages; the first entry is the terminal status page (the crawl step output’s `result` field)."}},"required":["metadata","pages"],"title":"Self-hosting_executeASynchronousSiteCrawl_Response_200"},"V1RuntimeCrawlPostResponsesContentApplicationJsonSchemaCode":{"type":"string","enum":["CREDENTIALS_MISSING","CRAWL_FAILED","CRAWL_TIMEOUT","CRAWL_PENDING_UNSUPPORTED"],"description":"Stable machine-readable failure code.","title":"V1RuntimeCrawlPostResponsesContentApplicationJsonSchemaCode"},"ExecuteASynchronousSiteCrawlRequestBadRequestError":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/V1RuntimeCrawlPostResponsesContentApplicationJsonSchemaCode","description":"Stable machine-readable failure code."},"error":{"type":"string","description":"Human-readable failure message."}},"required":["code","error"],"title":"ExecuteASynchronousSiteCrawlRequestBadRequestError"},"ExecuteASynchronousSiteCrawlRequestNotImplementedError":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/V1RuntimeCrawlPostResponsesContentApplicationJsonSchemaCode","description":"Stable machine-readable failure code."},"error":{"type":"string","description":"Human-readable failure message."}},"required":["code","error"],"title":"ExecuteASynchronousSiteCrawlRequestNotImplementedError"},"ExecuteASynchronousSiteCrawlRequestBadGatewayError":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/V1RuntimeCrawlPostResponsesContentApplicationJsonSchemaCode","description":"Stable machine-readable failure code."},"error":{"type":"string","description":"Human-readable failure message."}},"required":["code","error"],"title":"ExecuteASynchronousSiteCrawlRequestBadGatewayError"},"ExecuteASynchronousSiteCrawlRequestGatewayTimeoutError":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/V1RuntimeCrawlPostResponsesContentApplicationJsonSchemaCode","description":"Stable machine-readable failure code."},"error":{"type":"string","description":"Human-readable failure message."}},"required":["code","error"],"title":"ExecuteASynchronousSiteCrawlRequestGatewayTimeoutError"},"V1RuntimeEmailSendPostRequestBodyContentApplicationJsonSchemaAttachmentsItems":{"type":"object","properties":{"content":{"type":"string","minLength":1},"contentType":{"type":"string"},"filename":{"type":"string","minLength":1}},"required":["content","filename"],"title":"V1RuntimeEmailSendPostRequestBodyContentApplicationJsonSchemaAttachmentsItems"},"Self-hosting_sendARenderedEmailFromAStandaloneRuntime_Response_200":{"type":"object","properties":{"from":{"type":"string"},"id":{"type":"string"},"to":{"type":"array","items":{"type":"string"}}},"required":["from","id","to"],"title":"Self-hosting_sendARenderedEmailFromAStandaloneRuntime_Response_200"},"V1RuntimeEmailSendPostResponsesContentApplicationJsonSchemaCode":{"type":"string","enum":["managed_domain_custom_sender","platform_credit_exhausted","platform_email_unconfigured","custom_sender_key_missing","provider_error"],"title":"V1RuntimeEmailSendPostResponsesContentApplicationJsonSchemaCode"},"SendARenderedEmailFromAStandaloneRuntimeRequestBadRequestError":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/V1RuntimeEmailSendPostResponsesContentApplicationJsonSchemaCode"},"error":{"type":"string"}},"required":["error"],"title":"SendARenderedEmailFromAStandaloneRuntimeRequestBadRequestError"},"SendARenderedEmailFromAStandaloneRuntimeRequestUnauthorizedError":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/V1RuntimeEmailSendPostResponsesContentApplicationJsonSchemaCode"},"error":{"type":"string"}},"required":["error"],"title":"SendARenderedEmailFromAStandaloneRuntimeRequestUnauthorizedError"},"RuntimeEmailAdmissionError":{"type":"object","properties":{"code":{"type":"string"},"error":{"type":"string"},"message":{"type":"string"}},"required":["error"],"title":"RuntimeEmailAdmissionError"},"SendARenderedEmailFromAStandaloneRuntimeRequestInternalServerError":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/V1RuntimeEmailSendPostResponsesContentApplicationJsonSchemaCode"},"error":{"type":"string"}},"required":["error"],"title":"SendARenderedEmailFromAStandaloneRuntimeRequestInternalServerError"},"SendARenderedEmailFromAStandaloneRuntimeRequestBadGatewayError":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/V1RuntimeEmailSendPostResponsesContentApplicationJsonSchemaCode"},"error":{"type":"string"}},"required":["error"],"title":"SendARenderedEmailFromAStandaloneRuntimeRequestBadGatewayError"},"SendARenderedEmailFromAStandaloneRuntimeRequestServiceUnavailableError":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/V1RuntimeEmailSendPostResponsesContentApplicationJsonSchemaCode"},"error":{"type":"string"}},"required":["error"],"title":"SendARenderedEmailFromAStandaloneRuntimeRequestServiceUnavailableError"},"V1RuntimeMemoryRecallPostRequestBodyContentApplicationJsonSchemaOptionsResponseLength":{"type":"string","enum":["short","medium","long"],"title":"V1RuntimeMemoryRecallPostRequestBodyContentApplicationJsonSchemaOptionsResponseLength"},"V1RuntimeMemoryRecallPostRequestBodyContentApplicationJsonSchemaOptionsThinkingLevel":{"type":"string","enum":["low","medium","high"],"title":"V1RuntimeMemoryRecallPostRequestBodyContentApplicationJsonSchemaOptionsThinkingLevel"},"V1RuntimeMemoryRecallPostRequestBodyContentApplicationJsonSchemaOptions":{"type":"object","properties":{"referenceDate":{"type":"string"},"responseLength":{"$ref":"#/components/schemas/V1RuntimeMemoryRecallPostRequestBodyContentApplicationJsonSchemaOptionsResponseLength"},"thinkingLevel":{"$ref":"#/components/schemas/V1RuntimeMemoryRecallPostRequestBodyContentApplicationJsonSchemaOptionsThinkingLevel"}},"title":"V1RuntimeMemoryRecallPostRequestBodyContentApplicationJsonSchemaOptions"},"V1RuntimeMemoryRecallPostResponsesContentApplicationJsonSchemaCandidatesItems":{"type":"object","properties":{"id":{"type":"string"},"score":{"type":"number","format":"double"},"sessionId":{"type":["string","null"]},"summary":{"type":"string"}},"required":["id","score","sessionId","summary"],"title":"V1RuntimeMemoryRecallPostResponsesContentApplicationJsonSchemaCandidatesItems"},"Self-hosting_recallMemoriesHostedMemoryStoreRecall_Response_200":{"type":"object","properties":{"answer":{"type":"string"},"candidates":{"type":"array","items":{"$ref":"#/components/schemas/V1RuntimeMemoryRecallPostResponsesContentApplicationJsonSchemaCandidatesItems"}},"count":{"type":"number","format":"double"}},"required":["answer","candidates","count"],"title":"Self-hosting_recallMemoriesHostedMemoryStoreRecall_Response_200"},"V1RuntimeMemoryRecallPostResponsesContentApplicationJsonSchemaCode":{"type":"string","enum":["memory_not_available","memory_not_configured","memory_failed"],"title":"V1RuntimeMemoryRecallPostResponsesContentApplicationJsonSchemaCode"},"RecallMemoriesHostedMemoryStoreRecallRequestBadRequestError":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/V1RuntimeMemoryRecallPostResponsesContentApplicationJsonSchemaCode"},"error":{"type":"string"}},"required":["code","error"],"title":"RecallMemoriesHostedMemoryStoreRecallRequestBadRequestError"},"RecallMemoriesHostedMemoryStoreRecallRequestInternalServerError":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/V1RuntimeMemoryRecallPostResponsesContentApplicationJsonSchemaCode"},"error":{"type":"string"}},"required":["code","error"],"title":"RecallMemoriesHostedMemoryStoreRecallRequestInternalServerError"},"RecallMemoriesHostedMemoryStoreRecallRequestServiceUnavailableError":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/V1RuntimeMemoryRecallPostResponsesContentApplicationJsonSchemaCode"},"error":{"type":"string"}},"required":["code","error"],"title":"RecallMemoriesHostedMemoryStoreRecallRequestServiceUnavailableError"},"V1RuntimeMemorySavePostRequestBodyContentApplicationJsonSchemaMemory":{"type":"object","properties":{"content":{"type":"string"},"sessionId":{"type":["string","null"]}},"required":["content"],"title":"V1RuntimeMemorySavePostRequestBodyContentApplicationJsonSchemaMemory"},"V1RuntimeMemorySavePostResponsesContentApplicationJsonSchemaType":{"type":"string","enum":["fact","event","instruction","task"],"title":"V1RuntimeMemorySavePostResponsesContentApplicationJsonSchemaType"},"Self-hosting_saveAMemoryHostedMemoryStoreRemember_Response_200":{"type":"object","properties":{"content":{"type":"string"},"createdAt":{"type":"string"},"id":{"type":"string"},"sessionId":{"type":["string","null"]},"summary":{"type":"string"},"type":{"$ref":"#/components/schemas/V1RuntimeMemorySavePostResponsesContentApplicationJsonSchemaType"},"updatedAt":{"type":"string"}},"required":["content","createdAt","id","sessionId","summary","type","updatedAt"],"title":"Self-hosting_saveAMemoryHostedMemoryStoreRemember_Response_200"},"V1RuntimeMemorySavePostResponsesContentApplicationJsonSchemaCode":{"type":"string","enum":["memory_not_available","memory_not_configured","memory_failed"],"title":"V1RuntimeMemorySavePostResponsesContentApplicationJsonSchemaCode"},"SaveAMemoryHostedMemoryStoreRememberRequestBadRequestError":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/V1RuntimeMemorySavePostResponsesContentApplicationJsonSchemaCode"},"error":{"type":"string"}},"required":["code","error"],"title":"SaveAMemoryHostedMemoryStoreRememberRequestBadRequestError"},"SaveAMemoryHostedMemoryStoreRememberRequestInternalServerError":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/V1RuntimeMemorySavePostResponsesContentApplicationJsonSchemaCode"},"error":{"type":"string"}},"required":["code","error"],"title":"SaveAMemoryHostedMemoryStoreRememberRequestInternalServerError"},"SaveAMemoryHostedMemoryStoreRememberRequestServiceUnavailableError":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/V1RuntimeMemorySavePostResponsesContentApplicationJsonSchemaCode"},"error":{"type":"string"}},"required":["code","error"],"title":"SaveAMemoryHostedMemoryStoreRememberRequestServiceUnavailableError"},"V1RuntimeMemorySummaryPostRequestBodyContentApplicationJsonSchemaOptions":{"type":"object","properties":{"sessionId":{"type":["string","null"]}},"title":"V1RuntimeMemorySummaryPostRequestBodyContentApplicationJsonSchemaOptions"},"Self-hosting_summarizeAMemoryProfileHostedMemoryStoreGetSummary_Response_200":{"type":"object","properties":{"summary":{"type":"string"}},"required":["summary"],"title":"Self-hosting_summarizeAMemoryProfileHostedMemoryStoreGetSummary_Response_200"},"V1RuntimeMemorySummaryPostResponsesContentApplicationJsonSchemaCode":{"type":"string","enum":["memory_not_available","memory_not_configured","memory_failed"],"title":"V1RuntimeMemorySummaryPostResponsesContentApplicationJsonSchemaCode"},"SummarizeAMemoryProfileHostedMemoryStoreGetSummaryRequestBadRequestError":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/V1RuntimeMemorySummaryPostResponsesContentApplicationJsonSchemaCode"},"error":{"type":"string"}},"required":["code","error"],"title":"SummarizeAMemoryProfileHostedMemoryStoreGetSummaryRequestBadRequestError"},"SummarizeAMemoryProfileHostedMemoryStoreGetSummaryRequestInternalServerError":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/V1RuntimeMemorySummaryPostResponsesContentApplicationJsonSchemaCode"},"error":{"type":"string"}},"required":["code","error"],"title":"SummarizeAMemoryProfileHostedMemoryStoreGetSummaryRequestInternalServerError"},"SummarizeAMemoryProfileHostedMemoryStoreGetSummaryRequestServiceUnavailableError":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/V1RuntimeMemorySummaryPostResponsesContentApplicationJsonSchemaCode"},"error":{"type":"string"}},"required":["code","error"],"title":"SummarizeAMemoryProfileHostedMemoryStoreGetSummaryRequestServiceUnavailableError"},"SelfHostingGetARecordByIdOrTypeNameHostedRecordStoreGetRequest0":{"type":"object","properties":{"id":{"type":"string","minLength":1}},"required":["id"],"title":"SelfHostingGetARecordByIdOrTypeNameHostedRecordStoreGetRequest0"},"SelfHostingGetARecordByIdOrTypeNameHostedRecordStoreGetRequest1":{"type":"object","properties":{"name":{"type":"string","minLength":1},"type":{"type":"string","minLength":1}},"required":["name","type"],"title":"SelfHostingGetARecordByIdOrTypeNameHostedRecordStoreGetRequest1"},"Self-hosting_getARecordByIdOrTypeNameHostedRecordStoreGet_Request":{"oneOf":[{"$ref":"#/components/schemas/SelfHostingGetARecordByIdOrTypeNameHostedRecordStoreGetRequest0"},{"$ref":"#/components/schemas/SelfHostingGetARecordByIdOrTypeNameHostedRecordStoreGetRequest1"}],"title":"Self-hosting_getARecordByIdOrTypeNameHostedRecordStoreGet_Request"},"V1RuntimeRecordsGetPostResponsesContentApplicationJsonSchemaRecordMessagesItems":{"type":"object","properties":{"content":{"type":"string"},"role":{"type":"string"}},"required":["content","role"],"title":"V1RuntimeRecordsGetPostResponsesContentApplicationJsonSchemaRecordMessagesItems"},"V1RuntimeRecordsGetPostResponsesContentApplicationJsonSchemaRecord":{"type":"object","properties":{"createdAt":{"type":"string"},"id":{"type":"string"},"messages":{"type":["array","null"],"items":{"$ref":"#/components/schemas/V1RuntimeRecordsGetPostResponsesContentApplicationJsonSchemaRecordMessagesItems"}},"metadata":{"type":"object","additionalProperties":{"description":"Any type"}},"metadataLabels":{"type":["object","null"],"additionalProperties":{"type":"string"}},"metadataSchema":{"type":["object","null"],"additionalProperties":{"description":"Any type"}},"name":{"type":"string"},"organizationId":{"type":["string","null"]},"ownerId":{"type":["string","null"]},"productSurfaceId":{"type":["string","null"]},"schemaValid":{"type":["boolean","null"]},"type":{"type":"string"},"updatedAt":{"type":"string"},"userId":{"type":"string"}},"required":["createdAt","id","metadata","name","organizationId","type","updatedAt","userId"],"title":"V1RuntimeRecordsGetPostResponsesContentApplicationJsonSchemaRecord"},"Self-hosting_getARecordByIdOrTypeNameHostedRecordStoreGet_Response_200":{"type":"object","properties":{"record":{"oneOf":[{"$ref":"#/components/schemas/V1RuntimeRecordsGetPostResponsesContentApplicationJsonSchemaRecord"},{"type":"null"}]}},"required":["record"],"title":"Self-hosting_getARecordByIdOrTypeNameHostedRecordStoreGet_Response_200"},"V1RuntimeRecordsGetPostResponsesContentApplicationJsonSchemaCode":{"type":"string","enum":["invalid_request","record_write_failed","record_read_failed"],"title":"V1RuntimeRecordsGetPostResponsesContentApplicationJsonSchemaCode"},"GetARecordByIdOrTypeNameHostedRecordStoreGetRequestBadRequestError":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/V1RuntimeRecordsGetPostResponsesContentApplicationJsonSchemaCode"},"error":{"type":"string"}},"required":["code","error"],"title":"GetARecordByIdOrTypeNameHostedRecordStoreGetRequestBadRequestError"},"GetARecordByIdOrTypeNameHostedRecordStoreGetRequestInternalServerError":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/V1RuntimeRecordsGetPostResponsesContentApplicationJsonSchemaCode"},"error":{"type":"string"}},"required":["code","error"],"title":"GetARecordByIdOrTypeNameHostedRecordStoreGetRequestInternalServerError"},"V1RuntimeRecordsQueryPostRequestBodyContentApplicationJsonSchemaWhereOneOf0Op":{"type":"string","enum":["eq","neq","gt","gte","lt","lte","between","contains","startsWith","endsWith","in","notIn","isSet","isNotSet","isTrue","isFalse","withinLastDays","olderThanDays"],"title":"V1RuntimeRecordsQueryPostRequestBodyContentApplicationJsonSchemaWhereOneOf0Op"},"V1RuntimeRecordsQueryPostRequestBodyContentApplicationJsonSchemaWhere0":{"type":"object","properties":{"field":{"type":"string","pattern":"^[a-zA-Z0-9_][a-zA-Z0-9_.-]{0,63}$"},"op":{"$ref":"#/components/schemas/V1RuntimeRecordsQueryPostRequestBodyContentApplicationJsonSchemaWhereOneOf0Op"},"value":{"description":"Any type"}},"required":["field","op"],"title":"V1RuntimeRecordsQueryPostRequestBodyContentApplicationJsonSchemaWhere0"},"V1RuntimeRecordsQueryPostRequestBodyContentApplicationJsonSchemaWhereOneOf1ConditionsItemsOneOf0Op":{"type":"string","enum":["eq","neq","gt","gte","lt","lte","between","contains","startsWith","endsWith","in","notIn","isSet","isNotSet","isTrue","isFalse","withinLastDays","olderThanDays"],"title":"V1RuntimeRecordsQueryPostRequestBodyContentApplicationJsonSchemaWhereOneOf1ConditionsItemsOneOf0Op"},"V1RuntimeRecordsQueryPostRequestBodyContentApplicationJsonSchemaWhereOneOf1ConditionsItems0":{"type":"object","properties":{"field":{"type":"string","pattern":"^[a-zA-Z0-9_][a-zA-Z0-9_.-]{0,63}$"},"op":{"$ref":"#/components/schemas/V1RuntimeRecordsQueryPostRequestBodyContentApplicationJsonSchemaWhereOneOf1ConditionsItemsOneOf0Op"},"value":{"description":"Any type"}},"required":["field","op"],"title":"V1RuntimeRecordsQueryPostRequestBodyContentApplicationJsonSchemaWhereOneOf1ConditionsItems0"},"V1RuntimeRecordsQueryPostRequestBodyContentApplicationJsonSchemaWhereOneOf1ConditionsItemsOneOf1ConditionsItemsOp":{"type":"string","enum":["eq","neq","gt","gte","lt","lte","between","contains","startsWith","endsWith","in","notIn","isSet","isNotSet","isTrue","isFalse","withinLastDays","olderThanDays"],"title":"V1RuntimeRecordsQueryPostRequestBodyContentApplicationJsonSchemaWhereOneOf1ConditionsItemsOneOf1ConditionsItemsOp"},"V1RuntimeRecordsQueryPostRequestBodyContentApplicationJsonSchemaWhereOneOf1ConditionsItemsOneOf1ConditionsItems":{"type":"object","properties":{"field":{"type":"string","pattern":"^[a-zA-Z0-9_][a-zA-Z0-9_.-]{0,63}$"},"op":{"$ref":"#/components/schemas/V1RuntimeRecordsQueryPostRequestBodyContentApplicationJsonSchemaWhereOneOf1ConditionsItemsOneOf1ConditionsItemsOp"},"value":{"description":"Any type"}},"required":["field","op"],"title":"V1RuntimeRecordsQueryPostRequestBodyContentApplicationJsonSchemaWhereOneOf1ConditionsItemsOneOf1ConditionsItems"},"V1RuntimeRecordsQueryPostRequestBodyContentApplicationJsonSchemaWhereOneOf1ConditionsItemsOneOf1Op":{"type":"string","enum":["and","or"],"title":"V1RuntimeRecordsQueryPostRequestBodyContentApplicationJsonSchemaWhereOneOf1ConditionsItemsOneOf1Op"},"V1RuntimeRecordsQueryPostRequestBodyContentApplicationJsonSchemaWhereOneOf1ConditionsItems1":{"type":"object","properties":{"conditions":{"type":"array","items":{"$ref":"#/components/schemas/V1RuntimeRecordsQueryPostRequestBodyContentApplicationJsonSchemaWhereOneOf1ConditionsItemsOneOf1ConditionsItems"}},"op":{"$ref":"#/components/schemas/V1RuntimeRecordsQueryPostRequestBodyContentApplicationJsonSchemaWhereOneOf1ConditionsItemsOneOf1Op"}},"required":["conditions","op"],"title":"V1RuntimeRecordsQueryPostRequestBodyContentApplicationJsonSchemaWhereOneOf1ConditionsItems1"},"V1RuntimeRecordsQueryPostRequestBodyContentApplicationJsonSchemaWhereOneOf1ConditionsItems":{"oneOf":[{"$ref":"#/components/schemas/V1RuntimeRecordsQueryPostRequestBodyContentApplicationJsonSchemaWhereOneOf1ConditionsItems0"},{"$ref":"#/components/schemas/V1RuntimeRecordsQueryPostRequestBodyContentApplicationJsonSchemaWhereOneOf1ConditionsItems1"}],"title":"V1RuntimeRecordsQueryPostRequestBodyContentApplicationJsonSchemaWhereOneOf1ConditionsItems"},"V1RuntimeRecordsQueryPostRequestBodyContentApplicationJsonSchemaWhereOneOf1Op":{"type":"string","enum":["and","or"],"title":"V1RuntimeRecordsQueryPostRequestBodyContentApplicationJsonSchemaWhereOneOf1Op"},"V1RuntimeRecordsQueryPostRequestBodyContentApplicationJsonSchemaWhere1":{"type":"object","properties":{"conditions":{"type":"array","items":{"$ref":"#/components/schemas/V1RuntimeRecordsQueryPostRequestBodyContentApplicationJsonSchemaWhereOneOf1ConditionsItems"}},"op":{"$ref":"#/components/schemas/V1RuntimeRecordsQueryPostRequestBodyContentApplicationJsonSchemaWhereOneOf1Op"}},"required":["conditions","op"],"title":"V1RuntimeRecordsQueryPostRequestBodyContentApplicationJsonSchemaWhere1"},"V1RuntimeRecordsQueryPostRequestBodyContentApplicationJsonSchemaWhere":{"oneOf":[{"$ref":"#/components/schemas/V1RuntimeRecordsQueryPostRequestBodyContentApplicationJsonSchemaWhere0"},{"$ref":"#/components/schemas/V1RuntimeRecordsQueryPostRequestBodyContentApplicationJsonSchemaWhere1"}],"title":"V1RuntimeRecordsQueryPostRequestBodyContentApplicationJsonSchemaWhere"},"V1RuntimeRecordsQueryPostResponsesContentApplicationJsonSchemaRecordsItemsMessagesItems":{"type":"object","properties":{"content":{"type":"string"},"role":{"type":"string"}},"required":["content","role"],"title":"V1RuntimeRecordsQueryPostResponsesContentApplicationJsonSchemaRecordsItemsMessagesItems"},"V1RuntimeRecordsQueryPostResponsesContentApplicationJsonSchemaRecordsItems":{"type":"object","properties":{"createdAt":{"type":"string"},"id":{"type":"string"},"messages":{"type":["array","null"],"items":{"$ref":"#/components/schemas/V1RuntimeRecordsQueryPostResponsesContentApplicationJsonSchemaRecordsItemsMessagesItems"}},"metadata":{"type":"object","additionalProperties":{"description":"Any type"}},"metadataLabels":{"type":["object","null"],"additionalProperties":{"type":"string"}},"metadataSchema":{"type":["object","null"],"additionalProperties":{"description":"Any type"}},"name":{"type":"string"},"organizationId":{"type":["string","null"]},"ownerId":{"type":["string","null"]},"productSurfaceId":{"type":["string","null"]},"schemaValid":{"type":["boolean","null"]},"type":{"type":"string"},"updatedAt":{"type":"string"},"userId":{"type":"string"}},"required":["createdAt","id","metadata","name","organizationId","type","updatedAt","userId"],"title":"V1RuntimeRecordsQueryPostResponsesContentApplicationJsonSchemaRecordsItems"},"Self-hosting_queryRecordsHostedRecordStoreQuery_Response_200":{"type":"object","properties":{"records":{"type":"array","items":{"$ref":"#/components/schemas/V1RuntimeRecordsQueryPostResponsesContentApplicationJsonSchemaRecordsItems"}}},"required":["records"],"title":"Self-hosting_queryRecordsHostedRecordStoreQuery_Response_200"},"V1RuntimeRecordsQueryPostResponsesContentApplicationJsonSchemaCode":{"type":"string","enum":["invalid_request","record_write_failed","record_read_failed"],"title":"V1RuntimeRecordsQueryPostResponsesContentApplicationJsonSchemaCode"},"QueryRecordsHostedRecordStoreQueryRequestBadRequestError":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/V1RuntimeRecordsQueryPostResponsesContentApplicationJsonSchemaCode"},"error":{"type":"string"}},"required":["code","error"],"title":"QueryRecordsHostedRecordStoreQueryRequestBadRequestError"},"QueryRecordsHostedRecordStoreQueryRequestInternalServerError":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/V1RuntimeRecordsQueryPostResponsesContentApplicationJsonSchemaCode"},"error":{"type":"string"}},"required":["code","error"],"title":"QueryRecordsHostedRecordStoreQueryRequestInternalServerError"},"V1RuntimeRecordsUpdatePostRequestBodyContentApplicationJsonSchemaMergeStrategy":{"type":"string","enum":["merge","replace","deep-merge"],"title":"V1RuntimeRecordsUpdatePostRequestBodyContentApplicationJsonSchemaMergeStrategy"},"V1RuntimeRecordsUpdatePostResponsesContentApplicationJsonSchemaRecordMessagesItems":{"type":"object","properties":{"content":{"type":"string"},"role":{"type":"string"}},"required":["content","role"],"title":"V1RuntimeRecordsUpdatePostResponsesContentApplicationJsonSchemaRecordMessagesItems"},"V1RuntimeRecordsUpdatePostResponsesContentApplicationJsonSchemaRecord":{"type":"object","properties":{"createdAt":{"type":"string"},"id":{"type":"string"},"messages":{"type":["array","null"],"items":{"$ref":"#/components/schemas/V1RuntimeRecordsUpdatePostResponsesContentApplicationJsonSchemaRecordMessagesItems"}},"metadata":{"type":"object","additionalProperties":{"description":"Any type"}},"metadataLabels":{"type":["object","null"],"additionalProperties":{"type":"string"}},"metadataSchema":{"type":["object","null"],"additionalProperties":{"description":"Any type"}},"name":{"type":"string"},"organizationId":{"type":["string","null"]},"ownerId":{"type":["string","null"]},"productSurfaceId":{"type":["string","null"]},"schemaValid":{"type":["boolean","null"]},"type":{"type":"string"},"updatedAt":{"type":"string"},"userId":{"type":"string"}},"required":["createdAt","id","metadata","name","organizationId","type","updatedAt","userId"],"title":"V1RuntimeRecordsUpdatePostResponsesContentApplicationJsonSchemaRecord"},"Self-hosting_updateARecordByIdHostedRecordStoreUpdate_Response_200":{"type":"object","properties":{"record":{"oneOf":[{"$ref":"#/components/schemas/V1RuntimeRecordsUpdatePostResponsesContentApplicationJsonSchemaRecord"},{"type":"null"}]}},"required":["record"],"title":"Self-hosting_updateARecordByIdHostedRecordStoreUpdate_Response_200"},"V1RuntimeRecordsUpdatePostResponsesContentApplicationJsonSchemaCode":{"type":"string","enum":["invalid_request","record_write_failed","record_read_failed"],"title":"V1RuntimeRecordsUpdatePostResponsesContentApplicationJsonSchemaCode"},"UpdateARecordByIdHostedRecordStoreUpdateRequestBadRequestError":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/V1RuntimeRecordsUpdatePostResponsesContentApplicationJsonSchemaCode"},"error":{"type":"string"}},"required":["code","error"],"title":"UpdateARecordByIdHostedRecordStoreUpdateRequestBadRequestError"},"UpdateARecordByIdHostedRecordStoreUpdateRequestInternalServerError":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/V1RuntimeRecordsUpdatePostResponsesContentApplicationJsonSchemaCode"},"error":{"type":"string"}},"required":["code","error"],"title":"UpdateARecordByIdHostedRecordStoreUpdateRequestInternalServerError"},"V1RuntimeRecordsUpsertPostRequestBodyContentApplicationJsonSchemaMergeStrategy":{"type":"string","enum":["merge","replace"],"title":"V1RuntimeRecordsUpsertPostRequestBodyContentApplicationJsonSchemaMergeStrategy"},"V1RuntimeRecordsUpsertPostResponsesContentApplicationJsonSchemaRecordMessagesItems":{"type":"object","properties":{"content":{"type":"string"},"role":{"type":"string"}},"required":["content","role"],"title":"V1RuntimeRecordsUpsertPostResponsesContentApplicationJsonSchemaRecordMessagesItems"},"V1RuntimeRecordsUpsertPostResponsesContentApplicationJsonSchemaRecord":{"type":"object","properties":{"createdAt":{"type":"string"},"id":{"type":"string"},"messages":{"type":["array","null"],"items":{"$ref":"#/components/schemas/V1RuntimeRecordsUpsertPostResponsesContentApplicationJsonSchemaRecordMessagesItems"}},"metadata":{"type":"object","additionalProperties":{"description":"Any type"}},"metadataLabels":{"type":["object","null"],"additionalProperties":{"type":"string"}},"metadataSchema":{"type":["object","null"],"additionalProperties":{"description":"Any type"}},"name":{"type":"string"},"organizationId":{"type":["string","null"]},"ownerId":{"type":["string","null"]},"productSurfaceId":{"type":["string","null"]},"schemaValid":{"type":["boolean","null"]},"type":{"type":"string"},"updatedAt":{"type":"string"},"userId":{"type":"string"}},"required":["createdAt","id","metadata","name","organizationId","type","updatedAt","userId"],"title":"V1RuntimeRecordsUpsertPostResponsesContentApplicationJsonSchemaRecord"},"Self-hosting_upsertARecordHostedRecordStoreUpsert_Response_200":{"type":"object","properties":{"created":{"type":"boolean"},"record":{"$ref":"#/components/schemas/V1RuntimeRecordsUpsertPostResponsesContentApplicationJsonSchemaRecord"}},"required":["created","record"],"title":"Self-hosting_upsertARecordHostedRecordStoreUpsert_Response_200"},"V1RuntimeRecordsUpsertPostResponsesContentApplicationJsonSchemaCode":{"type":"string","enum":["invalid_request","record_write_failed","record_read_failed"],"title":"V1RuntimeRecordsUpsertPostResponsesContentApplicationJsonSchemaCode"},"UpsertARecordHostedRecordStoreUpsertRequestBadRequestError":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/V1RuntimeRecordsUpsertPostResponsesContentApplicationJsonSchemaCode"},"error":{"type":"string"}},"required":["code","error"],"title":"UpsertARecordHostedRecordStoreUpsertRequestBadRequestError"},"UpsertARecordHostedRecordStoreUpsertRequestInternalServerError":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/V1RuntimeRecordsUpsertPostResponsesContentApplicationJsonSchemaCode"},"error":{"type":"string"}},"required":["code","error"],"title":"UpsertARecordHostedRecordStoreUpsertRequestInternalServerError"},"V1RuntimeSearchPostRequestBodyContentApplicationJsonSchemaOptionsContents":{"type":"object","properties":{"highlights":{"type":"boolean"},"summary":{"type":"boolean"},"text":{"type":"boolean"}},"title":"V1RuntimeSearchPostRequestBodyContentApplicationJsonSchemaOptionsContents"},"V1RuntimeSearchPostRequestBodyContentApplicationJsonSchemaOptionsSearchType":{"type":"string","enum":["auto","neural","keyword"],"title":"V1RuntimeSearchPostRequestBodyContentApplicationJsonSchemaOptionsSearchType"},"V1RuntimeSearchPostRequestBodyContentApplicationJsonSchemaOptions":{"type":"object","properties":{"category":{"type":"string"},"contents":{"$ref":"#/components/schemas/V1RuntimeSearchPostRequestBodyContentApplicationJsonSchemaOptionsContents"},"endCrawlDate":{"type":"string"},"endPublishedDate":{"type":"string"},"excludeDomains":{"type":"array","items":{"type":"string"}},"includeDomains":{"type":"array","items":{"type":"string"}},"numResults":{"type":"integer","minimum":1,"maximum":100},"searchType":{"$ref":"#/components/schemas/V1RuntimeSearchPostRequestBodyContentApplicationJsonSchemaOptionsSearchType"},"startCrawlDate":{"type":"string"},"startPublishedDate":{"type":"string"}},"title":"V1RuntimeSearchPostRequestBodyContentApplicationJsonSchemaOptions"},"V1RuntimeSearchPostResponsesContentApplicationJsonSchemaCitationsItems":{"type":"object","properties":{"author":{"type":"string"},"id":{"type":"number","format":"double"},"publishedDate":{"type":"string"},"source":{"type":"string"},"title":{"type":"string"},"url":{"type":"string"}},"required":["id","source","title","url"],"title":"V1RuntimeSearchPostResponsesContentApplicationJsonSchemaCitationsItems"},"V1RuntimeSearchPostResponsesContentApplicationJsonSchemaResultsItems":{"type":"object","properties":{"author":{"type":"string"},"content":{"type":"string"},"highlights":{"type":"array","items":{"type":"string"}},"id":{"type":"string"},"publishedDate":{"type":"string"},"score":{"type":"number","format":"double"},"source":{"type":"string"},"summary":{"type":"string"},"text":{"type":"string"},"timestamp":{"type":"string"},"title":{"type":"string"},"url":{"type":"string"}},"title":"V1RuntimeSearchPostResponsesContentApplicationJsonSchemaResultsItems"},"Self-hosting_executeAHostedWebSearchForAStandaloneRuntime_Response_200":{"type":"object","properties":{"citations":{"type":"array","items":{"$ref":"#/components/schemas/V1RuntimeSearchPostResponsesContentApplicationJsonSchemaCitationsItems"}},"metadata":{"type":"object","additionalProperties":{"description":"Any type"}},"results":{"type":"array","items":{"$ref":"#/components/schemas/V1RuntimeSearchPostResponsesContentApplicationJsonSchemaResultsItems"}}},"required":["results"],"title":"Self-hosting_executeAHostedWebSearchForAStandaloneRuntime_Response_200"},"V1SandboxDeploymentsGetResponsesContentApplicationJsonSchemaDataItemsCounters":{"type":"object","properties":{"desiredRevision":{"type":"integer","exclusiveMinimum":0},"observedRevision":{"type":["integer","null"],"exclusiveMinimum":0},"providerGeneration":{"type":"integer","minimum":0},"resourceVersion":{"type":"integer","minimum":0},"runtimeEpoch":{"type":"integer","minimum":0}},"required":["desiredRevision","observedRevision","providerGeneration","resourceVersion","runtimeEpoch"],"title":"V1SandboxDeploymentsGetResponsesContentApplicationJsonSchemaDataItemsCounters"},"V1SandboxDeploymentsGetResponsesContentApplicationJsonSchemaDataItemsDesiredState":{"type":"string","enum":["active","suspended","destroyed","expired"],"title":"V1SandboxDeploymentsGetResponsesContentApplicationJsonSchemaDataItemsDesiredState"},"V1SandboxDeploymentsGetResponsesContentApplicationJsonSchemaDataItemsEffectivePolicyAccess":{"type":"string","enum":["bearer","public"],"title":"V1SandboxDeploymentsGetResponsesContentApplicationJsonSchemaDataItemsEffectivePolicyAccess"},"V1SandboxDeploymentsGetResponsesContentApplicationJsonSchemaDataItemsEffectivePolicyAvailability":{"type":"string","enum":["on-demand","warm"],"title":"V1SandboxDeploymentsGetResponsesContentApplicationJsonSchemaDataItemsEffectivePolicyAvailability"},"V1SandboxDeploymentsGetResponsesContentApplicationJsonSchemaDataItemsEffectivePolicyNetworkAccess0":{"type":"string","enum":["none","essentials","open"],"title":"V1SandboxDeploymentsGetResponsesContentApplicationJsonSchemaDataItemsEffectivePolicyNetworkAccess0"},"V1SandboxDeploymentsGetResponsesContentApplicationJsonSchemaDataItemsEffectivePolicyNetworkAccessOneOf1Profile":{"type":"string","enum":["none","essentials","open"],"title":"V1SandboxDeploymentsGetResponsesContentApplicationJsonSchemaDataItemsEffectivePolicyNetworkAccessOneOf1Profile"},"V1SandboxDeploymentsGetResponsesContentApplicationJsonSchemaDataItemsEffectivePolicyNetworkAccess1":{"type":"object","properties":{"allow":{"type":"array","items":{"type":"string","pattern":"^(?:\\*\\.)?(?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?\\.)*[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$","minLength":1,"maxLength":253}},"profile":{"$ref":"#/components/schemas/V1SandboxDeploymentsGetResponsesContentApplicationJsonSchemaDataItemsEffectivePolicyNetworkAccessOneOf1Profile"}},"title":"V1SandboxDeploymentsGetResponsesContentApplicationJsonSchemaDataItemsEffectivePolicyNetworkAccess1"},"V1SandboxDeploymentsGetResponsesContentApplicationJsonSchemaDataItemsEffectivePolicyNetworkAccess":{"oneOf":[{"$ref":"#/components/schemas/V1SandboxDeploymentsGetResponsesContentApplicationJsonSchemaDataItemsEffectivePolicyNetworkAccess0"},{"$ref":"#/components/schemas/V1SandboxDeploymentsGetResponsesContentApplicationJsonSchemaDataItemsEffectivePolicyNetworkAccess1"}],"title":"V1SandboxDeploymentsGetResponsesContentApplicationJsonSchemaDataItemsEffectivePolicyNetworkAccess"},"V1SandboxDeploymentsGetResponsesContentApplicationJsonSchemaDataItemsEffectivePolicyRestartPolicy":{"type":"string","enum":["never","process","replace-sandbox"],"title":"V1SandboxDeploymentsGetResponsesContentApplicationJsonSchemaDataItemsEffectivePolicyRestartPolicy"},"V1SandboxDeploymentsGetResponsesContentApplicationJsonSchemaDataItemsEffectivePolicyRetention":{"type":"string","enum":["10m","1h","24h","unlimited"],"title":"V1SandboxDeploymentsGetResponsesContentApplicationJsonSchemaDataItemsEffectivePolicyRetention"},"V1SandboxDeploymentsGetResponsesContentApplicationJsonSchemaDataItemsEffectivePolicySleepPolicyOneOf0Mode":{"type":"string","enum":["never"],"title":"V1SandboxDeploymentsGetResponsesContentApplicationJsonSchemaDataItemsEffectivePolicySleepPolicyOneOf0Mode"},"V1SandboxDeploymentsGetResponsesContentApplicationJsonSchemaDataItemsEffectivePolicySleepPolicy0":{"type":"object","properties":{"mode":{"$ref":"#/components/schemas/V1SandboxDeploymentsGetResponsesContentApplicationJsonSchemaDataItemsEffectivePolicySleepPolicyOneOf0Mode"}},"required":["mode"],"title":"V1SandboxDeploymentsGetResponsesContentApplicationJsonSchemaDataItemsEffectivePolicySleepPolicy0"},"V1SandboxDeploymentsGetResponsesContentApplicationJsonSchemaDataItemsEffectivePolicySleepPolicyOneOf1After":{"type":"string","enum":["5m","15m","30m","1h"],"title":"V1SandboxDeploymentsGetResponsesContentApplicationJsonSchemaDataItemsEffectivePolicySleepPolicyOneOf1After"},"V1SandboxDeploymentsGetResponsesContentApplicationJsonSchemaDataItemsEffectivePolicySleepPolicyOneOf1Mode":{"type":"string","enum":["idle"],"title":"V1SandboxDeploymentsGetResponsesContentApplicationJsonSchemaDataItemsEffectivePolicySleepPolicyOneOf1Mode"},"V1SandboxDeploymentsGetResponsesContentApplicationJsonSchemaDataItemsEffectivePolicySleepPolicy1":{"type":"object","properties":{"after":{"$ref":"#/components/schemas/V1SandboxDeploymentsGetResponsesContentApplicationJsonSchemaDataItemsEffectivePolicySleepPolicyOneOf1After"},"mode":{"$ref":"#/components/schemas/V1SandboxDeploymentsGetResponsesContentApplicationJsonSchemaDataItemsEffectivePolicySleepPolicyOneOf1Mode"}},"required":["after","mode"],"title":"V1SandboxDeploymentsGetResponsesContentApplicationJsonSchemaDataItemsEffectivePolicySleepPolicy1"},"V1SandboxDeploymentsGetResponsesContentApplicationJsonSchemaDataItemsEffectivePolicySleepPolicy":{"oneOf":[{"$ref":"#/components/schemas/V1SandboxDeploymentsGetResponsesContentApplicationJsonSchemaDataItemsEffectivePolicySleepPolicy0"},{"$ref":"#/components/schemas/V1SandboxDeploymentsGetResponsesContentApplicationJsonSchemaDataItemsEffectivePolicySleepPolicy1"}],"title":"V1SandboxDeploymentsGetResponsesContentApplicationJsonSchemaDataItemsEffectivePolicySleepPolicy"},"V1SandboxDeploymentsGetResponsesContentApplicationJsonSchemaDataItemsEffectivePolicy":{"type":"object","properties":{"access":{"$ref":"#/components/schemas/V1SandboxDeploymentsGetResponsesContentApplicationJsonSchemaDataItemsEffectivePolicyAccess"},"availability":{"$ref":"#/components/schemas/V1SandboxDeploymentsGetResponsesContentApplicationJsonSchemaDataItemsEffectivePolicyAvailability"},"networkAccess":{"$ref":"#/components/schemas/V1SandboxDeploymentsGetResponsesContentApplicationJsonSchemaDataItemsEffectivePolicyNetworkAccess"},"restartPolicy":{"$ref":"#/components/schemas/V1SandboxDeploymentsGetResponsesContentApplicationJsonSchemaDataItemsEffectivePolicyRestartPolicy"},"retention":{"$ref":"#/components/schemas/V1SandboxDeploymentsGetResponsesContentApplicationJsonSchemaDataItemsEffectivePolicyRetention"},"sleepPolicy":{"$ref":"#/components/schemas/V1SandboxDeploymentsGetResponsesContentApplicationJsonSchemaDataItemsEffectivePolicySleepPolicy"}},"required":["access","availability","restartPolicy","retention","sleepPolicy"],"title":"V1SandboxDeploymentsGetResponsesContentApplicationJsonSchemaDataItemsEffectivePolicy"},"V1SandboxDeploymentsGetResponsesContentApplicationJsonSchemaDataItemsEnvironment":{"type":"string","enum":["development","staging","production"],"title":"V1SandboxDeploymentsGetResponsesContentApplicationJsonSchemaDataItemsEnvironment"},"V1SandboxDeploymentsGetResponsesContentApplicationJsonSchemaDataItemsProfileEnvironment":{"type":"string","enum":["development","staging","production"],"title":"V1SandboxDeploymentsGetResponsesContentApplicationJsonSchemaDataItemsProfileEnvironment"},"V1SandboxDeploymentsGetResponsesContentApplicationJsonSchemaDataItemsProfile":{"type":"object","properties":{"accountTier":{"type":"string","minLength":1,"maxLength":200},"environment":{"$ref":"#/components/schemas/V1SandboxDeploymentsGetResponsesContentApplicationJsonSchemaDataItemsProfileEnvironment"},"profileId":{"type":"string","minLength":1,"maxLength":200},"providerId":{"type":"string","minLength":1,"maxLength":200},"runtimeClass":{"type":"string","minLength":1,"maxLength":200},"sdkVersion":{"type":"string","minLength":1,"maxLength":200}},"required":["accountTier","environment","profileId","providerId","runtimeClass","sdkVersion"],"title":"V1SandboxDeploymentsGetResponsesContentApplicationJsonSchemaDataItemsProfile"},"V1SandboxDeploymentsGetResponsesContentApplicationJsonSchemaDataItemsStatus":{"type":"string","enum":["provisioning","running","sleeping","suspended","degraded","failed","blocked","destroying","destroyed","expired"],"title":"V1SandboxDeploymentsGetResponsesContentApplicationJsonSchemaDataItemsStatus"},"V1SandboxDeploymentsGetResponsesContentApplicationJsonSchemaDataItems":{"type":"object","properties":{"activeOperationId":{"type":["string","null"]},"activeProviderInstanceId":{"type":["string","null"]},"counters":{"$ref":"#/components/schemas/V1SandboxDeploymentsGetResponsesContentApplicationJsonSchemaDataItemsCounters"},"createdAt":{"type":"string"},"createdByUserId":{"type":["string","null"]},"deploymentId":{"type":"string"},"desiredState":{"$ref":"#/components/schemas/V1SandboxDeploymentsGetResponsesContentApplicationJsonSchemaDataItemsDesiredState"},"displayName":{"type":["string","null"]},"effectivePolicy":{"$ref":"#/components/schemas/V1SandboxDeploymentsGetResponsesContentApplicationJsonSchemaDataItemsEffectivePolicy"},"environment":{"$ref":"#/components/schemas/V1SandboxDeploymentsGetResponsesContentApplicationJsonSchemaDataItemsEnvironment"},"expiresAt":{"type":["string","null"]},"ingressEnabled":{"type":"boolean"},"organizationId":{"type":"string"},"profile":{"$ref":"#/components/schemas/V1SandboxDeploymentsGetResponsesContentApplicationJsonSchemaDataItemsProfile"},"retentionAnchorAt":{"type":"string"},"specHash":{"type":"string"},"status":{"$ref":"#/components/schemas/V1SandboxDeploymentsGetResponsesContentApplicationJsonSchemaDataItemsStatus"},"statusReason":{"type":["string","null"]},"updatedAt":{"type":"string"},"url":{"type":["string","null"]}},"required":["activeOperationId","activeProviderInstanceId","counters","createdAt","createdByUserId","deploymentId","desiredState","displayName","effectivePolicy","environment","expiresAt","ingressEnabled","organizationId","profile","retentionAnchorAt","specHash","status","statusReason","updatedAt","url"],"title":"V1SandboxDeploymentsGetResponsesContentApplicationJsonSchemaDataItems"},"V1SandboxDeploymentsGetResponsesContentApplicationJsonSchemaPagination":{"type":"object","properties":{"hasMore":{"type":"boolean"},"limit":{"type":"integer"},"nextCursor":{"type":["string","null"]}},"required":["hasMore","limit","nextCursor"],"title":"V1SandboxDeploymentsGetResponsesContentApplicationJsonSchemaPagination"},"Sandbox_Deployments_listManagedSandboxDeployments_Response_200":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1SandboxDeploymentsGetResponsesContentApplicationJsonSchemaDataItems"}},"pagination":{"$ref":"#/components/schemas/V1SandboxDeploymentsGetResponsesContentApplicationJsonSchemaPagination"}},"required":["data","pagination"],"title":"Sandbox Deployments_listManagedSandboxDeployments_Response_200"},"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecAvailability":{"type":"string","enum":["on-demand","warm"],"title":"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecAvailability"},"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecCapabilitiesItems":{"type":"string","enum":["inspect-without-start","network-policy","private-ingress","process-adoption","rebuild","terminate:process-tree","terminate:sandbox-destroy","terminate:sandbox-stop","wake"],"title":"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecCapabilitiesItems"},"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecCredentialAuthorityOneOf0Kind":{"type":"string","enum":["organization-connection"],"title":"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecCredentialAuthorityOneOf0Kind"},"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecCredentialAuthority0":{"type":"object","properties":{"connectionId":{"type":"string","minLength":1,"maxLength":200},"kind":{"$ref":"#/components/schemas/V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecCredentialAuthorityOneOf0Kind"}},"required":["connectionId","kind"],"title":"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecCredentialAuthority0"},"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecCredentialAuthorityOneOf1Kind":{"type":"string","enum":["platform-managed"],"title":"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecCredentialAuthorityOneOf1Kind"},"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecCredentialAuthority1":{"type":"object","properties":{"kind":{"$ref":"#/components/schemas/V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecCredentialAuthorityOneOf1Kind"},"providerPolicyId":{"type":"string","minLength":1,"maxLength":200}},"required":["kind","providerPolicyId"],"title":"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecCredentialAuthority1"},"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecCredentialAuthority":{"oneOf":[{"$ref":"#/components/schemas/V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecCredentialAuthority0"},{"$ref":"#/components/schemas/V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecCredentialAuthority1"}],"title":"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecCredentialAuthority"},"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecHealthOneOf0Kind":{"type":"string","enum":["tcp"],"title":"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecHealthOneOf0Kind"},"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecHealth0":{"type":"object","properties":{"kind":{"$ref":"#/components/schemas/V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecHealthOneOf0Kind"}},"required":["kind"],"title":"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecHealth0"},"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecHealthOneOf1Kind":{"type":"string","enum":["http"],"title":"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecHealthOneOf1Kind"},"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecHealth1":{"type":"object","properties":{"expectedStatus":{"type":"integer","minimum":100,"maximum":599},"kind":{"$ref":"#/components/schemas/V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecHealthOneOf1Kind"},"path":{"type":"string","minLength":1,"maxLength":512}},"required":["expectedStatus","kind","path"],"title":"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecHealth1"},"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecHealth":{"oneOf":[{"$ref":"#/components/schemas/V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecHealth0"},{"$ref":"#/components/schemas/V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecHealth1"}],"title":"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecHealth"},"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecIngressAccess":{"type":"string","enum":["bearer","public"],"title":"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecIngressAccess"},"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecIngress":{"type":"object","properties":{"access":{"$ref":"#/components/schemas/V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecIngressAccess"},"allowedOrigins":{"type":"array","items":{"type":"string","minLength":1,"maxLength":255},"default":[]}},"required":["access"],"title":"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecIngress"},"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecLanguage":{"type":"string","enum":["javascript","typescript","python"],"title":"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecLanguage"},"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecNetworkAccess0":{"type":"string","enum":["none","essentials","open"],"title":"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecNetworkAccess0"},"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecNetworkAccessOneOf1Profile":{"type":"string","enum":["none","essentials","open"],"title":"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecNetworkAccessOneOf1Profile"},"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecNetworkAccess1":{"type":"object","properties":{"allow":{"type":"array","items":{"type":"string","pattern":"^(?:\\*\\.)?(?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?\\.)*[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$","minLength":1,"maxLength":253}},"profile":{"$ref":"#/components/schemas/V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecNetworkAccessOneOf1Profile"}},"title":"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecNetworkAccess1"},"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecNetworkAccess":{"oneOf":[{"$ref":"#/components/schemas/V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecNetworkAccess0"},{"$ref":"#/components/schemas/V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecNetworkAccess1"}],"title":"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecNetworkAccess"},"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecProfileEnvironment":{"type":"string","enum":["development","staging","production"],"title":"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecProfileEnvironment"},"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecProfile":{"type":"object","properties":{"accountTier":{"type":"string","minLength":1,"maxLength":200},"environment":{"$ref":"#/components/schemas/V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecProfileEnvironment"},"profileId":{"type":"string","minLength":1,"maxLength":200},"providerId":{"type":"string","minLength":1,"maxLength":200},"runtimeClass":{"type":"string","minLength":1,"maxLength":200},"sdkVersion":{"type":"string","minLength":1,"maxLength":200}},"required":["accountTier","environment","profileId","providerId","runtimeClass","sdkVersion"],"title":"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecProfile"},"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecRestartPolicy":{"type":"string","enum":["never","process","replace-sandbox"],"title":"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecRestartPolicy"},"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecRetention":{"type":"string","enum":["10m","1h","24h","unlimited"],"title":"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecRetention"},"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecRuntimeProfile":{"type":"object","properties":{"runtimeProfileDigest":{"type":"string","pattern":"^[0-9a-f]{64}$"},"runtimeProfileId":{"type":"string","minLength":1,"maxLength":200}},"required":["runtimeProfileDigest","runtimeProfileId"],"title":"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecRuntimeProfile"},"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecSleepPolicyOneOf0Mode":{"type":"string","enum":["never"],"title":"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecSleepPolicyOneOf0Mode"},"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecSleepPolicy0":{"type":"object","properties":{"mode":{"$ref":"#/components/schemas/V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecSleepPolicyOneOf0Mode"}},"required":["mode"],"title":"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecSleepPolicy0"},"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecSleepPolicyOneOf1After":{"type":"string","enum":["5m","15m","30m","1h"],"title":"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecSleepPolicyOneOf1After"},"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecSleepPolicyOneOf1Mode":{"type":"string","enum":["idle"],"title":"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecSleepPolicyOneOf1Mode"},"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecSleepPolicy1":{"type":"object","properties":{"after":{"$ref":"#/components/schemas/V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecSleepPolicyOneOf1After"},"mode":{"$ref":"#/components/schemas/V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecSleepPolicyOneOf1Mode"}},"required":["after","mode"],"title":"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecSleepPolicy1"},"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecSleepPolicy":{"oneOf":[{"$ref":"#/components/schemas/V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecSleepPolicy0"},{"$ref":"#/components/schemas/V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecSleepPolicy1"}],"title":"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecSleepPolicy"},"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecSource":{"type":"object","properties":{"sourceAssetId":{"type":"string","minLength":1,"maxLength":200},"sourceHash":{"type":"string","pattern":"^[0-9a-f]{64}$"}},"required":["sourceAssetId","sourceHash"],"title":"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecSource"},"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0Spec":{"type":"object","properties":{"availability":{"$ref":"#/components/schemas/V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecAvailability"},"capabilities":{"type":"array","items":{"$ref":"#/components/schemas/V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecCapabilitiesItems"}},"credentialAuthority":{"$ref":"#/components/schemas/V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecCredentialAuthority"},"health":{"$ref":"#/components/schemas/V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecHealth"},"ingress":{"$ref":"#/components/schemas/V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecIngress"},"language":{"$ref":"#/components/schemas/V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecLanguage"},"networkAccess":{"$ref":"#/components/schemas/V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecNetworkAccess"},"networkPolicyRef":{"type":"string","minLength":1,"maxLength":200},"port":{"type":"integer","minimum":1,"maximum":65535},"profile":{"$ref":"#/components/schemas/V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecProfile"},"restartPolicy":{"$ref":"#/components/schemas/V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecRestartPolicy"},"retention":{"$ref":"#/components/schemas/V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecRetention"},"runtimeProfile":{"$ref":"#/components/schemas/V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecRuntimeProfile"},"secretBindings":{"type":"object","additionalProperties":{"type":"string","minLength":1,"maxLength":200},"default":{}},"sleepPolicy":{"$ref":"#/components/schemas/V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecSleepPolicy"},"source":{"$ref":"#/components/schemas/V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0SpecSource"},"startCommand":{"type":"string","minLength":1,"maxLength":2000}},"required":["availability","capabilities","credentialAuthority","health","ingress","language","networkPolicyRef","port","profile","restartPolicy","retention","runtimeProfile","sleepPolicy","source","startCommand"],"title":"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0Spec"},"SandboxDeploymentsCreateAManagedSandboxDeploymentRequest0":{"type":"object","properties":{"displayName":{"type":"string","minLength":1,"maxLength":200},"spec":{"$ref":"#/components/schemas/V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf0Spec"}},"required":["spec"],"title":"SandboxDeploymentsCreateAManagedSandboxDeploymentRequest0"},"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf1ConfigCredentialAuthorityOneOf0Kind":{"type":"string","enum":["organization-connection"],"title":"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf1ConfigCredentialAuthorityOneOf0Kind"},"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf1ConfigCredentialAuthority0":{"type":"object","properties":{"connectionId":{"type":"string","minLength":1,"maxLength":200},"kind":{"$ref":"#/components/schemas/V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf1ConfigCredentialAuthorityOneOf0Kind"}},"required":["connectionId","kind"],"title":"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf1ConfigCredentialAuthority0"},"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf1ConfigCredentialAuthorityOneOf1Kind":{"type":"string","enum":["platform-managed"],"title":"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf1ConfigCredentialAuthorityOneOf1Kind"},"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf1ConfigCredentialAuthority1":{"type":"object","properties":{"kind":{"$ref":"#/components/schemas/V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf1ConfigCredentialAuthorityOneOf1Kind"},"providerPolicyId":{"type":"string","minLength":1,"maxLength":200}},"required":["kind","providerPolicyId"],"title":"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf1ConfigCredentialAuthority1"},"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf1ConfigCredentialAuthority":{"oneOf":[{"$ref":"#/components/schemas/V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf1ConfigCredentialAuthority0"},{"$ref":"#/components/schemas/V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf1ConfigCredentialAuthority1"}],"title":"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf1ConfigCredentialAuthority"},"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf1ConfigHealthOneOf0Kind":{"type":"string","enum":["tcp"],"title":"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf1ConfigHealthOneOf0Kind"},"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf1ConfigHealth0":{"type":"object","properties":{"kind":{"$ref":"#/components/schemas/V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf1ConfigHealthOneOf0Kind"}},"required":["kind"],"title":"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf1ConfigHealth0"},"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf1ConfigHealthOneOf1Kind":{"type":"string","enum":["http"],"title":"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf1ConfigHealthOneOf1Kind"},"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf1ConfigHealth1":{"type":"object","properties":{"expectedStatus":{"type":"integer","minimum":100,"maximum":599},"kind":{"$ref":"#/components/schemas/V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf1ConfigHealthOneOf1Kind"},"path":{"type":"string","minLength":1,"maxLength":512}},"required":["expectedStatus","kind","path"],"title":"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf1ConfigHealth1"},"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf1ConfigHealth":{"oneOf":[{"$ref":"#/components/schemas/V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf1ConfigHealth0"},{"$ref":"#/components/schemas/V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf1ConfigHealth1"}],"title":"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf1ConfigHealth"},"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf1ConfigIngressAccess":{"type":"string","enum":["bearer","public"],"title":"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf1ConfigIngressAccess"},"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf1ConfigIngress":{"type":"object","properties":{"access":{"$ref":"#/components/schemas/V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf1ConfigIngressAccess"},"allowedOrigins":{"type":"array","items":{"type":"string","minLength":1,"maxLength":255}}},"required":["access"],"title":"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf1ConfigIngress"},"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf1ConfigLanguage":{"type":"string","enum":["javascript","typescript","python"],"title":"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf1ConfigLanguage"},"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf1ConfigNetworkAccess0":{"type":"string","enum":["none","essentials","open"],"title":"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf1ConfigNetworkAccess0"},"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf1ConfigNetworkAccessOneOf1Profile":{"type":"string","enum":["none","essentials"],"title":"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf1ConfigNetworkAccessOneOf1Profile"},"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf1ConfigNetworkAccess1":{"type":"object","properties":{"allow":{"type":"array","items":{"type":"string","pattern":"^(?:\\*\\.)?(?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?\\.)*[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$","minLength":1,"maxLength":253}},"profile":{"$ref":"#/components/schemas/V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf1ConfigNetworkAccessOneOf1Profile"}},"required":["allow","profile"],"title":"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf1ConfigNetworkAccess1"},"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf1ConfigNetworkAccess":{"oneOf":[{"$ref":"#/components/schemas/V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf1ConfigNetworkAccess0"},{"$ref":"#/components/schemas/V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf1ConfigNetworkAccess1"}],"title":"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf1ConfigNetworkAccess"},"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf1ConfigRestartPolicy":{"type":"string","enum":["never","replace-sandbox"],"title":"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf1ConfigRestartPolicy"},"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf1ConfigRetention":{"type":"string","enum":["10m","1h","24h","unlimited"],"title":"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf1ConfigRetention"},"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf1ConfigSleepPolicyOneOf0Mode":{"type":"string","enum":["never"],"title":"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf1ConfigSleepPolicyOneOf0Mode"},"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf1ConfigSleepPolicy0":{"type":"object","properties":{"mode":{"$ref":"#/components/schemas/V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf1ConfigSleepPolicyOneOf0Mode"}},"required":["mode"],"title":"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf1ConfigSleepPolicy0"},"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf1ConfigSleepPolicyOneOf1After":{"type":"string","enum":["5m","15m","30m","1h"],"title":"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf1ConfigSleepPolicyOneOf1After"},"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf1ConfigSleepPolicyOneOf1Mode":{"type":"string","enum":["idle"],"title":"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf1ConfigSleepPolicyOneOf1Mode"},"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf1ConfigSleepPolicy1":{"type":"object","properties":{"after":{"$ref":"#/components/schemas/V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf1ConfigSleepPolicyOneOf1After"},"mode":{"$ref":"#/components/schemas/V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf1ConfigSleepPolicyOneOf1Mode"}},"required":["after","mode"],"title":"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf1ConfigSleepPolicy1"},"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf1ConfigSleepPolicy":{"oneOf":[{"$ref":"#/components/schemas/V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf1ConfigSleepPolicy0"},{"$ref":"#/components/schemas/V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf1ConfigSleepPolicy1"}],"title":"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf1ConfigSleepPolicy"},"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf1Config":{"type":"object","properties":{"credentialAuthority":{"$ref":"#/components/schemas/V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf1ConfigCredentialAuthority"},"health":{"$ref":"#/components/schemas/V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf1ConfigHealth"},"ingress":{"$ref":"#/components/schemas/V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf1ConfigIngress"},"language":{"$ref":"#/components/schemas/V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf1ConfigLanguage"},"networkAccess":{"$ref":"#/components/schemas/V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf1ConfigNetworkAccess"},"port":{"type":"integer","minimum":1,"maximum":65535},"restartPolicy":{"$ref":"#/components/schemas/V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf1ConfigRestartPolicy"},"retention":{"$ref":"#/components/schemas/V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf1ConfigRetention"},"runtimeProfileId":{"type":"string","minLength":1,"maxLength":200},"secretBindings":{"type":"object","additionalProperties":{"type":"string","minLength":1,"maxLength":200}},"sleepPolicy":{"$ref":"#/components/schemas/V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf1ConfigSleepPolicy"},"sourceAssetId":{"type":"string","minLength":1,"maxLength":200},"startCommand":{"type":"string","minLength":1,"maxLength":2000}},"required":["credentialAuthority","language","port","retention","runtimeProfileId","sourceAssetId","startCommand"],"title":"V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf1Config"},"SandboxDeploymentsCreateAManagedSandboxDeploymentRequest1":{"type":"object","properties":{"config":{"$ref":"#/components/schemas/V1SandboxDeploymentsPostRequestBodyContentApplicationJsonSchemaOneOf1Config"},"displayName":{"type":"string","minLength":1,"maxLength":200}},"required":["config"],"title":"SandboxDeploymentsCreateAManagedSandboxDeploymentRequest1"},"Sandbox_Deployments_createAManagedSandboxDeployment_Request":{"oneOf":[{"$ref":"#/components/schemas/SandboxDeploymentsCreateAManagedSandboxDeploymentRequest0"},{"$ref":"#/components/schemas/SandboxDeploymentsCreateAManagedSandboxDeploymentRequest1"}],"title":"Sandbox Deployments_createAManagedSandboxDeployment_Request"},"V1SandboxDeploymentsPostResponsesContentApplicationJsonSchemaDeploymentCounters":{"type":"object","properties":{"desiredRevision":{"type":"integer","exclusiveMinimum":0},"observedRevision":{"type":["integer","null"],"exclusiveMinimum":0},"providerGeneration":{"type":"integer","minimum":0},"resourceVersion":{"type":"integer","minimum":0},"runtimeEpoch":{"type":"integer","minimum":0}},"required":["desiredRevision","observedRevision","providerGeneration","resourceVersion","runtimeEpoch"],"title":"V1SandboxDeploymentsPostResponsesContentApplicationJsonSchemaDeploymentCounters"},"V1SandboxDeploymentsPostResponsesContentApplicationJsonSchemaDeploymentDesiredState":{"type":"string","enum":["active","suspended","destroyed","expired"],"title":"V1SandboxDeploymentsPostResponsesContentApplicationJsonSchemaDeploymentDesiredState"},"V1SandboxDeploymentsPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyAccess":{"type":"string","enum":["bearer","public"],"title":"V1SandboxDeploymentsPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyAccess"},"V1SandboxDeploymentsPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyAvailability":{"type":"string","enum":["on-demand","warm"],"title":"V1SandboxDeploymentsPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyAvailability"},"V1SandboxDeploymentsPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyNetworkAccess0":{"type":"string","enum":["none","essentials","open"],"title":"V1SandboxDeploymentsPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyNetworkAccess0"},"V1SandboxDeploymentsPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyNetworkAccessOneOf1Profile":{"type":"string","enum":["none","essentials","open"],"title":"V1SandboxDeploymentsPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyNetworkAccessOneOf1Profile"},"V1SandboxDeploymentsPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyNetworkAccess1":{"type":"object","properties":{"allow":{"type":"array","items":{"type":"string","pattern":"^(?:\\*\\.)?(?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?\\.)*[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$","minLength":1,"maxLength":253}},"profile":{"$ref":"#/components/schemas/V1SandboxDeploymentsPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyNetworkAccessOneOf1Profile"}},"title":"V1SandboxDeploymentsPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyNetworkAccess1"},"V1SandboxDeploymentsPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyNetworkAccess":{"oneOf":[{"$ref":"#/components/schemas/V1SandboxDeploymentsPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyNetworkAccess0"},{"$ref":"#/components/schemas/V1SandboxDeploymentsPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyNetworkAccess1"}],"title":"V1SandboxDeploymentsPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyNetworkAccess"},"V1SandboxDeploymentsPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyRestartPolicy":{"type":"string","enum":["never","process","replace-sandbox"],"title":"V1SandboxDeploymentsPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyRestartPolicy"},"V1SandboxDeploymentsPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyRetention":{"type":"string","enum":["10m","1h","24h","unlimited"],"title":"V1SandboxDeploymentsPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyRetention"},"V1SandboxDeploymentsPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicyOneOf0Mode":{"type":"string","enum":["never"],"title":"V1SandboxDeploymentsPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicyOneOf0Mode"},"V1SandboxDeploymentsPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicy0":{"type":"object","properties":{"mode":{"$ref":"#/components/schemas/V1SandboxDeploymentsPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicyOneOf0Mode"}},"required":["mode"],"title":"V1SandboxDeploymentsPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicy0"},"V1SandboxDeploymentsPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicyOneOf1After":{"type":"string","enum":["5m","15m","30m","1h"],"title":"V1SandboxDeploymentsPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicyOneOf1After"},"V1SandboxDeploymentsPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicyOneOf1Mode":{"type":"string","enum":["idle"],"title":"V1SandboxDeploymentsPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicyOneOf1Mode"},"V1SandboxDeploymentsPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicy1":{"type":"object","properties":{"after":{"$ref":"#/components/schemas/V1SandboxDeploymentsPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicyOneOf1After"},"mode":{"$ref":"#/components/schemas/V1SandboxDeploymentsPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicyOneOf1Mode"}},"required":["after","mode"],"title":"V1SandboxDeploymentsPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicy1"},"V1SandboxDeploymentsPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicy":{"oneOf":[{"$ref":"#/components/schemas/V1SandboxDeploymentsPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicy0"},{"$ref":"#/components/schemas/V1SandboxDeploymentsPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicy1"}],"title":"V1SandboxDeploymentsPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicy"},"V1SandboxDeploymentsPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicy":{"type":"object","properties":{"access":{"$ref":"#/components/schemas/V1SandboxDeploymentsPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyAccess"},"availability":{"$ref":"#/components/schemas/V1SandboxDeploymentsPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyAvailability"},"networkAccess":{"$ref":"#/components/schemas/V1SandboxDeploymentsPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyNetworkAccess"},"restartPolicy":{"$ref":"#/components/schemas/V1SandboxDeploymentsPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyRestartPolicy"},"retention":{"$ref":"#/components/schemas/V1SandboxDeploymentsPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyRetention"},"sleepPolicy":{"$ref":"#/components/schemas/V1SandboxDeploymentsPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicy"}},"required":["access","availability","restartPolicy","retention","sleepPolicy"],"title":"V1SandboxDeploymentsPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicy"},"V1SandboxDeploymentsPostResponsesContentApplicationJsonSchemaDeploymentEnvironment":{"type":"string","enum":["development","staging","production"],"title":"V1SandboxDeploymentsPostResponsesContentApplicationJsonSchemaDeploymentEnvironment"},"V1SandboxDeploymentsPostResponsesContentApplicationJsonSchemaDeploymentProfileEnvironment":{"type":"string","enum":["development","staging","production"],"title":"V1SandboxDeploymentsPostResponsesContentApplicationJsonSchemaDeploymentProfileEnvironment"},"V1SandboxDeploymentsPostResponsesContentApplicationJsonSchemaDeploymentProfile":{"type":"object","properties":{"accountTier":{"type":"string","minLength":1,"maxLength":200},"environment":{"$ref":"#/components/schemas/V1SandboxDeploymentsPostResponsesContentApplicationJsonSchemaDeploymentProfileEnvironment"},"profileId":{"type":"string","minLength":1,"maxLength":200},"providerId":{"type":"string","minLength":1,"maxLength":200},"runtimeClass":{"type":"string","minLength":1,"maxLength":200},"sdkVersion":{"type":"string","minLength":1,"maxLength":200}},"required":["accountTier","environment","profileId","providerId","runtimeClass","sdkVersion"],"title":"V1SandboxDeploymentsPostResponsesContentApplicationJsonSchemaDeploymentProfile"},"V1SandboxDeploymentsPostResponsesContentApplicationJsonSchemaDeploymentStatus":{"type":"string","enum":["provisioning","running","sleeping","suspended","degraded","failed","blocked","destroying","destroyed","expired"],"title":"V1SandboxDeploymentsPostResponsesContentApplicationJsonSchemaDeploymentStatus"},"V1SandboxDeploymentsPostResponsesContentApplicationJsonSchemaDeployment":{"type":"object","properties":{"activeOperationId":{"type":["string","null"]},"activeProviderInstanceId":{"type":["string","null"]},"counters":{"$ref":"#/components/schemas/V1SandboxDeploymentsPostResponsesContentApplicationJsonSchemaDeploymentCounters"},"createdAt":{"type":"string"},"createdByUserId":{"type":["string","null"]},"deploymentId":{"type":"string"},"desiredState":{"$ref":"#/components/schemas/V1SandboxDeploymentsPostResponsesContentApplicationJsonSchemaDeploymentDesiredState"},"displayName":{"type":["string","null"]},"effectivePolicy":{"$ref":"#/components/schemas/V1SandboxDeploymentsPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicy"},"environment":{"$ref":"#/components/schemas/V1SandboxDeploymentsPostResponsesContentApplicationJsonSchemaDeploymentEnvironment"},"expiresAt":{"type":["string","null"]},"ingressEnabled":{"type":"boolean"},"organizationId":{"type":"string"},"profile":{"$ref":"#/components/schemas/V1SandboxDeploymentsPostResponsesContentApplicationJsonSchemaDeploymentProfile"},"retentionAnchorAt":{"type":"string"},"specHash":{"type":"string"},"status":{"$ref":"#/components/schemas/V1SandboxDeploymentsPostResponsesContentApplicationJsonSchemaDeploymentStatus"},"statusReason":{"type":["string","null"]},"updatedAt":{"type":"string"},"url":{"type":["string","null"]}},"required":["activeOperationId","activeProviderInstanceId","counters","createdAt","createdByUserId","deploymentId","desiredState","displayName","effectivePolicy","environment","expiresAt","ingressEnabled","organizationId","profile","retentionAnchorAt","specHash","status","statusReason","updatedAt","url"],"title":"V1SandboxDeploymentsPostResponsesContentApplicationJsonSchemaDeployment"},"Sandbox_Deployments_createAManagedSandboxDeployment_Response_202":{"type":"object","properties":{"deployment":{"$ref":"#/components/schemas/V1SandboxDeploymentsPostResponsesContentApplicationJsonSchemaDeployment"},"operationId":{"type":["string","null"]}},"required":["deployment","operationId"],"title":"Sandbox Deployments_createAManagedSandboxDeployment_Response_202"},"V1SandboxDeploymentsRuntimeProfilesGetResponsesContentApplicationJsonSchemaDataItemsAdmission":{"type":"object","properties":{"admitted":{"type":"boolean"},"reason":{"type":["string","null"]}},"required":["admitted","reason"],"title":"V1SandboxDeploymentsRuntimeProfilesGetResponsesContentApplicationJsonSchemaDataItemsAdmission"},"V1SandboxDeploymentsRuntimeProfilesGetResponsesContentApplicationJsonSchemaDataItemsCredentialAuthoritiesItemsKind":{"type":"string","enum":["organization-connection","platform-managed"],"title":"V1SandboxDeploymentsRuntimeProfilesGetResponsesContentApplicationJsonSchemaDataItemsCredentialAuthoritiesItemsKind"},"V1SandboxDeploymentsRuntimeProfilesGetResponsesContentApplicationJsonSchemaDataItemsCredentialAuthoritiesItems":{"type":"object","properties":{"admitted":{"type":"boolean"},"kind":{"$ref":"#/components/schemas/V1SandboxDeploymentsRuntimeProfilesGetResponsesContentApplicationJsonSchemaDataItemsCredentialAuthoritiesItemsKind"},"reason":{"type":["string","null"]}},"required":["admitted","kind","reason"],"title":"V1SandboxDeploymentsRuntimeProfilesGetResponsesContentApplicationJsonSchemaDataItemsCredentialAuthoritiesItems"},"V1SandboxDeploymentsRuntimeProfilesGetResponsesContentApplicationJsonSchemaDataItemsImplementedCapabilitiesItems":{"type":"string","enum":["inspect-without-start","network-policy","private-ingress","process-adoption","rebuild","terminate:process-tree","terminate:sandbox-destroy","terminate:sandbox-stop","wake"],"title":"V1SandboxDeploymentsRuntimeProfilesGetResponsesContentApplicationJsonSchemaDataItemsImplementedCapabilitiesItems"},"V1SandboxDeploymentsRuntimeProfilesGetResponsesContentApplicationJsonSchemaDataItemsLanguagesItems":{"type":"string","enum":["javascript","typescript","python"],"title":"V1SandboxDeploymentsRuntimeProfilesGetResponsesContentApplicationJsonSchemaDataItemsLanguagesItems"},"V1SandboxDeploymentsRuntimeProfilesGetResponsesContentApplicationJsonSchemaDataItemsOrganizationEligibility":{"type":"string","enum":["requires-credential-and-spend-check"],"title":"V1SandboxDeploymentsRuntimeProfilesGetResponsesContentApplicationJsonSchemaDataItemsOrganizationEligibility"},"V1SandboxDeploymentsRuntimeProfilesGetResponsesContentApplicationJsonSchemaDataItemsProfileEnvironment":{"type":"string","enum":["development","staging","production"],"title":"V1SandboxDeploymentsRuntimeProfilesGetResponsesContentApplicationJsonSchemaDataItemsProfileEnvironment"},"V1SandboxDeploymentsRuntimeProfilesGetResponsesContentApplicationJsonSchemaDataItemsProfile":{"type":"object","properties":{"accountTier":{"type":"string","minLength":1,"maxLength":200},"environment":{"$ref":"#/components/schemas/V1SandboxDeploymentsRuntimeProfilesGetResponsesContentApplicationJsonSchemaDataItemsProfileEnvironment"},"profileId":{"type":"string","minLength":1,"maxLength":200},"providerId":{"type":"string","minLength":1,"maxLength":200},"runtimeClass":{"type":"string","minLength":1,"maxLength":200},"sdkVersion":{"type":"string","minLength":1,"maxLength":200}},"required":["accountTier","environment","profileId","providerId","runtimeClass","sdkVersion"],"title":"V1SandboxDeploymentsRuntimeProfilesGetResponsesContentApplicationJsonSchemaDataItemsProfile"},"V1SandboxDeploymentsRuntimeProfilesGetResponsesContentApplicationJsonSchemaDataItemsSupportedNetworkAccessItems":{"type":"string","enum":["none","essentials","open"],"title":"V1SandboxDeploymentsRuntimeProfilesGetResponsesContentApplicationJsonSchemaDataItemsSupportedNetworkAccessItems"},"V1SandboxDeploymentsRuntimeProfilesGetResponsesContentApplicationJsonSchemaDataItemsVerifiedCapabilitiesItems":{"type":"string","enum":["inspect-without-start","network-policy","private-ingress","process-adoption","rebuild","terminate:process-tree","terminate:sandbox-destroy","terminate:sandbox-stop","wake"],"title":"V1SandboxDeploymentsRuntimeProfilesGetResponsesContentApplicationJsonSchemaDataItemsVerifiedCapabilitiesItems"},"V1SandboxDeploymentsRuntimeProfilesGetResponsesContentApplicationJsonSchemaDataItems":{"type":"object","properties":{"admission":{"$ref":"#/components/schemas/V1SandboxDeploymentsRuntimeProfilesGetResponsesContentApplicationJsonSchemaDataItemsAdmission"},"credentialAuthorities":{"type":"array","items":{"$ref":"#/components/schemas/V1SandboxDeploymentsRuntimeProfilesGetResponsesContentApplicationJsonSchemaDataItemsCredentialAuthoritiesItems"}},"implementedCapabilities":{"type":"array","items":{"$ref":"#/components/schemas/V1SandboxDeploymentsRuntimeProfilesGetResponsesContentApplicationJsonSchemaDataItemsImplementedCapabilitiesItems"}},"languages":{"type":"array","items":{"$ref":"#/components/schemas/V1SandboxDeploymentsRuntimeProfilesGetResponsesContentApplicationJsonSchemaDataItemsLanguagesItems"}},"organizationEligibility":{"$ref":"#/components/schemas/V1SandboxDeploymentsRuntimeProfilesGetResponsesContentApplicationJsonSchemaDataItemsOrganizationEligibility"},"profile":{"$ref":"#/components/schemas/V1SandboxDeploymentsRuntimeProfilesGetResponsesContentApplicationJsonSchemaDataItemsProfile"},"runtimeProfileDigest":{"type":"string","pattern":"^[0-9a-f]{64}$"},"runtimeProfileId":{"type":"string"},"supportedNetworkAccess":{"type":"array","items":{"$ref":"#/components/schemas/V1SandboxDeploymentsRuntimeProfilesGetResponsesContentApplicationJsonSchemaDataItemsSupportedNetworkAccessItems"}},"verifiedCapabilities":{"type":"array","items":{"$ref":"#/components/schemas/V1SandboxDeploymentsRuntimeProfilesGetResponsesContentApplicationJsonSchemaDataItemsVerifiedCapabilitiesItems"}}},"required":["admission","credentialAuthorities","implementedCapabilities","languages","organizationEligibility","profile","runtimeProfileDigest","runtimeProfileId","supportedNetworkAccess","verifiedCapabilities"],"title":"V1SandboxDeploymentsRuntimeProfilesGetResponsesContentApplicationJsonSchemaDataItems"},"Sandbox_Deployments_listRetainedManagedDeploymentRuntimeProfiles_Response_200":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1SandboxDeploymentsRuntimeProfilesGetResponsesContentApplicationJsonSchemaDataItems"}}},"required":["data"],"title":"Sandbox Deployments_listRetainedManagedDeploymentRuntimeProfiles_Response_200"},"V1SandboxDeploymentsSourcesPostParametersEnvironment":{"type":"string","enum":["development","staging","production"],"title":"V1SandboxDeploymentsSourcesPostParametersEnvironment"},"V1SandboxDeploymentsSourcesPostParametersLanguage":{"type":"string","enum":["javascript","typescript","python"],"title":"V1SandboxDeploymentsSourcesPostParametersLanguage"},"V1SandboxDeploymentsSourcesPostResponsesContentApplicationJsonSchemaDependencyLock":{"type":"string","enum":["none","pnpm-lock","python-hashes"],"title":"V1SandboxDeploymentsSourcesPostResponsesContentApplicationJsonSchemaDependencyLock"},"V1SandboxDeploymentsSourcesPostResponsesContentApplicationJsonSchemaEnvironment":{"type":"string","enum":["development","staging","production"],"title":"V1SandboxDeploymentsSourcesPostResponsesContentApplicationJsonSchemaEnvironment"},"Sandbox_Deployments_uploadAManagedDeploymentSourceBundle_Response_201":{"type":"object","properties":{"compressedBytes":{"type":"integer"},"dependencyLock":{"$ref":"#/components/schemas/V1SandboxDeploymentsSourcesPostResponsesContentApplicationJsonSchemaDependencyLock"},"environment":{"$ref":"#/components/schemas/V1SandboxDeploymentsSourcesPostResponsesContentApplicationJsonSchemaEnvironment"},"expandedBytes":{"type":"integer"},"fileCount":{"type":"integer"},"reused":{"type":"boolean"},"sourceAssetId":{"type":"string"},"sourceHash":{"type":"string"}},"required":["compressedBytes","dependencyLock","environment","expandedBytes","fileCount","reused","sourceAssetId","sourceHash"],"title":"Sandbox Deployments_uploadAManagedDeploymentSourceBundle_Response_201"},"V1SandboxDeploymentsIdGetResponsesContentApplicationJsonSchemaCounters":{"type":"object","properties":{"desiredRevision":{"type":"integer","exclusiveMinimum":0},"observedRevision":{"type":["integer","null"],"exclusiveMinimum":0},"providerGeneration":{"type":"integer","minimum":0},"resourceVersion":{"type":"integer","minimum":0},"runtimeEpoch":{"type":"integer","minimum":0}},"required":["desiredRevision","observedRevision","providerGeneration","resourceVersion","runtimeEpoch"],"title":"V1SandboxDeploymentsIdGetResponsesContentApplicationJsonSchemaCounters"},"V1SandboxDeploymentsIdGetResponsesContentApplicationJsonSchemaDesiredState":{"type":"string","enum":["active","suspended","destroyed","expired"],"title":"V1SandboxDeploymentsIdGetResponsesContentApplicationJsonSchemaDesiredState"},"V1SandboxDeploymentsIdGetResponsesContentApplicationJsonSchemaEffectivePolicyAccess":{"type":"string","enum":["bearer","public"],"title":"V1SandboxDeploymentsIdGetResponsesContentApplicationJsonSchemaEffectivePolicyAccess"},"V1SandboxDeploymentsIdGetResponsesContentApplicationJsonSchemaEffectivePolicyAvailability":{"type":"string","enum":["on-demand","warm"],"title":"V1SandboxDeploymentsIdGetResponsesContentApplicationJsonSchemaEffectivePolicyAvailability"},"V1SandboxDeploymentsIdGetResponsesContentApplicationJsonSchemaEffectivePolicyNetworkAccess0":{"type":"string","enum":["none","essentials","open"],"title":"V1SandboxDeploymentsIdGetResponsesContentApplicationJsonSchemaEffectivePolicyNetworkAccess0"},"V1SandboxDeploymentsIdGetResponsesContentApplicationJsonSchemaEffectivePolicyNetworkAccessOneOf1Profile":{"type":"string","enum":["none","essentials","open"],"title":"V1SandboxDeploymentsIdGetResponsesContentApplicationJsonSchemaEffectivePolicyNetworkAccessOneOf1Profile"},"V1SandboxDeploymentsIdGetResponsesContentApplicationJsonSchemaEffectivePolicyNetworkAccess1":{"type":"object","properties":{"allow":{"type":"array","items":{"type":"string","pattern":"^(?:\\*\\.)?(?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?\\.)*[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$","minLength":1,"maxLength":253}},"profile":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdGetResponsesContentApplicationJsonSchemaEffectivePolicyNetworkAccessOneOf1Profile"}},"title":"V1SandboxDeploymentsIdGetResponsesContentApplicationJsonSchemaEffectivePolicyNetworkAccess1"},"V1SandboxDeploymentsIdGetResponsesContentApplicationJsonSchemaEffectivePolicyNetworkAccess":{"oneOf":[{"$ref":"#/components/schemas/V1SandboxDeploymentsIdGetResponsesContentApplicationJsonSchemaEffectivePolicyNetworkAccess0"},{"$ref":"#/components/schemas/V1SandboxDeploymentsIdGetResponsesContentApplicationJsonSchemaEffectivePolicyNetworkAccess1"}],"title":"V1SandboxDeploymentsIdGetResponsesContentApplicationJsonSchemaEffectivePolicyNetworkAccess"},"V1SandboxDeploymentsIdGetResponsesContentApplicationJsonSchemaEffectivePolicyRestartPolicy":{"type":"string","enum":["never","process","replace-sandbox"],"title":"V1SandboxDeploymentsIdGetResponsesContentApplicationJsonSchemaEffectivePolicyRestartPolicy"},"V1SandboxDeploymentsIdGetResponsesContentApplicationJsonSchemaEffectivePolicyRetention":{"type":"string","enum":["10m","1h","24h","unlimited"],"title":"V1SandboxDeploymentsIdGetResponsesContentApplicationJsonSchemaEffectivePolicyRetention"},"V1SandboxDeploymentsIdGetResponsesContentApplicationJsonSchemaEffectivePolicySleepPolicyOneOf0Mode":{"type":"string","enum":["never"],"title":"V1SandboxDeploymentsIdGetResponsesContentApplicationJsonSchemaEffectivePolicySleepPolicyOneOf0Mode"},"V1SandboxDeploymentsIdGetResponsesContentApplicationJsonSchemaEffectivePolicySleepPolicy0":{"type":"object","properties":{"mode":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdGetResponsesContentApplicationJsonSchemaEffectivePolicySleepPolicyOneOf0Mode"}},"required":["mode"],"title":"V1SandboxDeploymentsIdGetResponsesContentApplicationJsonSchemaEffectivePolicySleepPolicy0"},"V1SandboxDeploymentsIdGetResponsesContentApplicationJsonSchemaEffectivePolicySleepPolicyOneOf1After":{"type":"string","enum":["5m","15m","30m","1h"],"title":"V1SandboxDeploymentsIdGetResponsesContentApplicationJsonSchemaEffectivePolicySleepPolicyOneOf1After"},"V1SandboxDeploymentsIdGetResponsesContentApplicationJsonSchemaEffectivePolicySleepPolicyOneOf1Mode":{"type":"string","enum":["idle"],"title":"V1SandboxDeploymentsIdGetResponsesContentApplicationJsonSchemaEffectivePolicySleepPolicyOneOf1Mode"},"V1SandboxDeploymentsIdGetResponsesContentApplicationJsonSchemaEffectivePolicySleepPolicy1":{"type":"object","properties":{"after":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdGetResponsesContentApplicationJsonSchemaEffectivePolicySleepPolicyOneOf1After"},"mode":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdGetResponsesContentApplicationJsonSchemaEffectivePolicySleepPolicyOneOf1Mode"}},"required":["after","mode"],"title":"V1SandboxDeploymentsIdGetResponsesContentApplicationJsonSchemaEffectivePolicySleepPolicy1"},"V1SandboxDeploymentsIdGetResponsesContentApplicationJsonSchemaEffectivePolicySleepPolicy":{"oneOf":[{"$ref":"#/components/schemas/V1SandboxDeploymentsIdGetResponsesContentApplicationJsonSchemaEffectivePolicySleepPolicy0"},{"$ref":"#/components/schemas/V1SandboxDeploymentsIdGetResponsesContentApplicationJsonSchemaEffectivePolicySleepPolicy1"}],"title":"V1SandboxDeploymentsIdGetResponsesContentApplicationJsonSchemaEffectivePolicySleepPolicy"},"V1SandboxDeploymentsIdGetResponsesContentApplicationJsonSchemaEffectivePolicy":{"type":"object","properties":{"access":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdGetResponsesContentApplicationJsonSchemaEffectivePolicyAccess"},"availability":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdGetResponsesContentApplicationJsonSchemaEffectivePolicyAvailability"},"networkAccess":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdGetResponsesContentApplicationJsonSchemaEffectivePolicyNetworkAccess"},"restartPolicy":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdGetResponsesContentApplicationJsonSchemaEffectivePolicyRestartPolicy"},"retention":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdGetResponsesContentApplicationJsonSchemaEffectivePolicyRetention"},"sleepPolicy":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdGetResponsesContentApplicationJsonSchemaEffectivePolicySleepPolicy"}},"required":["access","availability","restartPolicy","retention","sleepPolicy"],"title":"V1SandboxDeploymentsIdGetResponsesContentApplicationJsonSchemaEffectivePolicy"},"V1SandboxDeploymentsIdGetResponsesContentApplicationJsonSchemaEnvironment":{"type":"string","enum":["development","staging","production"],"title":"V1SandboxDeploymentsIdGetResponsesContentApplicationJsonSchemaEnvironment"},"V1SandboxDeploymentsIdGetResponsesContentApplicationJsonSchemaProfileEnvironment":{"type":"string","enum":["development","staging","production"],"title":"V1SandboxDeploymentsIdGetResponsesContentApplicationJsonSchemaProfileEnvironment"},"V1SandboxDeploymentsIdGetResponsesContentApplicationJsonSchemaProfile":{"type":"object","properties":{"accountTier":{"type":"string","minLength":1,"maxLength":200},"environment":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdGetResponsesContentApplicationJsonSchemaProfileEnvironment"},"profileId":{"type":"string","minLength":1,"maxLength":200},"providerId":{"type":"string","minLength":1,"maxLength":200},"runtimeClass":{"type":"string","minLength":1,"maxLength":200},"sdkVersion":{"type":"string","minLength":1,"maxLength":200}},"required":["accountTier","environment","profileId","providerId","runtimeClass","sdkVersion"],"title":"V1SandboxDeploymentsIdGetResponsesContentApplicationJsonSchemaProfile"},"V1SandboxDeploymentsIdGetResponsesContentApplicationJsonSchemaStatus":{"type":"string","enum":["provisioning","running","sleeping","suspended","degraded","failed","blocked","destroying","destroyed","expired"],"title":"V1SandboxDeploymentsIdGetResponsesContentApplicationJsonSchemaStatus"},"Sandbox_Deployments_getAManagedSandboxDeployment_Response_200":{"type":"object","properties":{"activeOperationId":{"type":["string","null"]},"activeProviderInstanceId":{"type":["string","null"]},"counters":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdGetResponsesContentApplicationJsonSchemaCounters"},"createdAt":{"type":"string"},"createdByUserId":{"type":["string","null"]},"deploymentId":{"type":"string"},"desiredState":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdGetResponsesContentApplicationJsonSchemaDesiredState"},"displayName":{"type":["string","null"]},"effectivePolicy":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdGetResponsesContentApplicationJsonSchemaEffectivePolicy"},"environment":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdGetResponsesContentApplicationJsonSchemaEnvironment"},"expiresAt":{"type":["string","null"]},"ingressEnabled":{"type":"boolean"},"organizationId":{"type":"string"},"profile":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdGetResponsesContentApplicationJsonSchemaProfile"},"retentionAnchorAt":{"type":"string"},"specHash":{"type":"string"},"status":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdGetResponsesContentApplicationJsonSchemaStatus"},"statusReason":{"type":["string","null"]},"updatedAt":{"type":"string"},"url":{"type":["string","null"]}},"required":["activeOperationId","activeProviderInstanceId","counters","createdAt","createdByUserId","deploymentId","desiredState","displayName","effectivePolicy","environment","expiresAt","ingressEnabled","organizationId","profile","retentionAnchorAt","specHash","status","statusReason","updatedAt","url"],"title":"Sandbox Deployments_getAManagedSandboxDeployment_Response_200"},"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecAvailability":{"type":"string","enum":["on-demand","warm"],"title":"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecAvailability"},"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecCapabilitiesItems":{"type":"string","enum":["inspect-without-start","network-policy","private-ingress","process-adoption","rebuild","terminate:process-tree","terminate:sandbox-destroy","terminate:sandbox-stop","wake"],"title":"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecCapabilitiesItems"},"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecCredentialAuthorityOneOf0Kind":{"type":"string","enum":["organization-connection"],"title":"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecCredentialAuthorityOneOf0Kind"},"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecCredentialAuthority0":{"type":"object","properties":{"connectionId":{"type":"string","minLength":1,"maxLength":200},"kind":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecCredentialAuthorityOneOf0Kind"}},"required":["connectionId","kind"],"title":"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecCredentialAuthority0"},"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecCredentialAuthorityOneOf1Kind":{"type":"string","enum":["platform-managed"],"title":"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecCredentialAuthorityOneOf1Kind"},"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecCredentialAuthority1":{"type":"object","properties":{"kind":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecCredentialAuthorityOneOf1Kind"},"providerPolicyId":{"type":"string","minLength":1,"maxLength":200}},"required":["kind","providerPolicyId"],"title":"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecCredentialAuthority1"},"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecCredentialAuthority":{"oneOf":[{"$ref":"#/components/schemas/V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecCredentialAuthority0"},{"$ref":"#/components/schemas/V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecCredentialAuthority1"}],"title":"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecCredentialAuthority"},"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecHealthOneOf0Kind":{"type":"string","enum":["tcp"],"title":"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecHealthOneOf0Kind"},"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecHealth0":{"type":"object","properties":{"kind":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecHealthOneOf0Kind"}},"required":["kind"],"title":"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecHealth0"},"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecHealthOneOf1Kind":{"type":"string","enum":["http"],"title":"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecHealthOneOf1Kind"},"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecHealth1":{"type":"object","properties":{"expectedStatus":{"type":"integer","minimum":100,"maximum":599},"kind":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecHealthOneOf1Kind"},"path":{"type":"string","minLength":1,"maxLength":512}},"required":["expectedStatus","kind","path"],"title":"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecHealth1"},"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecHealth":{"oneOf":[{"$ref":"#/components/schemas/V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecHealth0"},{"$ref":"#/components/schemas/V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecHealth1"}],"title":"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecHealth"},"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecIngressAccess":{"type":"string","enum":["bearer","public"],"title":"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecIngressAccess"},"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecIngress":{"type":"object","properties":{"access":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecIngressAccess"},"allowedOrigins":{"type":"array","items":{"type":"string","minLength":1,"maxLength":255},"default":[]}},"required":["access"],"title":"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecIngress"},"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecLanguage":{"type":"string","enum":["javascript","typescript","python"],"title":"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecLanguage"},"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecNetworkAccess0":{"type":"string","enum":["none","essentials","open"],"title":"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecNetworkAccess0"},"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecNetworkAccessOneOf1Profile":{"type":"string","enum":["none","essentials","open"],"title":"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecNetworkAccessOneOf1Profile"},"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecNetworkAccess1":{"type":"object","properties":{"allow":{"type":"array","items":{"type":"string","pattern":"^(?:\\*\\.)?(?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?\\.)*[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$","minLength":1,"maxLength":253}},"profile":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecNetworkAccessOneOf1Profile"}},"title":"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecNetworkAccess1"},"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecNetworkAccess":{"oneOf":[{"$ref":"#/components/schemas/V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecNetworkAccess0"},{"$ref":"#/components/schemas/V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecNetworkAccess1"}],"title":"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecNetworkAccess"},"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecProfileEnvironment":{"type":"string","enum":["development","staging","production"],"title":"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecProfileEnvironment"},"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecProfile":{"type":"object","properties":{"accountTier":{"type":"string","minLength":1,"maxLength":200},"environment":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecProfileEnvironment"},"profileId":{"type":"string","minLength":1,"maxLength":200},"providerId":{"type":"string","minLength":1,"maxLength":200},"runtimeClass":{"type":"string","minLength":1,"maxLength":200},"sdkVersion":{"type":"string","minLength":1,"maxLength":200}},"required":["accountTier","environment","profileId","providerId","runtimeClass","sdkVersion"],"title":"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecProfile"},"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecRestartPolicy":{"type":"string","enum":["never","process","replace-sandbox"],"title":"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecRestartPolicy"},"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecRetention":{"type":"string","enum":["10m","1h","24h","unlimited"],"title":"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecRetention"},"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecRuntimeProfile":{"type":"object","properties":{"runtimeProfileDigest":{"type":"string","pattern":"^[0-9a-f]{64}$"},"runtimeProfileId":{"type":"string","minLength":1,"maxLength":200}},"required":["runtimeProfileDigest","runtimeProfileId"],"title":"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecRuntimeProfile"},"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecSleepPolicyOneOf0Mode":{"type":"string","enum":["never"],"title":"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecSleepPolicyOneOf0Mode"},"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecSleepPolicy0":{"type":"object","properties":{"mode":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecSleepPolicyOneOf0Mode"}},"required":["mode"],"title":"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecSleepPolicy0"},"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecSleepPolicyOneOf1After":{"type":"string","enum":["5m","15m","30m","1h"],"title":"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecSleepPolicyOneOf1After"},"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecSleepPolicyOneOf1Mode":{"type":"string","enum":["idle"],"title":"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecSleepPolicyOneOf1Mode"},"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecSleepPolicy1":{"type":"object","properties":{"after":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecSleepPolicyOneOf1After"},"mode":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecSleepPolicyOneOf1Mode"}},"required":["after","mode"],"title":"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecSleepPolicy1"},"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecSleepPolicy":{"oneOf":[{"$ref":"#/components/schemas/V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecSleepPolicy0"},{"$ref":"#/components/schemas/V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecSleepPolicy1"}],"title":"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecSleepPolicy"},"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecSource":{"type":"object","properties":{"sourceAssetId":{"type":"string","minLength":1,"maxLength":200},"sourceHash":{"type":"string","pattern":"^[0-9a-f]{64}$"}},"required":["sourceAssetId","sourceHash"],"title":"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecSource"},"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0Spec":{"type":"object","properties":{"availability":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecAvailability"},"capabilities":{"type":"array","items":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecCapabilitiesItems"}},"credentialAuthority":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecCredentialAuthority"},"health":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecHealth"},"ingress":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecIngress"},"language":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecLanguage"},"networkAccess":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecNetworkAccess"},"networkPolicyRef":{"type":"string","minLength":1,"maxLength":200},"port":{"type":"integer","minimum":1,"maximum":65535},"profile":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecProfile"},"restartPolicy":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecRestartPolicy"},"retention":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecRetention"},"runtimeProfile":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecRuntimeProfile"},"secretBindings":{"type":"object","additionalProperties":{"type":"string","minLength":1,"maxLength":200},"default":{}},"sleepPolicy":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecSleepPolicy"},"source":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0SpecSource"},"startCommand":{"type":"string","minLength":1,"maxLength":2000}},"required":["availability","capabilities","credentialAuthority","health","ingress","language","networkPolicyRef","port","profile","restartPolicy","retention","runtimeProfile","sleepPolicy","source","startCommand"],"title":"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0Spec"},"SandboxDeploymentsReplaceAManagedSandboxDeploymentSpecRequest0":{"type":"object","properties":{"displayName":{"type":"string","minLength":1,"maxLength":200},"spec":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf0Spec"}},"required":["spec"],"title":"SandboxDeploymentsReplaceAManagedSandboxDeploymentSpecRequest0"},"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf1ConfigCredentialAuthorityOneOf0Kind":{"type":"string","enum":["organization-connection"],"title":"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf1ConfigCredentialAuthorityOneOf0Kind"},"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf1ConfigCredentialAuthority0":{"type":"object","properties":{"connectionId":{"type":"string","minLength":1,"maxLength":200},"kind":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf1ConfigCredentialAuthorityOneOf0Kind"}},"required":["connectionId","kind"],"title":"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf1ConfigCredentialAuthority0"},"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf1ConfigCredentialAuthorityOneOf1Kind":{"type":"string","enum":["platform-managed"],"title":"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf1ConfigCredentialAuthorityOneOf1Kind"},"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf1ConfigCredentialAuthority1":{"type":"object","properties":{"kind":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf1ConfigCredentialAuthorityOneOf1Kind"},"providerPolicyId":{"type":"string","minLength":1,"maxLength":200}},"required":["kind","providerPolicyId"],"title":"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf1ConfigCredentialAuthority1"},"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf1ConfigCredentialAuthority":{"oneOf":[{"$ref":"#/components/schemas/V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf1ConfigCredentialAuthority0"},{"$ref":"#/components/schemas/V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf1ConfigCredentialAuthority1"}],"title":"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf1ConfigCredentialAuthority"},"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf1ConfigHealthOneOf0Kind":{"type":"string","enum":["tcp"],"title":"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf1ConfigHealthOneOf0Kind"},"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf1ConfigHealth0":{"type":"object","properties":{"kind":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf1ConfigHealthOneOf0Kind"}},"required":["kind"],"title":"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf1ConfigHealth0"},"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf1ConfigHealthOneOf1Kind":{"type":"string","enum":["http"],"title":"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf1ConfigHealthOneOf1Kind"},"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf1ConfigHealth1":{"type":"object","properties":{"expectedStatus":{"type":"integer","minimum":100,"maximum":599},"kind":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf1ConfigHealthOneOf1Kind"},"path":{"type":"string","minLength":1,"maxLength":512}},"required":["expectedStatus","kind","path"],"title":"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf1ConfigHealth1"},"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf1ConfigHealth":{"oneOf":[{"$ref":"#/components/schemas/V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf1ConfigHealth0"},{"$ref":"#/components/schemas/V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf1ConfigHealth1"}],"title":"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf1ConfigHealth"},"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf1ConfigIngressAccess":{"type":"string","enum":["bearer","public"],"title":"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf1ConfigIngressAccess"},"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf1ConfigIngress":{"type":"object","properties":{"access":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf1ConfigIngressAccess"},"allowedOrigins":{"type":"array","items":{"type":"string","minLength":1,"maxLength":255}}},"required":["access"],"title":"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf1ConfigIngress"},"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf1ConfigLanguage":{"type":"string","enum":["javascript","typescript","python"],"title":"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf1ConfigLanguage"},"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf1ConfigNetworkAccess0":{"type":"string","enum":["none","essentials","open"],"title":"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf1ConfigNetworkAccess0"},"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf1ConfigNetworkAccessOneOf1Profile":{"type":"string","enum":["none","essentials"],"title":"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf1ConfigNetworkAccessOneOf1Profile"},"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf1ConfigNetworkAccess1":{"type":"object","properties":{"allow":{"type":"array","items":{"type":"string","pattern":"^(?:\\*\\.)?(?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?\\.)*[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$","minLength":1,"maxLength":253}},"profile":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf1ConfigNetworkAccessOneOf1Profile"}},"required":["allow","profile"],"title":"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf1ConfigNetworkAccess1"},"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf1ConfigNetworkAccess":{"oneOf":[{"$ref":"#/components/schemas/V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf1ConfigNetworkAccess0"},{"$ref":"#/components/schemas/V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf1ConfigNetworkAccess1"}],"title":"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf1ConfigNetworkAccess"},"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf1ConfigRestartPolicy":{"type":"string","enum":["never","replace-sandbox"],"title":"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf1ConfigRestartPolicy"},"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf1ConfigRetention":{"type":"string","enum":["10m","1h","24h","unlimited"],"title":"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf1ConfigRetention"},"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf1ConfigSleepPolicyOneOf0Mode":{"type":"string","enum":["never"],"title":"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf1ConfigSleepPolicyOneOf0Mode"},"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf1ConfigSleepPolicy0":{"type":"object","properties":{"mode":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf1ConfigSleepPolicyOneOf0Mode"}},"required":["mode"],"title":"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf1ConfigSleepPolicy0"},"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf1ConfigSleepPolicyOneOf1After":{"type":"string","enum":["5m","15m","30m","1h"],"title":"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf1ConfigSleepPolicyOneOf1After"},"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf1ConfigSleepPolicyOneOf1Mode":{"type":"string","enum":["idle"],"title":"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf1ConfigSleepPolicyOneOf1Mode"},"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf1ConfigSleepPolicy1":{"type":"object","properties":{"after":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf1ConfigSleepPolicyOneOf1After"},"mode":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf1ConfigSleepPolicyOneOf1Mode"}},"required":["after","mode"],"title":"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf1ConfigSleepPolicy1"},"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf1ConfigSleepPolicy":{"oneOf":[{"$ref":"#/components/schemas/V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf1ConfigSleepPolicy0"},{"$ref":"#/components/schemas/V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf1ConfigSleepPolicy1"}],"title":"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf1ConfigSleepPolicy"},"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf1Config":{"type":"object","properties":{"credentialAuthority":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf1ConfigCredentialAuthority"},"health":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf1ConfigHealth"},"ingress":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf1ConfigIngress"},"language":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf1ConfigLanguage"},"networkAccess":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf1ConfigNetworkAccess"},"port":{"type":"integer","minimum":1,"maximum":65535},"restartPolicy":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf1ConfigRestartPolicy"},"retention":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf1ConfigRetention"},"runtimeProfileId":{"type":"string","minLength":1,"maxLength":200},"secretBindings":{"type":"object","additionalProperties":{"type":"string","minLength":1,"maxLength":200}},"sleepPolicy":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf1ConfigSleepPolicy"},"sourceAssetId":{"type":"string","minLength":1,"maxLength":200},"startCommand":{"type":"string","minLength":1,"maxLength":2000}},"required":["credentialAuthority","language","port","retention","runtimeProfileId","sourceAssetId","startCommand"],"title":"V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf1Config"},"SandboxDeploymentsReplaceAManagedSandboxDeploymentSpecRequest1":{"type":"object","properties":{"config":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdPutRequestBodyContentApplicationJsonSchemaOneOf1Config"},"displayName":{"type":"string","minLength":1,"maxLength":200}},"required":["config"],"title":"SandboxDeploymentsReplaceAManagedSandboxDeploymentSpecRequest1"},"Sandbox_Deployments_replaceAManagedSandboxDeploymentSpec_Request":{"oneOf":[{"$ref":"#/components/schemas/SandboxDeploymentsReplaceAManagedSandboxDeploymentSpecRequest0"},{"$ref":"#/components/schemas/SandboxDeploymentsReplaceAManagedSandboxDeploymentSpecRequest1"}],"title":"Sandbox Deployments_replaceAManagedSandboxDeploymentSpec_Request"},"V1SandboxDeploymentsIdPutResponsesContentApplicationJsonSchemaDeploymentCounters":{"type":"object","properties":{"desiredRevision":{"type":"integer","exclusiveMinimum":0},"observedRevision":{"type":["integer","null"],"exclusiveMinimum":0},"providerGeneration":{"type":"integer","minimum":0},"resourceVersion":{"type":"integer","minimum":0},"runtimeEpoch":{"type":"integer","minimum":0}},"required":["desiredRevision","observedRevision","providerGeneration","resourceVersion","runtimeEpoch"],"title":"V1SandboxDeploymentsIdPutResponsesContentApplicationJsonSchemaDeploymentCounters"},"V1SandboxDeploymentsIdPutResponsesContentApplicationJsonSchemaDeploymentDesiredState":{"type":"string","enum":["active","suspended","destroyed","expired"],"title":"V1SandboxDeploymentsIdPutResponsesContentApplicationJsonSchemaDeploymentDesiredState"},"V1SandboxDeploymentsIdPutResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyAccess":{"type":"string","enum":["bearer","public"],"title":"V1SandboxDeploymentsIdPutResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyAccess"},"V1SandboxDeploymentsIdPutResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyAvailability":{"type":"string","enum":["on-demand","warm"],"title":"V1SandboxDeploymentsIdPutResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyAvailability"},"V1SandboxDeploymentsIdPutResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyNetworkAccess0":{"type":"string","enum":["none","essentials","open"],"title":"V1SandboxDeploymentsIdPutResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyNetworkAccess0"},"V1SandboxDeploymentsIdPutResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyNetworkAccessOneOf1Profile":{"type":"string","enum":["none","essentials","open"],"title":"V1SandboxDeploymentsIdPutResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyNetworkAccessOneOf1Profile"},"V1SandboxDeploymentsIdPutResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyNetworkAccess1":{"type":"object","properties":{"allow":{"type":"array","items":{"type":"string","pattern":"^(?:\\*\\.)?(?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?\\.)*[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$","minLength":1,"maxLength":253}},"profile":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdPutResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyNetworkAccessOneOf1Profile"}},"title":"V1SandboxDeploymentsIdPutResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyNetworkAccess1"},"V1SandboxDeploymentsIdPutResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyNetworkAccess":{"oneOf":[{"$ref":"#/components/schemas/V1SandboxDeploymentsIdPutResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyNetworkAccess0"},{"$ref":"#/components/schemas/V1SandboxDeploymentsIdPutResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyNetworkAccess1"}],"title":"V1SandboxDeploymentsIdPutResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyNetworkAccess"},"V1SandboxDeploymentsIdPutResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyRestartPolicy":{"type":"string","enum":["never","process","replace-sandbox"],"title":"V1SandboxDeploymentsIdPutResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyRestartPolicy"},"V1SandboxDeploymentsIdPutResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyRetention":{"type":"string","enum":["10m","1h","24h","unlimited"],"title":"V1SandboxDeploymentsIdPutResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyRetention"},"V1SandboxDeploymentsIdPutResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicyOneOf0Mode":{"type":"string","enum":["never"],"title":"V1SandboxDeploymentsIdPutResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicyOneOf0Mode"},"V1SandboxDeploymentsIdPutResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicy0":{"type":"object","properties":{"mode":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdPutResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicyOneOf0Mode"}},"required":["mode"],"title":"V1SandboxDeploymentsIdPutResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicy0"},"V1SandboxDeploymentsIdPutResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicyOneOf1After":{"type":"string","enum":["5m","15m","30m","1h"],"title":"V1SandboxDeploymentsIdPutResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicyOneOf1After"},"V1SandboxDeploymentsIdPutResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicyOneOf1Mode":{"type":"string","enum":["idle"],"title":"V1SandboxDeploymentsIdPutResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicyOneOf1Mode"},"V1SandboxDeploymentsIdPutResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicy1":{"type":"object","properties":{"after":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdPutResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicyOneOf1After"},"mode":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdPutResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicyOneOf1Mode"}},"required":["after","mode"],"title":"V1SandboxDeploymentsIdPutResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicy1"},"V1SandboxDeploymentsIdPutResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicy":{"oneOf":[{"$ref":"#/components/schemas/V1SandboxDeploymentsIdPutResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicy0"},{"$ref":"#/components/schemas/V1SandboxDeploymentsIdPutResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicy1"}],"title":"V1SandboxDeploymentsIdPutResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicy"},"V1SandboxDeploymentsIdPutResponsesContentApplicationJsonSchemaDeploymentEffectivePolicy":{"type":"object","properties":{"access":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdPutResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyAccess"},"availability":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdPutResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyAvailability"},"networkAccess":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdPutResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyNetworkAccess"},"restartPolicy":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdPutResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyRestartPolicy"},"retention":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdPutResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyRetention"},"sleepPolicy":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdPutResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicy"}},"required":["access","availability","restartPolicy","retention","sleepPolicy"],"title":"V1SandboxDeploymentsIdPutResponsesContentApplicationJsonSchemaDeploymentEffectivePolicy"},"V1SandboxDeploymentsIdPutResponsesContentApplicationJsonSchemaDeploymentEnvironment":{"type":"string","enum":["development","staging","production"],"title":"V1SandboxDeploymentsIdPutResponsesContentApplicationJsonSchemaDeploymentEnvironment"},"V1SandboxDeploymentsIdPutResponsesContentApplicationJsonSchemaDeploymentProfileEnvironment":{"type":"string","enum":["development","staging","production"],"title":"V1SandboxDeploymentsIdPutResponsesContentApplicationJsonSchemaDeploymentProfileEnvironment"},"V1SandboxDeploymentsIdPutResponsesContentApplicationJsonSchemaDeploymentProfile":{"type":"object","properties":{"accountTier":{"type":"string","minLength":1,"maxLength":200},"environment":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdPutResponsesContentApplicationJsonSchemaDeploymentProfileEnvironment"},"profileId":{"type":"string","minLength":1,"maxLength":200},"providerId":{"type":"string","minLength":1,"maxLength":200},"runtimeClass":{"type":"string","minLength":1,"maxLength":200},"sdkVersion":{"type":"string","minLength":1,"maxLength":200}},"required":["accountTier","environment","profileId","providerId","runtimeClass","sdkVersion"],"title":"V1SandboxDeploymentsIdPutResponsesContentApplicationJsonSchemaDeploymentProfile"},"V1SandboxDeploymentsIdPutResponsesContentApplicationJsonSchemaDeploymentStatus":{"type":"string","enum":["provisioning","running","sleeping","suspended","degraded","failed","blocked","destroying","destroyed","expired"],"title":"V1SandboxDeploymentsIdPutResponsesContentApplicationJsonSchemaDeploymentStatus"},"V1SandboxDeploymentsIdPutResponsesContentApplicationJsonSchemaDeployment":{"type":"object","properties":{"activeOperationId":{"type":["string","null"]},"activeProviderInstanceId":{"type":["string","null"]},"counters":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdPutResponsesContentApplicationJsonSchemaDeploymentCounters"},"createdAt":{"type":"string"},"createdByUserId":{"type":["string","null"]},"deploymentId":{"type":"string"},"desiredState":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdPutResponsesContentApplicationJsonSchemaDeploymentDesiredState"},"displayName":{"type":["string","null"]},"effectivePolicy":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdPutResponsesContentApplicationJsonSchemaDeploymentEffectivePolicy"},"environment":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdPutResponsesContentApplicationJsonSchemaDeploymentEnvironment"},"expiresAt":{"type":["string","null"]},"ingressEnabled":{"type":"boolean"},"organizationId":{"type":"string"},"profile":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdPutResponsesContentApplicationJsonSchemaDeploymentProfile"},"retentionAnchorAt":{"type":"string"},"specHash":{"type":"string"},"status":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdPutResponsesContentApplicationJsonSchemaDeploymentStatus"},"statusReason":{"type":["string","null"]},"updatedAt":{"type":"string"},"url":{"type":["string","null"]}},"required":["activeOperationId","activeProviderInstanceId","counters","createdAt","createdByUserId","deploymentId","desiredState","displayName","effectivePolicy","environment","expiresAt","ingressEnabled","organizationId","profile","retentionAnchorAt","specHash","status","statusReason","updatedAt","url"],"title":"V1SandboxDeploymentsIdPutResponsesContentApplicationJsonSchemaDeployment"},"Sandbox_Deployments_replaceAManagedSandboxDeploymentSpec_Response_200":{"type":"object","properties":{"deployment":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdPutResponsesContentApplicationJsonSchemaDeployment"},"operationId":{"type":["string","null"]}},"required":["deployment","operationId"],"title":"Sandbox Deployments_replaceAManagedSandboxDeploymentSpec_Response_200"},"V1SandboxDeploymentsIdDeleteResponsesContentApplicationJsonSchemaDeploymentCounters":{"type":"object","properties":{"desiredRevision":{"type":"integer","exclusiveMinimum":0},"observedRevision":{"type":["integer","null"],"exclusiveMinimum":0},"providerGeneration":{"type":"integer","minimum":0},"resourceVersion":{"type":"integer","minimum":0},"runtimeEpoch":{"type":"integer","minimum":0}},"required":["desiredRevision","observedRevision","providerGeneration","resourceVersion","runtimeEpoch"],"title":"V1SandboxDeploymentsIdDeleteResponsesContentApplicationJsonSchemaDeploymentCounters"},"V1SandboxDeploymentsIdDeleteResponsesContentApplicationJsonSchemaDeploymentDesiredState":{"type":"string","enum":["active","suspended","destroyed","expired"],"title":"V1SandboxDeploymentsIdDeleteResponsesContentApplicationJsonSchemaDeploymentDesiredState"},"V1SandboxDeploymentsIdDeleteResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyAccess":{"type":"string","enum":["bearer","public"],"title":"V1SandboxDeploymentsIdDeleteResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyAccess"},"V1SandboxDeploymentsIdDeleteResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyAvailability":{"type":"string","enum":["on-demand","warm"],"title":"V1SandboxDeploymentsIdDeleteResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyAvailability"},"V1SandboxDeploymentsIdDeleteResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyNetworkAccess0":{"type":"string","enum":["none","essentials","open"],"title":"V1SandboxDeploymentsIdDeleteResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyNetworkAccess0"},"V1SandboxDeploymentsIdDeleteResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyNetworkAccessOneOf1Profile":{"type":"string","enum":["none","essentials","open"],"title":"V1SandboxDeploymentsIdDeleteResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyNetworkAccessOneOf1Profile"},"V1SandboxDeploymentsIdDeleteResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyNetworkAccess1":{"type":"object","properties":{"allow":{"type":"array","items":{"type":"string","pattern":"^(?:\\*\\.)?(?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?\\.)*[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$","minLength":1,"maxLength":253}},"profile":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdDeleteResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyNetworkAccessOneOf1Profile"}},"title":"V1SandboxDeploymentsIdDeleteResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyNetworkAccess1"},"V1SandboxDeploymentsIdDeleteResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyNetworkAccess":{"oneOf":[{"$ref":"#/components/schemas/V1SandboxDeploymentsIdDeleteResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyNetworkAccess0"},{"$ref":"#/components/schemas/V1SandboxDeploymentsIdDeleteResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyNetworkAccess1"}],"title":"V1SandboxDeploymentsIdDeleteResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyNetworkAccess"},"V1SandboxDeploymentsIdDeleteResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyRestartPolicy":{"type":"string","enum":["never","process","replace-sandbox"],"title":"V1SandboxDeploymentsIdDeleteResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyRestartPolicy"},"V1SandboxDeploymentsIdDeleteResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyRetention":{"type":"string","enum":["10m","1h","24h","unlimited"],"title":"V1SandboxDeploymentsIdDeleteResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyRetention"},"V1SandboxDeploymentsIdDeleteResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicyOneOf0Mode":{"type":"string","enum":["never"],"title":"V1SandboxDeploymentsIdDeleteResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicyOneOf0Mode"},"V1SandboxDeploymentsIdDeleteResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicy0":{"type":"object","properties":{"mode":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdDeleteResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicyOneOf0Mode"}},"required":["mode"],"title":"V1SandboxDeploymentsIdDeleteResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicy0"},"V1SandboxDeploymentsIdDeleteResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicyOneOf1After":{"type":"string","enum":["5m","15m","30m","1h"],"title":"V1SandboxDeploymentsIdDeleteResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicyOneOf1After"},"V1SandboxDeploymentsIdDeleteResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicyOneOf1Mode":{"type":"string","enum":["idle"],"title":"V1SandboxDeploymentsIdDeleteResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicyOneOf1Mode"},"V1SandboxDeploymentsIdDeleteResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicy1":{"type":"object","properties":{"after":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdDeleteResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicyOneOf1After"},"mode":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdDeleteResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicyOneOf1Mode"}},"required":["after","mode"],"title":"V1SandboxDeploymentsIdDeleteResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicy1"},"V1SandboxDeploymentsIdDeleteResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicy":{"oneOf":[{"$ref":"#/components/schemas/V1SandboxDeploymentsIdDeleteResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicy0"},{"$ref":"#/components/schemas/V1SandboxDeploymentsIdDeleteResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicy1"}],"title":"V1SandboxDeploymentsIdDeleteResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicy"},"V1SandboxDeploymentsIdDeleteResponsesContentApplicationJsonSchemaDeploymentEffectivePolicy":{"type":"object","properties":{"access":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdDeleteResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyAccess"},"availability":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdDeleteResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyAvailability"},"networkAccess":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdDeleteResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyNetworkAccess"},"restartPolicy":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdDeleteResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyRestartPolicy"},"retention":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdDeleteResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyRetention"},"sleepPolicy":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdDeleteResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicy"}},"required":["access","availability","restartPolicy","retention","sleepPolicy"],"title":"V1SandboxDeploymentsIdDeleteResponsesContentApplicationJsonSchemaDeploymentEffectivePolicy"},"V1SandboxDeploymentsIdDeleteResponsesContentApplicationJsonSchemaDeploymentEnvironment":{"type":"string","enum":["development","staging","production"],"title":"V1SandboxDeploymentsIdDeleteResponsesContentApplicationJsonSchemaDeploymentEnvironment"},"V1SandboxDeploymentsIdDeleteResponsesContentApplicationJsonSchemaDeploymentProfileEnvironment":{"type":"string","enum":["development","staging","production"],"title":"V1SandboxDeploymentsIdDeleteResponsesContentApplicationJsonSchemaDeploymentProfileEnvironment"},"V1SandboxDeploymentsIdDeleteResponsesContentApplicationJsonSchemaDeploymentProfile":{"type":"object","properties":{"accountTier":{"type":"string","minLength":1,"maxLength":200},"environment":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdDeleteResponsesContentApplicationJsonSchemaDeploymentProfileEnvironment"},"profileId":{"type":"string","minLength":1,"maxLength":200},"providerId":{"type":"string","minLength":1,"maxLength":200},"runtimeClass":{"type":"string","minLength":1,"maxLength":200},"sdkVersion":{"type":"string","minLength":1,"maxLength":200}},"required":["accountTier","environment","profileId","providerId","runtimeClass","sdkVersion"],"title":"V1SandboxDeploymentsIdDeleteResponsesContentApplicationJsonSchemaDeploymentProfile"},"V1SandboxDeploymentsIdDeleteResponsesContentApplicationJsonSchemaDeploymentStatus":{"type":"string","enum":["provisioning","running","sleeping","suspended","degraded","failed","blocked","destroying","destroyed","expired"],"title":"V1SandboxDeploymentsIdDeleteResponsesContentApplicationJsonSchemaDeploymentStatus"},"V1SandboxDeploymentsIdDeleteResponsesContentApplicationJsonSchemaDeployment":{"type":"object","properties":{"activeOperationId":{"type":["string","null"]},"activeProviderInstanceId":{"type":["string","null"]},"counters":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdDeleteResponsesContentApplicationJsonSchemaDeploymentCounters"},"createdAt":{"type":"string"},"createdByUserId":{"type":["string","null"]},"deploymentId":{"type":"string"},"desiredState":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdDeleteResponsesContentApplicationJsonSchemaDeploymentDesiredState"},"displayName":{"type":["string","null"]},"effectivePolicy":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdDeleteResponsesContentApplicationJsonSchemaDeploymentEffectivePolicy"},"environment":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdDeleteResponsesContentApplicationJsonSchemaDeploymentEnvironment"},"expiresAt":{"type":["string","null"]},"ingressEnabled":{"type":"boolean"},"organizationId":{"type":"string"},"profile":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdDeleteResponsesContentApplicationJsonSchemaDeploymentProfile"},"retentionAnchorAt":{"type":"string"},"specHash":{"type":"string"},"status":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdDeleteResponsesContentApplicationJsonSchemaDeploymentStatus"},"statusReason":{"type":["string","null"]},"updatedAt":{"type":"string"},"url":{"type":["string","null"]}},"required":["activeOperationId","activeProviderInstanceId","counters","createdAt","createdByUserId","deploymentId","desiredState","displayName","effectivePolicy","environment","expiresAt","ingressEnabled","organizationId","profile","retentionAnchorAt","specHash","status","statusReason","updatedAt","url"],"title":"V1SandboxDeploymentsIdDeleteResponsesContentApplicationJsonSchemaDeployment"},"Sandbox_Deployments_destroyAManagedSandboxDeployment_Response_202":{"type":"object","properties":{"deployment":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdDeleteResponsesContentApplicationJsonSchemaDeployment"},"operationId":{"type":["string","null"]}},"required":["deployment","operationId"],"title":"Sandbox Deployments_destroyAManagedSandboxDeployment_Response_202"},"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaConfigCredentialAuthorityOneOf0Kind":{"type":"string","enum":["organization-connection"],"title":"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaConfigCredentialAuthorityOneOf0Kind"},"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaConfigCredentialAuthority0":{"type":"object","properties":{"connectionId":{"type":"string","minLength":1,"maxLength":200},"kind":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaConfigCredentialAuthorityOneOf0Kind"}},"required":["connectionId","kind"],"title":"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaConfigCredentialAuthority0"},"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaConfigCredentialAuthorityOneOf1Kind":{"type":"string","enum":["platform-managed"],"title":"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaConfigCredentialAuthorityOneOf1Kind"},"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaConfigCredentialAuthority1":{"type":"object","properties":{"kind":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaConfigCredentialAuthorityOneOf1Kind"},"providerPolicyId":{"type":"string","minLength":1,"maxLength":200}},"required":["kind","providerPolicyId"],"title":"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaConfigCredentialAuthority1"},"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaConfigCredentialAuthority":{"oneOf":[{"$ref":"#/components/schemas/V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaConfigCredentialAuthority0"},{"$ref":"#/components/schemas/V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaConfigCredentialAuthority1"}],"title":"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaConfigCredentialAuthority"},"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaConfigHealthOneOf0Kind":{"type":"string","enum":["tcp"],"title":"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaConfigHealthOneOf0Kind"},"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaConfigHealth0":{"type":"object","properties":{"kind":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaConfigHealthOneOf0Kind"}},"required":["kind"],"title":"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaConfigHealth0"},"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaConfigHealthOneOf1Kind":{"type":"string","enum":["http"],"title":"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaConfigHealthOneOf1Kind"},"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaConfigHealth1":{"type":"object","properties":{"expectedStatus":{"type":"integer","minimum":100,"maximum":599},"kind":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaConfigHealthOneOf1Kind"},"path":{"type":"string","minLength":1,"maxLength":512}},"required":["expectedStatus","kind","path"],"title":"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaConfigHealth1"},"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaConfigHealth":{"oneOf":[{"$ref":"#/components/schemas/V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaConfigHealth0"},{"$ref":"#/components/schemas/V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaConfigHealth1"}],"title":"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaConfigHealth"},"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaConfigIngressAccess":{"type":"string","enum":["bearer","public"],"title":"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaConfigIngressAccess"},"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaConfigIngress":{"type":"object","properties":{"access":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaConfigIngressAccess"},"allowedOrigins":{"type":"array","items":{"type":"string","minLength":1,"maxLength":255}}},"required":["access"],"title":"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaConfigIngress"},"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaConfigLanguage":{"type":"string","enum":["javascript","typescript","python"],"title":"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaConfigLanguage"},"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaConfigNetworkAccess0":{"type":"string","enum":["none","essentials","open"],"title":"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaConfigNetworkAccess0"},"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaConfigNetworkAccessOneOf1Profile":{"type":"string","enum":["none","essentials"],"title":"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaConfigNetworkAccessOneOf1Profile"},"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaConfigNetworkAccess1":{"type":"object","properties":{"allow":{"type":"array","items":{"type":"string","pattern":"^(?:\\*\\.)?(?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?\\.)*[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$","minLength":1,"maxLength":253}},"profile":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaConfigNetworkAccessOneOf1Profile"}},"required":["allow","profile"],"title":"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaConfigNetworkAccess1"},"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaConfigNetworkAccess":{"oneOf":[{"$ref":"#/components/schemas/V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaConfigNetworkAccess0"},{"$ref":"#/components/schemas/V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaConfigNetworkAccess1"}],"title":"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaConfigNetworkAccess"},"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaConfigRestartPolicy":{"type":"string","enum":["never","replace-sandbox"],"title":"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaConfigRestartPolicy"},"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaConfigRetention":{"type":"string","enum":["10m","1h","24h","unlimited"],"title":"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaConfigRetention"},"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaConfigSleepPolicyOneOf0Mode":{"type":"string","enum":["never"],"title":"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaConfigSleepPolicyOneOf0Mode"},"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaConfigSleepPolicy0":{"type":"object","properties":{"mode":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaConfigSleepPolicyOneOf0Mode"}},"required":["mode"],"title":"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaConfigSleepPolicy0"},"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaConfigSleepPolicyOneOf1After":{"type":"string","enum":["5m","15m","30m","1h"],"title":"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaConfigSleepPolicyOneOf1After"},"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaConfigSleepPolicyOneOf1Mode":{"type":"string","enum":["idle"],"title":"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaConfigSleepPolicyOneOf1Mode"},"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaConfigSleepPolicy1":{"type":"object","properties":{"after":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaConfigSleepPolicyOneOf1After"},"mode":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaConfigSleepPolicyOneOf1Mode"}},"required":["after","mode"],"title":"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaConfigSleepPolicy1"},"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaConfigSleepPolicy":{"oneOf":[{"$ref":"#/components/schemas/V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaConfigSleepPolicy0"},{"$ref":"#/components/schemas/V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaConfigSleepPolicy1"}],"title":"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaConfigSleepPolicy"},"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaConfig":{"type":"object","properties":{"credentialAuthority":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaConfigCredentialAuthority"},"health":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaConfigHealth"},"ingress":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaConfigIngress"},"language":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaConfigLanguage"},"networkAccess":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaConfigNetworkAccess"},"port":{"type":"integer","minimum":1,"maximum":65535},"restartPolicy":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaConfigRestartPolicy"},"retention":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaConfigRetention"},"runtimeProfileId":{"type":"string","minLength":1,"maxLength":200},"secretBindings":{"type":"object","additionalProperties":{"type":"string","minLength":1,"maxLength":200}},"sleepPolicy":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaConfigSleepPolicy"},"sourceAssetId":{"type":"string","minLength":1,"maxLength":200},"startCommand":{"type":"string","minLength":1,"maxLength":2000}},"required":["credentialAuthority","language","port","retention","runtimeProfileId","sourceAssetId","startCommand"],"title":"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaConfig"},"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecAvailability":{"type":"string","enum":["on-demand","warm"],"title":"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecAvailability"},"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecCapabilitiesItems":{"type":"string","enum":["inspect-without-start","network-policy","private-ingress","process-adoption","rebuild","terminate:process-tree","terminate:sandbox-destroy","terminate:sandbox-stop","wake"],"title":"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecCapabilitiesItems"},"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecCredentialAuthorityOneOf0Kind":{"type":"string","enum":["organization-connection"],"title":"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecCredentialAuthorityOneOf0Kind"},"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecCredentialAuthority0":{"type":"object","properties":{"connectionId":{"type":"string","minLength":1,"maxLength":200},"kind":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecCredentialAuthorityOneOf0Kind"}},"required":["connectionId","kind"],"title":"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecCredentialAuthority0"},"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecCredentialAuthorityOneOf1Kind":{"type":"string","enum":["platform-managed"],"title":"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecCredentialAuthorityOneOf1Kind"},"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecCredentialAuthority1":{"type":"object","properties":{"kind":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecCredentialAuthorityOneOf1Kind"},"providerPolicyId":{"type":"string","minLength":1,"maxLength":200}},"required":["kind","providerPolicyId"],"title":"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecCredentialAuthority1"},"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecCredentialAuthority":{"oneOf":[{"$ref":"#/components/schemas/V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecCredentialAuthority0"},{"$ref":"#/components/schemas/V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecCredentialAuthority1"}],"title":"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecCredentialAuthority"},"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecHealthOneOf0Kind":{"type":"string","enum":["tcp"],"title":"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecHealthOneOf0Kind"},"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecHealth0":{"type":"object","properties":{"kind":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecHealthOneOf0Kind"}},"required":["kind"],"title":"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecHealth0"},"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecHealthOneOf1Kind":{"type":"string","enum":["http"],"title":"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecHealthOneOf1Kind"},"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecHealth1":{"type":"object","properties":{"expectedStatus":{"type":"integer","minimum":100,"maximum":599},"kind":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecHealthOneOf1Kind"},"path":{"type":"string","minLength":1,"maxLength":512}},"required":["expectedStatus","kind","path"],"title":"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecHealth1"},"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecHealth":{"oneOf":[{"$ref":"#/components/schemas/V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecHealth0"},{"$ref":"#/components/schemas/V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecHealth1"}],"title":"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecHealth"},"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecIngressAccess":{"type":"string","enum":["bearer","public"],"title":"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecIngressAccess"},"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecIngress":{"type":"object","properties":{"access":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecIngressAccess"},"allowedOrigins":{"type":"array","items":{"type":"string","minLength":1,"maxLength":255},"default":[]}},"required":["access"],"title":"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecIngress"},"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecLanguage":{"type":"string","enum":["javascript","typescript","python"],"title":"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecLanguage"},"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecNetworkAccess0":{"type":"string","enum":["none","essentials","open"],"title":"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecNetworkAccess0"},"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecNetworkAccessOneOf1Profile":{"type":"string","enum":["none","essentials","open"],"title":"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecNetworkAccessOneOf1Profile"},"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecNetworkAccess1":{"type":"object","properties":{"allow":{"type":"array","items":{"type":"string","pattern":"^(?:\\*\\.)?(?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?\\.)*[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$","minLength":1,"maxLength":253}},"profile":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecNetworkAccessOneOf1Profile"}},"title":"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecNetworkAccess1"},"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecNetworkAccess":{"oneOf":[{"$ref":"#/components/schemas/V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecNetworkAccess0"},{"$ref":"#/components/schemas/V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecNetworkAccess1"}],"title":"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecNetworkAccess"},"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecProfileEnvironment":{"type":"string","enum":["development","staging","production"],"title":"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecProfileEnvironment"},"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecProfile":{"type":"object","properties":{"accountTier":{"type":"string","minLength":1,"maxLength":200},"environment":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecProfileEnvironment"},"profileId":{"type":"string","minLength":1,"maxLength":200},"providerId":{"type":"string","minLength":1,"maxLength":200},"runtimeClass":{"type":"string","minLength":1,"maxLength":200},"sdkVersion":{"type":"string","minLength":1,"maxLength":200}},"required":["accountTier","environment","profileId","providerId","runtimeClass","sdkVersion"],"title":"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecProfile"},"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecRestartPolicy":{"type":"string","enum":["never","process","replace-sandbox"],"title":"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecRestartPolicy"},"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecRetention":{"type":"string","enum":["10m","1h","24h","unlimited"],"title":"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecRetention"},"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecRuntimeProfile":{"type":"object","properties":{"runtimeProfileDigest":{"type":"string","pattern":"^[0-9a-f]{64}$"},"runtimeProfileId":{"type":"string","minLength":1,"maxLength":200}},"required":["runtimeProfileDigest","runtimeProfileId"],"title":"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecRuntimeProfile"},"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecSleepPolicyOneOf0Mode":{"type":"string","enum":["never"],"title":"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecSleepPolicyOneOf0Mode"},"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecSleepPolicy0":{"type":"object","properties":{"mode":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecSleepPolicyOneOf0Mode"}},"required":["mode"],"title":"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecSleepPolicy0"},"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecSleepPolicyOneOf1After":{"type":"string","enum":["5m","15m","30m","1h"],"title":"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecSleepPolicyOneOf1After"},"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecSleepPolicyOneOf1Mode":{"type":"string","enum":["idle"],"title":"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecSleepPolicyOneOf1Mode"},"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecSleepPolicy1":{"type":"object","properties":{"after":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecSleepPolicyOneOf1After"},"mode":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecSleepPolicyOneOf1Mode"}},"required":["after","mode"],"title":"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecSleepPolicy1"},"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecSleepPolicy":{"oneOf":[{"$ref":"#/components/schemas/V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecSleepPolicy0"},{"$ref":"#/components/schemas/V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecSleepPolicy1"}],"title":"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecSleepPolicy"},"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecSource":{"type":"object","properties":{"sourceAssetId":{"type":"string","minLength":1,"maxLength":200},"sourceHash":{"type":"string","pattern":"^[0-9a-f]{64}$"}},"required":["sourceAssetId","sourceHash"],"title":"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecSource"},"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpec":{"type":"object","properties":{"availability":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecAvailability"},"capabilities":{"type":"array","items":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecCapabilitiesItems"}},"credentialAuthority":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecCredentialAuthority"},"health":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecHealth"},"ingress":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecIngress"},"language":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecLanguage"},"networkAccess":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecNetworkAccess"},"networkPolicyRef":{"type":"string","minLength":1,"maxLength":200},"port":{"type":"integer","minimum":1,"maximum":65535},"profile":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecProfile"},"restartPolicy":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecRestartPolicy"},"retention":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecRetention"},"runtimeProfile":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecRuntimeProfile"},"secretBindings":{"type":"object","additionalProperties":{"type":"string","minLength":1,"maxLength":200},"default":{}},"sleepPolicy":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecSleepPolicy"},"source":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpecSource"},"startCommand":{"type":"string","minLength":1,"maxLength":2000}},"required":["availability","capabilities","credentialAuthority","health","ingress","language","networkPolicyRef","port","profile","restartPolicy","retention","runtimeProfile","sleepPolicy","source","startCommand"],"title":"V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpec"},"Sandbox_Deployments_readTheAcceptedDeploymentDefinition_Response_200":{"type":"object","properties":{"config":{"oneOf":[{"$ref":"#/components/schemas/V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaConfig"},{"type":"null"}]},"configUnavailableReason":{"type":"string"},"deploymentId":{"type":"string"},"desiredRevision":{"type":"integer"},"resourceVersion":{"type":"integer"},"spec":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdDefinitionGetResponsesContentApplicationJsonSchemaSpec"},"specHash":{"type":"string"}},"required":["config","deploymentId","desiredRevision","resourceVersion","spec","specHash"],"title":"Sandbox Deployments_readTheAcceptedDeploymentDefinition_Response_200"},"V1SandboxDeploymentsIdIngressCredentialsGetResponsesContentApplicationJsonSchemaCredentialsItems":{"type":"object","properties":{"createdAt":{"type":"string"},"deploymentId":{"type":"string"},"displayName":{"type":["string","null"]},"expiresAt":{"type":["string","null"]},"ingressPolicyVersion":{"type":"integer"},"lastUsedAt":{"type":["string","null"]},"revokedAt":{"type":["string","null"]},"revokedReason":{"type":["string","null"]},"tokenId":{"type":"string"},"tokenPreview":{"type":"string"}},"required":["createdAt","deploymentId","displayName","expiresAt","ingressPolicyVersion","lastUsedAt","revokedAt","revokedReason","tokenId","tokenPreview"],"title":"V1SandboxDeploymentsIdIngressCredentialsGetResponsesContentApplicationJsonSchemaCredentialsItems"},"Sandbox_Deployments_listDeploymentIngressCredentials_Response_200":{"type":"object","properties":{"credentials":{"type":"array","items":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdIngressCredentialsGetResponsesContentApplicationJsonSchemaCredentialsItems"}}},"required":["credentials"],"title":"Sandbox Deployments_listDeploymentIngressCredentials_Response_200"},"V1SandboxDeploymentsIdIngressCredentialsPostResponsesContentApplicationJsonSchemaCredential":{"type":"object","properties":{"createdAt":{"type":"string"},"deploymentId":{"type":"string"},"displayName":{"type":["string","null"]},"expiresAt":{"type":["string","null"]},"ingressPolicyVersion":{"type":"integer"},"lastUsedAt":{"type":["string","null"]},"revokedAt":{"type":["string","null"]},"revokedReason":{"type":["string","null"]},"tokenId":{"type":"string"},"tokenPreview":{"type":"string"}},"required":["createdAt","deploymentId","displayName","expiresAt","ingressPolicyVersion","lastUsedAt","revokedAt","revokedReason","tokenId","tokenPreview"],"title":"V1SandboxDeploymentsIdIngressCredentialsPostResponsesContentApplicationJsonSchemaCredential"},"Sandbox_Deployments_issueADeploymentIngressCredential_Response_201":{"type":"object","properties":{"credential":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdIngressCredentialsPostResponsesContentApplicationJsonSchemaCredential"},"token":{"type":"string","description":"The plaintext bearer. It is returned once and is never recoverable afterwards."}},"required":["credential","token"],"title":"Sandbox Deployments_issueADeploymentIngressCredential_Response_201"},"V1SandboxDeploymentsIdIngressCredentialsCredentialIdDeleteResponsesContentApplicationJsonSchemaCredential":{"type":"object","properties":{"createdAt":{"type":"string"},"deploymentId":{"type":"string"},"displayName":{"type":["string","null"]},"expiresAt":{"type":["string","null"]},"ingressPolicyVersion":{"type":"integer"},"lastUsedAt":{"type":["string","null"]},"revokedAt":{"type":["string","null"]},"revokedReason":{"type":["string","null"]},"tokenId":{"type":"string"},"tokenPreview":{"type":"string"}},"required":["createdAt","deploymentId","displayName","expiresAt","ingressPolicyVersion","lastUsedAt","revokedAt","revokedReason","tokenId","tokenPreview"],"title":"V1SandboxDeploymentsIdIngressCredentialsCredentialIdDeleteResponsesContentApplicationJsonSchemaCredential"},"Sandbox_Deployments_revokeADeploymentIngressCredential_Response_200":{"type":"object","properties":{"credential":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdIngressCredentialsCredentialIdDeleteResponsesContentApplicationJsonSchemaCredential"}},"required":["credential"],"title":"Sandbox Deployments_revokeADeploymentIngressCredential_Response_200"},"V1SandboxDeploymentsIdIngressCredentialsCredentialIdRotatePostResponsesContentApplicationJsonSchemaCredential":{"type":"object","properties":{"createdAt":{"type":"string"},"deploymentId":{"type":"string"},"displayName":{"type":["string","null"]},"expiresAt":{"type":["string","null"]},"ingressPolicyVersion":{"type":"integer"},"lastUsedAt":{"type":["string","null"]},"revokedAt":{"type":["string","null"]},"revokedReason":{"type":["string","null"]},"tokenId":{"type":"string"},"tokenPreview":{"type":"string"}},"required":["createdAt","deploymentId","displayName","expiresAt","ingressPolicyVersion","lastUsedAt","revokedAt","revokedReason","tokenId","tokenPreview"],"title":"V1SandboxDeploymentsIdIngressCredentialsCredentialIdRotatePostResponsesContentApplicationJsonSchemaCredential"},"Sandbox_Deployments_rotateADeploymentIngressCredential_Response_201":{"type":"object","properties":{"credential":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdIngressCredentialsCredentialIdRotatePostResponsesContentApplicationJsonSchemaCredential"},"token":{"type":"string","description":"The plaintext bearer. It is returned once and is never recoverable afterwards."}},"required":["credential","token"],"title":"Sandbox Deployments_rotateADeploymentIngressCredential_Response_201"},"Sandbox_Deployments_getOneDeploymentOperation_Response_200":{"type":"object","properties":{"deadlineAt":{"type":"string"},"deploymentId":{"type":"string"},"desiredRevision":{"type":"integer"},"failureReason":{"type":["string","null"]},"fence":{"type":"integer"},"kind":{"type":"string"},"liabilityState":{"type":"string"},"operationId":{"type":"string"},"status":{"type":"string"}},"required":["deadlineAt","deploymentId","desiredRevision","failureReason","fence","kind","liabilityState","operationId","status"],"title":"Sandbox Deployments_getOneDeploymentOperation_Response_200"},"V1SandboxDeploymentsIdRenewPostRequestBodyContentApplicationJsonSchemaRetention":{"type":"string","enum":["10m","1h","24h","unlimited"],"title":"V1SandboxDeploymentsIdRenewPostRequestBodyContentApplicationJsonSchemaRetention"},"V1SandboxDeploymentsIdRenewPostResponsesContentApplicationJsonSchemaDeploymentCounters":{"type":"object","properties":{"desiredRevision":{"type":"integer","exclusiveMinimum":0},"observedRevision":{"type":["integer","null"],"exclusiveMinimum":0},"providerGeneration":{"type":"integer","minimum":0},"resourceVersion":{"type":"integer","minimum":0},"runtimeEpoch":{"type":"integer","minimum":0}},"required":["desiredRevision","observedRevision","providerGeneration","resourceVersion","runtimeEpoch"],"title":"V1SandboxDeploymentsIdRenewPostResponsesContentApplicationJsonSchemaDeploymentCounters"},"V1SandboxDeploymentsIdRenewPostResponsesContentApplicationJsonSchemaDeploymentDesiredState":{"type":"string","enum":["active","suspended","destroyed","expired"],"title":"V1SandboxDeploymentsIdRenewPostResponsesContentApplicationJsonSchemaDeploymentDesiredState"},"V1SandboxDeploymentsIdRenewPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyAccess":{"type":"string","enum":["bearer","public"],"title":"V1SandboxDeploymentsIdRenewPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyAccess"},"V1SandboxDeploymentsIdRenewPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyAvailability":{"type":"string","enum":["on-demand","warm"],"title":"V1SandboxDeploymentsIdRenewPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyAvailability"},"V1SandboxDeploymentsIdRenewPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyNetworkAccess0":{"type":"string","enum":["none","essentials","open"],"title":"V1SandboxDeploymentsIdRenewPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyNetworkAccess0"},"V1SandboxDeploymentsIdRenewPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyNetworkAccessOneOf1Profile":{"type":"string","enum":["none","essentials","open"],"title":"V1SandboxDeploymentsIdRenewPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyNetworkAccessOneOf1Profile"},"V1SandboxDeploymentsIdRenewPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyNetworkAccess1":{"type":"object","properties":{"allow":{"type":"array","items":{"type":"string","pattern":"^(?:\\*\\.)?(?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?\\.)*[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$","minLength":1,"maxLength":253}},"profile":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdRenewPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyNetworkAccessOneOf1Profile"}},"title":"V1SandboxDeploymentsIdRenewPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyNetworkAccess1"},"V1SandboxDeploymentsIdRenewPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyNetworkAccess":{"oneOf":[{"$ref":"#/components/schemas/V1SandboxDeploymentsIdRenewPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyNetworkAccess0"},{"$ref":"#/components/schemas/V1SandboxDeploymentsIdRenewPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyNetworkAccess1"}],"title":"V1SandboxDeploymentsIdRenewPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyNetworkAccess"},"V1SandboxDeploymentsIdRenewPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyRestartPolicy":{"type":"string","enum":["never","process","replace-sandbox"],"title":"V1SandboxDeploymentsIdRenewPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyRestartPolicy"},"V1SandboxDeploymentsIdRenewPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyRetention":{"type":"string","enum":["10m","1h","24h","unlimited"],"title":"V1SandboxDeploymentsIdRenewPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyRetention"},"V1SandboxDeploymentsIdRenewPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicyOneOf0Mode":{"type":"string","enum":["never"],"title":"V1SandboxDeploymentsIdRenewPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicyOneOf0Mode"},"V1SandboxDeploymentsIdRenewPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicy0":{"type":"object","properties":{"mode":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdRenewPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicyOneOf0Mode"}},"required":["mode"],"title":"V1SandboxDeploymentsIdRenewPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicy0"},"V1SandboxDeploymentsIdRenewPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicyOneOf1After":{"type":"string","enum":["5m","15m","30m","1h"],"title":"V1SandboxDeploymentsIdRenewPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicyOneOf1After"},"V1SandboxDeploymentsIdRenewPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicyOneOf1Mode":{"type":"string","enum":["idle"],"title":"V1SandboxDeploymentsIdRenewPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicyOneOf1Mode"},"V1SandboxDeploymentsIdRenewPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicy1":{"type":"object","properties":{"after":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdRenewPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicyOneOf1After"},"mode":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdRenewPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicyOneOf1Mode"}},"required":["after","mode"],"title":"V1SandboxDeploymentsIdRenewPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicy1"},"V1SandboxDeploymentsIdRenewPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicy":{"oneOf":[{"$ref":"#/components/schemas/V1SandboxDeploymentsIdRenewPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicy0"},{"$ref":"#/components/schemas/V1SandboxDeploymentsIdRenewPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicy1"}],"title":"V1SandboxDeploymentsIdRenewPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicy"},"V1SandboxDeploymentsIdRenewPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicy":{"type":"object","properties":{"access":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdRenewPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyAccess"},"availability":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdRenewPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyAvailability"},"networkAccess":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdRenewPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyNetworkAccess"},"restartPolicy":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdRenewPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyRestartPolicy"},"retention":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdRenewPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyRetention"},"sleepPolicy":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdRenewPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicy"}},"required":["access","availability","restartPolicy","retention","sleepPolicy"],"title":"V1SandboxDeploymentsIdRenewPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicy"},"V1SandboxDeploymentsIdRenewPostResponsesContentApplicationJsonSchemaDeploymentEnvironment":{"type":"string","enum":["development","staging","production"],"title":"V1SandboxDeploymentsIdRenewPostResponsesContentApplicationJsonSchemaDeploymentEnvironment"},"V1SandboxDeploymentsIdRenewPostResponsesContentApplicationJsonSchemaDeploymentProfileEnvironment":{"type":"string","enum":["development","staging","production"],"title":"V1SandboxDeploymentsIdRenewPostResponsesContentApplicationJsonSchemaDeploymentProfileEnvironment"},"V1SandboxDeploymentsIdRenewPostResponsesContentApplicationJsonSchemaDeploymentProfile":{"type":"object","properties":{"accountTier":{"type":"string","minLength":1,"maxLength":200},"environment":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdRenewPostResponsesContentApplicationJsonSchemaDeploymentProfileEnvironment"},"profileId":{"type":"string","minLength":1,"maxLength":200},"providerId":{"type":"string","minLength":1,"maxLength":200},"runtimeClass":{"type":"string","minLength":1,"maxLength":200},"sdkVersion":{"type":"string","minLength":1,"maxLength":200}},"required":["accountTier","environment","profileId","providerId","runtimeClass","sdkVersion"],"title":"V1SandboxDeploymentsIdRenewPostResponsesContentApplicationJsonSchemaDeploymentProfile"},"V1SandboxDeploymentsIdRenewPostResponsesContentApplicationJsonSchemaDeploymentStatus":{"type":"string","enum":["provisioning","running","sleeping","suspended","degraded","failed","blocked","destroying","destroyed","expired"],"title":"V1SandboxDeploymentsIdRenewPostResponsesContentApplicationJsonSchemaDeploymentStatus"},"V1SandboxDeploymentsIdRenewPostResponsesContentApplicationJsonSchemaDeployment":{"type":"object","properties":{"activeOperationId":{"type":["string","null"]},"activeProviderInstanceId":{"type":["string","null"]},"counters":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdRenewPostResponsesContentApplicationJsonSchemaDeploymentCounters"},"createdAt":{"type":"string"},"createdByUserId":{"type":["string","null"]},"deploymentId":{"type":"string"},"desiredState":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdRenewPostResponsesContentApplicationJsonSchemaDeploymentDesiredState"},"displayName":{"type":["string","null"]},"effectivePolicy":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdRenewPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicy"},"environment":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdRenewPostResponsesContentApplicationJsonSchemaDeploymentEnvironment"},"expiresAt":{"type":["string","null"]},"ingressEnabled":{"type":"boolean"},"organizationId":{"type":"string"},"profile":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdRenewPostResponsesContentApplicationJsonSchemaDeploymentProfile"},"retentionAnchorAt":{"type":"string"},"specHash":{"type":"string"},"status":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdRenewPostResponsesContentApplicationJsonSchemaDeploymentStatus"},"statusReason":{"type":["string","null"]},"updatedAt":{"type":"string"},"url":{"type":["string","null"]}},"required":["activeOperationId","activeProviderInstanceId","counters","createdAt","createdByUserId","deploymentId","desiredState","displayName","effectivePolicy","environment","expiresAt","ingressEnabled","organizationId","profile","retentionAnchorAt","specHash","status","statusReason","updatedAt","url"],"title":"V1SandboxDeploymentsIdRenewPostResponsesContentApplicationJsonSchemaDeployment"},"Sandbox_Deployments_renewAManagedSandboxDeployment_Response_202":{"type":"object","properties":{"deployment":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdRenewPostResponsesContentApplicationJsonSchemaDeployment"},"operationId":{"type":["string","null"]}},"required":["deployment","operationId"],"title":"Sandbox Deployments_renewAManagedSandboxDeployment_Response_202"},"V1SandboxDeploymentsIdResumePostResponsesContentApplicationJsonSchemaDeploymentCounters":{"type":"object","properties":{"desiredRevision":{"type":"integer","exclusiveMinimum":0},"observedRevision":{"type":["integer","null"],"exclusiveMinimum":0},"providerGeneration":{"type":"integer","minimum":0},"resourceVersion":{"type":"integer","minimum":0},"runtimeEpoch":{"type":"integer","minimum":0}},"required":["desiredRevision","observedRevision","providerGeneration","resourceVersion","runtimeEpoch"],"title":"V1SandboxDeploymentsIdResumePostResponsesContentApplicationJsonSchemaDeploymentCounters"},"V1SandboxDeploymentsIdResumePostResponsesContentApplicationJsonSchemaDeploymentDesiredState":{"type":"string","enum":["active","suspended","destroyed","expired"],"title":"V1SandboxDeploymentsIdResumePostResponsesContentApplicationJsonSchemaDeploymentDesiredState"},"V1SandboxDeploymentsIdResumePostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyAccess":{"type":"string","enum":["bearer","public"],"title":"V1SandboxDeploymentsIdResumePostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyAccess"},"V1SandboxDeploymentsIdResumePostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyAvailability":{"type":"string","enum":["on-demand","warm"],"title":"V1SandboxDeploymentsIdResumePostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyAvailability"},"V1SandboxDeploymentsIdResumePostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyNetworkAccess0":{"type":"string","enum":["none","essentials","open"],"title":"V1SandboxDeploymentsIdResumePostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyNetworkAccess0"},"V1SandboxDeploymentsIdResumePostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyNetworkAccessOneOf1Profile":{"type":"string","enum":["none","essentials","open"],"title":"V1SandboxDeploymentsIdResumePostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyNetworkAccessOneOf1Profile"},"V1SandboxDeploymentsIdResumePostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyNetworkAccess1":{"type":"object","properties":{"allow":{"type":"array","items":{"type":"string","pattern":"^(?:\\*\\.)?(?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?\\.)*[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$","minLength":1,"maxLength":253}},"profile":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdResumePostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyNetworkAccessOneOf1Profile"}},"title":"V1SandboxDeploymentsIdResumePostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyNetworkAccess1"},"V1SandboxDeploymentsIdResumePostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyNetworkAccess":{"oneOf":[{"$ref":"#/components/schemas/V1SandboxDeploymentsIdResumePostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyNetworkAccess0"},{"$ref":"#/components/schemas/V1SandboxDeploymentsIdResumePostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyNetworkAccess1"}],"title":"V1SandboxDeploymentsIdResumePostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyNetworkAccess"},"V1SandboxDeploymentsIdResumePostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyRestartPolicy":{"type":"string","enum":["never","process","replace-sandbox"],"title":"V1SandboxDeploymentsIdResumePostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyRestartPolicy"},"V1SandboxDeploymentsIdResumePostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyRetention":{"type":"string","enum":["10m","1h","24h","unlimited"],"title":"V1SandboxDeploymentsIdResumePostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyRetention"},"V1SandboxDeploymentsIdResumePostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicyOneOf0Mode":{"type":"string","enum":["never"],"title":"V1SandboxDeploymentsIdResumePostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicyOneOf0Mode"},"V1SandboxDeploymentsIdResumePostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicy0":{"type":"object","properties":{"mode":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdResumePostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicyOneOf0Mode"}},"required":["mode"],"title":"V1SandboxDeploymentsIdResumePostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicy0"},"V1SandboxDeploymentsIdResumePostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicyOneOf1After":{"type":"string","enum":["5m","15m","30m","1h"],"title":"V1SandboxDeploymentsIdResumePostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicyOneOf1After"},"V1SandboxDeploymentsIdResumePostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicyOneOf1Mode":{"type":"string","enum":["idle"],"title":"V1SandboxDeploymentsIdResumePostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicyOneOf1Mode"},"V1SandboxDeploymentsIdResumePostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicy1":{"type":"object","properties":{"after":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdResumePostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicyOneOf1After"},"mode":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdResumePostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicyOneOf1Mode"}},"required":["after","mode"],"title":"V1SandboxDeploymentsIdResumePostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicy1"},"V1SandboxDeploymentsIdResumePostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicy":{"oneOf":[{"$ref":"#/components/schemas/V1SandboxDeploymentsIdResumePostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicy0"},{"$ref":"#/components/schemas/V1SandboxDeploymentsIdResumePostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicy1"}],"title":"V1SandboxDeploymentsIdResumePostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicy"},"V1SandboxDeploymentsIdResumePostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicy":{"type":"object","properties":{"access":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdResumePostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyAccess"},"availability":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdResumePostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyAvailability"},"networkAccess":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdResumePostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyNetworkAccess"},"restartPolicy":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdResumePostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyRestartPolicy"},"retention":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdResumePostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyRetention"},"sleepPolicy":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdResumePostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicy"}},"required":["access","availability","restartPolicy","retention","sleepPolicy"],"title":"V1SandboxDeploymentsIdResumePostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicy"},"V1SandboxDeploymentsIdResumePostResponsesContentApplicationJsonSchemaDeploymentEnvironment":{"type":"string","enum":["development","staging","production"],"title":"V1SandboxDeploymentsIdResumePostResponsesContentApplicationJsonSchemaDeploymentEnvironment"},"V1SandboxDeploymentsIdResumePostResponsesContentApplicationJsonSchemaDeploymentProfileEnvironment":{"type":"string","enum":["development","staging","production"],"title":"V1SandboxDeploymentsIdResumePostResponsesContentApplicationJsonSchemaDeploymentProfileEnvironment"},"V1SandboxDeploymentsIdResumePostResponsesContentApplicationJsonSchemaDeploymentProfile":{"type":"object","properties":{"accountTier":{"type":"string","minLength":1,"maxLength":200},"environment":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdResumePostResponsesContentApplicationJsonSchemaDeploymentProfileEnvironment"},"profileId":{"type":"string","minLength":1,"maxLength":200},"providerId":{"type":"string","minLength":1,"maxLength":200},"runtimeClass":{"type":"string","minLength":1,"maxLength":200},"sdkVersion":{"type":"string","minLength":1,"maxLength":200}},"required":["accountTier","environment","profileId","providerId","runtimeClass","sdkVersion"],"title":"V1SandboxDeploymentsIdResumePostResponsesContentApplicationJsonSchemaDeploymentProfile"},"V1SandboxDeploymentsIdResumePostResponsesContentApplicationJsonSchemaDeploymentStatus":{"type":"string","enum":["provisioning","running","sleeping","suspended","degraded","failed","blocked","destroying","destroyed","expired"],"title":"V1SandboxDeploymentsIdResumePostResponsesContentApplicationJsonSchemaDeploymentStatus"},"V1SandboxDeploymentsIdResumePostResponsesContentApplicationJsonSchemaDeployment":{"type":"object","properties":{"activeOperationId":{"type":["string","null"]},"activeProviderInstanceId":{"type":["string","null"]},"counters":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdResumePostResponsesContentApplicationJsonSchemaDeploymentCounters"},"createdAt":{"type":"string"},"createdByUserId":{"type":["string","null"]},"deploymentId":{"type":"string"},"desiredState":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdResumePostResponsesContentApplicationJsonSchemaDeploymentDesiredState"},"displayName":{"type":["string","null"]},"effectivePolicy":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdResumePostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicy"},"environment":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdResumePostResponsesContentApplicationJsonSchemaDeploymentEnvironment"},"expiresAt":{"type":["string","null"]},"ingressEnabled":{"type":"boolean"},"organizationId":{"type":"string"},"profile":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdResumePostResponsesContentApplicationJsonSchemaDeploymentProfile"},"retentionAnchorAt":{"type":"string"},"specHash":{"type":"string"},"status":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdResumePostResponsesContentApplicationJsonSchemaDeploymentStatus"},"statusReason":{"type":["string","null"]},"updatedAt":{"type":"string"},"url":{"type":["string","null"]}},"required":["activeOperationId","activeProviderInstanceId","counters","createdAt","createdByUserId","deploymentId","desiredState","displayName","effectivePolicy","environment","expiresAt","ingressEnabled","organizationId","profile","retentionAnchorAt","specHash","status","statusReason","updatedAt","url"],"title":"V1SandboxDeploymentsIdResumePostResponsesContentApplicationJsonSchemaDeployment"},"Sandbox_Deployments_resumeAManagedSandboxDeployment_Response_202":{"type":"object","properties":{"deployment":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdResumePostResponsesContentApplicationJsonSchemaDeployment"},"operationId":{"type":["string","null"]}},"required":["deployment","operationId"],"title":"Sandbox Deployments_resumeAManagedSandboxDeployment_Response_202"},"V1SandboxDeploymentsIdSuspendPostResponsesContentApplicationJsonSchemaDeploymentCounters":{"type":"object","properties":{"desiredRevision":{"type":"integer","exclusiveMinimum":0},"observedRevision":{"type":["integer","null"],"exclusiveMinimum":0},"providerGeneration":{"type":"integer","minimum":0},"resourceVersion":{"type":"integer","minimum":0},"runtimeEpoch":{"type":"integer","minimum":0}},"required":["desiredRevision","observedRevision","providerGeneration","resourceVersion","runtimeEpoch"],"title":"V1SandboxDeploymentsIdSuspendPostResponsesContentApplicationJsonSchemaDeploymentCounters"},"V1SandboxDeploymentsIdSuspendPostResponsesContentApplicationJsonSchemaDeploymentDesiredState":{"type":"string","enum":["active","suspended","destroyed","expired"],"title":"V1SandboxDeploymentsIdSuspendPostResponsesContentApplicationJsonSchemaDeploymentDesiredState"},"V1SandboxDeploymentsIdSuspendPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyAccess":{"type":"string","enum":["bearer","public"],"title":"V1SandboxDeploymentsIdSuspendPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyAccess"},"V1SandboxDeploymentsIdSuspendPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyAvailability":{"type":"string","enum":["on-demand","warm"],"title":"V1SandboxDeploymentsIdSuspendPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyAvailability"},"V1SandboxDeploymentsIdSuspendPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyNetworkAccess0":{"type":"string","enum":["none","essentials","open"],"title":"V1SandboxDeploymentsIdSuspendPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyNetworkAccess0"},"V1SandboxDeploymentsIdSuspendPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyNetworkAccessOneOf1Profile":{"type":"string","enum":["none","essentials","open"],"title":"V1SandboxDeploymentsIdSuspendPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyNetworkAccessOneOf1Profile"},"V1SandboxDeploymentsIdSuspendPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyNetworkAccess1":{"type":"object","properties":{"allow":{"type":"array","items":{"type":"string","pattern":"^(?:\\*\\.)?(?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?\\.)*[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$","minLength":1,"maxLength":253}},"profile":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdSuspendPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyNetworkAccessOneOf1Profile"}},"title":"V1SandboxDeploymentsIdSuspendPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyNetworkAccess1"},"V1SandboxDeploymentsIdSuspendPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyNetworkAccess":{"oneOf":[{"$ref":"#/components/schemas/V1SandboxDeploymentsIdSuspendPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyNetworkAccess0"},{"$ref":"#/components/schemas/V1SandboxDeploymentsIdSuspendPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyNetworkAccess1"}],"title":"V1SandboxDeploymentsIdSuspendPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyNetworkAccess"},"V1SandboxDeploymentsIdSuspendPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyRestartPolicy":{"type":"string","enum":["never","process","replace-sandbox"],"title":"V1SandboxDeploymentsIdSuspendPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyRestartPolicy"},"V1SandboxDeploymentsIdSuspendPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyRetention":{"type":"string","enum":["10m","1h","24h","unlimited"],"title":"V1SandboxDeploymentsIdSuspendPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyRetention"},"V1SandboxDeploymentsIdSuspendPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicyOneOf0Mode":{"type":"string","enum":["never"],"title":"V1SandboxDeploymentsIdSuspendPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicyOneOf0Mode"},"V1SandboxDeploymentsIdSuspendPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicy0":{"type":"object","properties":{"mode":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdSuspendPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicyOneOf0Mode"}},"required":["mode"],"title":"V1SandboxDeploymentsIdSuspendPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicy0"},"V1SandboxDeploymentsIdSuspendPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicyOneOf1After":{"type":"string","enum":["5m","15m","30m","1h"],"title":"V1SandboxDeploymentsIdSuspendPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicyOneOf1After"},"V1SandboxDeploymentsIdSuspendPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicyOneOf1Mode":{"type":"string","enum":["idle"],"title":"V1SandboxDeploymentsIdSuspendPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicyOneOf1Mode"},"V1SandboxDeploymentsIdSuspendPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicy1":{"type":"object","properties":{"after":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdSuspendPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicyOneOf1After"},"mode":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdSuspendPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicyOneOf1Mode"}},"required":["after","mode"],"title":"V1SandboxDeploymentsIdSuspendPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicy1"},"V1SandboxDeploymentsIdSuspendPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicy":{"oneOf":[{"$ref":"#/components/schemas/V1SandboxDeploymentsIdSuspendPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicy0"},{"$ref":"#/components/schemas/V1SandboxDeploymentsIdSuspendPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicy1"}],"title":"V1SandboxDeploymentsIdSuspendPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicy"},"V1SandboxDeploymentsIdSuspendPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicy":{"type":"object","properties":{"access":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdSuspendPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyAccess"},"availability":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdSuspendPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyAvailability"},"networkAccess":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdSuspendPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyNetworkAccess"},"restartPolicy":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdSuspendPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyRestartPolicy"},"retention":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdSuspendPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicyRetention"},"sleepPolicy":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdSuspendPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicySleepPolicy"}},"required":["access","availability","restartPolicy","retention","sleepPolicy"],"title":"V1SandboxDeploymentsIdSuspendPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicy"},"V1SandboxDeploymentsIdSuspendPostResponsesContentApplicationJsonSchemaDeploymentEnvironment":{"type":"string","enum":["development","staging","production"],"title":"V1SandboxDeploymentsIdSuspendPostResponsesContentApplicationJsonSchemaDeploymentEnvironment"},"V1SandboxDeploymentsIdSuspendPostResponsesContentApplicationJsonSchemaDeploymentProfileEnvironment":{"type":"string","enum":["development","staging","production"],"title":"V1SandboxDeploymentsIdSuspendPostResponsesContentApplicationJsonSchemaDeploymentProfileEnvironment"},"V1SandboxDeploymentsIdSuspendPostResponsesContentApplicationJsonSchemaDeploymentProfile":{"type":"object","properties":{"accountTier":{"type":"string","minLength":1,"maxLength":200},"environment":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdSuspendPostResponsesContentApplicationJsonSchemaDeploymentProfileEnvironment"},"profileId":{"type":"string","minLength":1,"maxLength":200},"providerId":{"type":"string","minLength":1,"maxLength":200},"runtimeClass":{"type":"string","minLength":1,"maxLength":200},"sdkVersion":{"type":"string","minLength":1,"maxLength":200}},"required":["accountTier","environment","profileId","providerId","runtimeClass","sdkVersion"],"title":"V1SandboxDeploymentsIdSuspendPostResponsesContentApplicationJsonSchemaDeploymentProfile"},"V1SandboxDeploymentsIdSuspendPostResponsesContentApplicationJsonSchemaDeploymentStatus":{"type":"string","enum":["provisioning","running","sleeping","suspended","degraded","failed","blocked","destroying","destroyed","expired"],"title":"V1SandboxDeploymentsIdSuspendPostResponsesContentApplicationJsonSchemaDeploymentStatus"},"V1SandboxDeploymentsIdSuspendPostResponsesContentApplicationJsonSchemaDeployment":{"type":"object","properties":{"activeOperationId":{"type":["string","null"]},"activeProviderInstanceId":{"type":["string","null"]},"counters":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdSuspendPostResponsesContentApplicationJsonSchemaDeploymentCounters"},"createdAt":{"type":"string"},"createdByUserId":{"type":["string","null"]},"deploymentId":{"type":"string"},"desiredState":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdSuspendPostResponsesContentApplicationJsonSchemaDeploymentDesiredState"},"displayName":{"type":["string","null"]},"effectivePolicy":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdSuspendPostResponsesContentApplicationJsonSchemaDeploymentEffectivePolicy"},"environment":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdSuspendPostResponsesContentApplicationJsonSchemaDeploymentEnvironment"},"expiresAt":{"type":["string","null"]},"ingressEnabled":{"type":"boolean"},"organizationId":{"type":"string"},"profile":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdSuspendPostResponsesContentApplicationJsonSchemaDeploymentProfile"},"retentionAnchorAt":{"type":"string"},"specHash":{"type":"string"},"status":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdSuspendPostResponsesContentApplicationJsonSchemaDeploymentStatus"},"statusReason":{"type":["string","null"]},"updatedAt":{"type":"string"},"url":{"type":["string","null"]}},"required":["activeOperationId","activeProviderInstanceId","counters","createdAt","createdByUserId","deploymentId","desiredState","displayName","effectivePolicy","environment","expiresAt","ingressEnabled","organizationId","profile","retentionAnchorAt","specHash","status","statusReason","updatedAt","url"],"title":"V1SandboxDeploymentsIdSuspendPostResponsesContentApplicationJsonSchemaDeployment"},"Sandbox_Deployments_suspendAManagedSandboxDeployment_Response_202":{"type":"object","properties":{"deployment":{"$ref":"#/components/schemas/V1SandboxDeploymentsIdSuspendPostResponsesContentApplicationJsonSchemaDeployment"},"operationId":{"type":["string","null"]}},"required":["deployment","operationId"],"title":"Sandbox Deployments_suspendAManagedSandboxDeployment_Response_202"},"V1SchedulesGetParametersStatus":{"type":"string","enum":["active","paused"],"description":"Filter by status","title":"V1SchedulesGetParametersStatus"},"V1SchedulesGetParametersView":{"type":"string","enum":["full","compact"],"description":"Response representation. `full` (default) preserves complete values; `compact` shortens every string value longer than 100 characters to a 100-character preview followed by `…`.","title":"V1SchedulesGetParametersView"},"V1SchedulesGetResponsesContentApplicationJsonSchemaDataItems":{"type":"object","properties":{"agentId":{"type":["string","null"]},"createdAt":{"type":"string"},"cron":{"type":["string","null"]},"enabled":{"type":"boolean"},"executionOptions":{"type":"object","additionalProperties":{"description":"Any type"}},"flowId":{"type":["string","null"]},"id":{"type":"string"},"inputs":{"type":["object","null"],"additionalProperties":{"description":"Any type"}},"lastRunAt":{"type":["string","null"]},"messages":{"description":"Any type"},"name":{"type":["string","null"]},"nextRunAt":{"type":["string","null"]},"organizationId":{"type":["string","null"]},"productSurfaceId":{"type":["string","null"]},"recordFilter":{"description":"Any type"},"recordIds":{"type":["array","null"],"items":{"type":"string"}},"recordType":{"type":["string","null"]},"runAt":{"type":["string","null"]},"timezone":{"type":["string","null"]},"triggerType":{"type":"string"},"updatedAt":{"type":"string"},"userId":{"type":"string"}},"required":["agentId","createdAt","cron","enabled","executionOptions","flowId","id","inputs","lastRunAt","name","nextRunAt","organizationId","productSurfaceId","recordIds","recordType","runAt","timezone","triggerType","updatedAt","userId"],"title":"V1SchedulesGetResponsesContentApplicationJsonSchemaDataItems"},"Schedules_listSchedules_Response_200":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1SchedulesGetResponsesContentApplicationJsonSchemaDataItems"}},"pagination":{"$ref":"#/components/schemas/Pagination"}},"required":["data","pagination"],"title":"Schedules_listSchedules_Response_200"},"V1SchedulesPostResponsesContentApplicationJsonSchemaStatus":{"type":"string","enum":["created"],"title":"V1SchedulesPostResponsesContentApplicationJsonSchemaStatus"},"Schedules_createASchedule_Response_200":{"type":"object","properties":{"id":{"type":"string"},"status":{"$ref":"#/components/schemas/V1SchedulesPostResponsesContentApplicationJsonSchemaStatus"}},"required":["id","status"],"title":"Schedules_createASchedule_Response_200"},"ScheduleEntitlementErrorDetailsItems":{"type":"object","properties":{"code":{"type":"string","description":"Stable Runtype validation code (e.g. MISSING_REQUIRED_FIELD, INVALID_ENUM)."},"message":{"type":"string"},"path":{"type":"string","description":"Dotted JSON path to the offending field."},"suggestion":{"type":"string","description":"Actionable hint (allowed values, accepted range, …)."}},"required":["message"],"title":"ScheduleEntitlementErrorDetailsItems"},"ScheduleEntitlementError":{"type":"object","properties":{"code":{"type":"string","description":"Stable error code (e.g. ACTIVE_SCHEDULE_LIMIT, SCHEDULE_FREQUENCY_LIMIT)."},"details":{"type":"array","items":{"$ref":"#/components/schemas/ScheduleEntitlementErrorDetailsItems"}},"error":{"type":"string"},"requiredScopes":{"type":"array","items":{"type":"string"},"description":"On `insufficient_scope`: every API key scope this request needs."},"message":{"type":"string","description":"Human-readable error message."},"upgradeUrl":{"type":"string","description":"Dashboard-relative URL to the billing/upgrade page."}},"required":["error"],"title":"ScheduleEntitlementError"},"V1SchedulesBatchBatchIdResultsGetResponsesContentApplicationJsonSchemaDataItemsExecutionEngine":{"type":"string","enum":["runtime","legacy","external"],"description":"Engine that actually executed this record execution ('runtime' | 'legacy' | 'external'). Recorded at write time from the committed lane decision; never inferred later. 'external' marks a run a customer executed outside Runtype and reported through ingest. Null for rows written before attribution shipped and for units that never started executing.","title":"V1SchedulesBatchBatchIdResultsGetResponsesContentApplicationJsonSchemaDataItemsExecutionEngine"},"V1SchedulesBatchBatchIdResultsGetResponsesContentApplicationJsonSchemaDataItemsRecord":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"}},"required":["id","name","type"],"title":"V1SchedulesBatchBatchIdResultsGetResponsesContentApplicationJsonSchemaDataItemsRecord"},"V1SchedulesBatchBatchIdResultsGetResponsesContentApplicationJsonSchemaDataItems":{"type":"object","properties":{"agentExecutionId":{"type":["string","null"]},"createdAt":{"type":"string"},"durationMs":{"type":["integer","null"]},"error":{"type":["string","null"]},"executedAt":{"type":["string","null"]},"executionEngine":{"$ref":"#/components/schemas/V1SchedulesBatchBatchIdResultsGetResponsesContentApplicationJsonSchemaDataItemsExecutionEngine","description":"Engine that actually executed this record execution ('runtime' | 'legacy' | 'external'). Recorded at write time from the committed lane decision; never inferred later. 'external' marks a run a customer executed outside Runtype and reported through ingest. Null for rows written before attribution shipped and for units that never started executing."},"failedAt":{"type":["string","null"]},"failedStepCount":{"type":["integer","null"]},"flowId":{"type":["string","null"]},"flowName":{"type":["string","null"]},"record":{"oneOf":[{"$ref":"#/components/schemas/V1SchedulesBatchBatchIdResultsGetResponsesContentApplicationJsonSchemaDataItemsRecord"},{"type":"null"}]},"recordId":{"type":"string"},"recordResultId":{"type":["string","null"]},"result":{"description":"Any type"},"status":{"type":"string"},"stepCount":{"type":["integer","null"]}},"required":["agentExecutionId","createdAt","durationMs","error","executedAt","failedAt","failedStepCount","flowId","flowName","record","recordId","recordResultId","status","stepCount"],"title":"V1SchedulesBatchBatchIdResultsGetResponsesContentApplicationJsonSchemaDataItems"},"V1SchedulesBatchBatchIdResultsGetResponsesContentApplicationJsonSchemaPagination":{"type":"object","properties":{"hasMore":{"type":"boolean"},"limit":{"type":"integer"},"offset":{"type":"integer"},"total":{"type":"integer"}},"required":["hasMore","limit","offset","total"],"title":"V1SchedulesBatchBatchIdResultsGetResponsesContentApplicationJsonSchemaPagination"},"V1SchedulesBatchBatchIdResultsGetResponsesContentApplicationJsonSchemaSummary":{"type":"object","properties":{"recordsWithFailedSteps":{"type":"integer"}},"required":["recordsWithFailedSteps"],"title":"V1SchedulesBatchBatchIdResultsGetResponsesContentApplicationJsonSchemaSummary"},"Schedules_getResultsForABatchExecution_Response_200":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1SchedulesBatchBatchIdResultsGetResponsesContentApplicationJsonSchemaDataItems"}},"pagination":{"$ref":"#/components/schemas/V1SchedulesBatchBatchIdResultsGetResponsesContentApplicationJsonSchemaPagination"},"summary":{"$ref":"#/components/schemas/V1SchedulesBatchBatchIdResultsGetResponsesContentApplicationJsonSchemaSummary"}},"required":["data","pagination"],"title":"Schedules_getResultsForABatchExecution_Response_200"},"ScheduleEnsureDefinitionExecutionOptionsLoggingPolicy":{"type":"string","enum":["default","on","off"],"title":"ScheduleEnsureDefinitionExecutionOptionsLoggingPolicy"},"ScheduleEnsureDefinitionExecutionOptions":{"type":"object","properties":{"chunkSize":{"type":"integer","minimum":1,"maximum":250},"flowTimeoutMs":{"type":"integer","minimum":1000,"maximum":900000},"loggingPolicy":{"$ref":"#/components/schemas/ScheduleEnsureDefinitionExecutionOptionsLoggingPolicy"},"maxRetries":{"type":"integer","minimum":0,"maximum":10},"modelOverride":{"type":"string"},"progressFlushSize":{"type":"integer","minimum":1,"maximum":100},"recordConcurrency":{"type":"integer","minimum":1,"maximum":50},"skipCacheWarm":{"type":"boolean"},"stepTimeoutMs":{"type":"integer","minimum":1000,"maximum":600000},"timeoutMs":{"type":"integer","minimum":60000,"maximum":1800000}},"title":"ScheduleEnsureDefinitionExecutionOptions"},"ScheduleEnsureTarget":{"type":"object","properties":{"agentId":{"type":"string"},"agentName":{"type":"string","minLength":1,"maxLength":255},"flowId":{"type":"string"},"flowName":{"type":"string","minLength":1,"maxLength":255}},"title":"ScheduleEnsureTarget"},"ScheduleEnsureDefinitionTriggerType":{"type":"string","enum":["recurring","one_time"],"title":"ScheduleEnsureDefinitionTriggerType"},"ScheduleEnsureDefinitionTrigger":{"type":"object","properties":{"cron":{"type":"string","minLength":1},"runAt":{"type":"string","format":"date-time"},"timezone":{"type":"string","minLength":1},"type":{"$ref":"#/components/schemas/ScheduleEnsureDefinitionTriggerType"}},"required":["type"],"title":"ScheduleEnsureDefinitionTrigger"},"ScheduleEnsureDefinition":{"type":"object","properties":{"enabled":{"type":"boolean","description":"Omit to leave the current paused/active state untouched; new schedules start enabled."},"executionOptions":{"$ref":"#/components/schemas/ScheduleEnsureDefinitionExecutionOptions"},"inputs":{"type":"object","additionalProperties":{"description":"Any type"}},"messages":{"type":"array","items":{"type":"object","additionalProperties":{"description":"Any type"}}},"name":{"type":"string","minLength":1,"maxLength":255},"recordFilter":{"type":"object","additionalProperties":{"description":"Any type"}},"recordIds":{"type":"array","items":{"type":"string"}},"recordType":{"type":"string","minLength":1},"target":{"$ref":"#/components/schemas/ScheduleEnsureTarget"},"trigger":{"$ref":"#/components/schemas/ScheduleEnsureDefinitionTrigger"}},"required":["name","target","trigger"],"title":"ScheduleEnsureDefinition"},"V1SchedulesEnsurePostRequestBodyContentApplicationJsonSchemaOnConflict":{"type":"string","enum":["error","overwrite"],"title":"V1SchedulesEnsurePostRequestBodyContentApplicationJsonSchemaOnConflict"},"ScheduleEnsureResponseOneOf0Result":{"type":"string","enum":["unchanged","created","updated"],"title":"ScheduleEnsureResponseOneOf0Result"},"ScheduleEnsureResponse0":{"type":"object","properties":{"contentHash":{"type":"string","description":"Server-computed canonical content hash. Clients should echo this hash in probes."},"result":{"$ref":"#/components/schemas/ScheduleEnsureResponseOneOf0Result"},"scheduleId":{"type":"string"}},"required":["contentHash","result","scheduleId"],"title":"ScheduleEnsureResponse0"},"ScheduleEnsureResponseOneOf1Result":{"type":"string","enum":["definitionRequired"],"title":"ScheduleEnsureResponseOneOf1Result"},"ScheduleEnsureResponse1":{"type":"object","properties":{"result":{"$ref":"#/components/schemas/ScheduleEnsureResponseOneOf1Result"}},"required":["result"],"title":"ScheduleEnsureResponse1"},"ScheduleEnsureResponseOneOf2Changes":{"type":"string","enum":["none","create","update"],"title":"ScheduleEnsureResponseOneOf2Changes"},"ScheduleEnsureResponseOneOf2Result":{"type":"string","enum":["plan"],"title":"ScheduleEnsureResponseOneOf2Result"},"ScheduleEnsureResponse2":{"type":"object","properties":{"changedKeys":{"type":"array","items":{"type":"string"}},"changes":{"$ref":"#/components/schemas/ScheduleEnsureResponseOneOf2Changes"},"contentHash":{"type":"string"},"remoteHash":{"type":"string"},"result":{"$ref":"#/components/schemas/ScheduleEnsureResponseOneOf2Result"},"scheduleId":{"type":"string"}},"required":["changedKeys","changes","contentHash","result"],"title":"ScheduleEnsureResponse2"},"ScheduleEnsureResponse":{"oneOf":[{"$ref":"#/components/schemas/ScheduleEnsureResponse0"},{"$ref":"#/components/schemas/ScheduleEnsureResponse1"},{"$ref":"#/components/schemas/ScheduleEnsureResponse2"}],"title":"ScheduleEnsureResponse"},"ScheduleEnsureConflictCode":{"type":"string","enum":["external_modification","remote_changed"],"title":"ScheduleEnsureConflictCode"},"ScheduleEnsureConflict":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/ScheduleEnsureConflictCode"},"currentHash":{"type":["string","null"]},"error":{"type":"string"},"lastModifiedSource":{"type":"string"},"modifiedAt":{"type":["string","null"]}},"required":["code","error"],"title":"ScheduleEnsureConflict"},"ScheduleEnsureHashMismatchCode":{"type":"string","enum":["content_hash_mismatch"],"title":"ScheduleEnsureHashMismatchCode"},"ScheduleEnsureHashMismatch":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/ScheduleEnsureHashMismatchCode"},"contentHash":{"type":"string","description":"The server-computed canonical hash of the submitted definition."},"error":{"type":"string"}},"required":["code","contentHash","error"],"title":"ScheduleEnsureHashMismatch"},"SchedulePullResponse":{"type":"object","properties":{"contentHash":{"type":"string"},"definition":{"$ref":"#/components/schemas/ScheduleEnsureDefinition"},"lastModifiedSource":{"type":["string","null"]},"scheduleId":{"type":"string"},"updatedAt":{"type":["string","null"]}},"required":["contentHash","definition","lastModifiedSource","scheduleId","updatedAt"],"title":"SchedulePullResponse"},"V1SchedulesRunsAllGetParametersDirection":{"type":"string","enum":["next","prev"],"title":"V1SchedulesRunsAllGetParametersDirection"},"ScheduleRunLinkKind":{"type":"string","enum":["run","records","none"],"description":"run: one execution, readable at GET /v1/runs/{executionId}. records: a batch, whose per-record runs are GET /v1/runs?batchExecutionId=. none: no readable run was recorded for this scheduled run.","title":"ScheduleRunLinkKind"},"ScheduleRunLink":{"type":"object","properties":{"agentExecutionRowId":{"type":["string","null"],"description":"The agent_executions ROW id the scheduled run stored. Provenance only: a different id space from executionId, and never a /v1/runs key."},"batchExecutionId":{"type":["string","null"],"description":"The batch whose per-record runs are GET /v1/runs?batchExecutionId=."},"executionId":{"type":["string","null"],"description":"The RUNTIME execution id, which is what GET /v1/runs/{executionId} keys on. Null unless kind is run."},"kind":{"$ref":"#/components/schemas/ScheduleRunLinkKind","description":"run: one execution, readable at GET /v1/runs/{executionId}. records: a batch, whose per-record runs are GET /v1/runs?batchExecutionId=. none: no readable run was recorded for this scheduled run."}},"required":["agentExecutionRowId","batchExecutionId","executionId","kind"],"title":"ScheduleRunLink"},"V1SchedulesRunsAllGetResponsesContentApplicationJsonSchemaDataItems":{"type":"object","properties":{"agentExecutionId":{"type":["string","null"]},"agentId":{"type":["string","null"]},"batchExecutionId":{"type":["string","null"]},"completedAt":{"type":["string","null"]},"createdAt":{"type":"string"},"error":{"type":["string","null"]},"failedRecords":{"type":["integer","null"]},"flowId":{"type":["string","null"]},"id":{"type":"string"},"processedRecords":{"type":["integer","null"]},"run":{"$ref":"#/components/schemas/ScheduleRunLink"},"scheduleId":{"type":"string"},"startedAt":{"type":["string","null"]},"status":{"type":"string"},"totalRecords":{"type":["integer","null"]}},"required":["agentExecutionId","agentId","batchExecutionId","completedAt","createdAt","error","failedRecords","flowId","id","processedRecords","run","scheduleId","startedAt","status","totalRecords"],"title":"V1SchedulesRunsAllGetResponsesContentApplicationJsonSchemaDataItems"},"Schedules_listAllScheduleRuns_Response_200":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1SchedulesRunsAllGetResponsesContentApplicationJsonSchemaDataItems"}},"pagination":{"$ref":"#/components/schemas/Pagination"}},"required":["data","pagination"],"title":"Schedules_listAllScheduleRuns_Response_200"},"V1SchedulesRunsRunIdResultsGetResponsesContentApplicationJsonSchemaDataItemsExecutionEngine":{"type":"string","enum":["runtime","legacy","external"],"description":"Engine that actually executed this record execution ('runtime' | 'legacy' | 'external'). Recorded at write time from the committed lane decision; never inferred later. 'external' marks a run a customer executed outside Runtype and reported through ingest. Null for rows written before attribution shipped and for units that never started executing.","title":"V1SchedulesRunsRunIdResultsGetResponsesContentApplicationJsonSchemaDataItemsExecutionEngine"},"V1SchedulesRunsRunIdResultsGetResponsesContentApplicationJsonSchemaDataItemsRecord":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"}},"required":["id","name","type"],"title":"V1SchedulesRunsRunIdResultsGetResponsesContentApplicationJsonSchemaDataItemsRecord"},"V1SchedulesRunsRunIdResultsGetResponsesContentApplicationJsonSchemaDataItems":{"type":"object","properties":{"agentExecutionId":{"type":["string","null"]},"createdAt":{"type":"string"},"durationMs":{"type":["integer","null"]},"error":{"type":["string","null"]},"executedAt":{"type":["string","null"]},"executionEngine":{"$ref":"#/components/schemas/V1SchedulesRunsRunIdResultsGetResponsesContentApplicationJsonSchemaDataItemsExecutionEngine","description":"Engine that actually executed this record execution ('runtime' | 'legacy' | 'external'). Recorded at write time from the committed lane decision; never inferred later. 'external' marks a run a customer executed outside Runtype and reported through ingest. Null for rows written before attribution shipped and for units that never started executing."},"failedAt":{"type":["string","null"]},"failedStepCount":{"type":["integer","null"]},"flowId":{"type":["string","null"]},"flowName":{"type":["string","null"]},"record":{"oneOf":[{"$ref":"#/components/schemas/V1SchedulesRunsRunIdResultsGetResponsesContentApplicationJsonSchemaDataItemsRecord"},{"type":"null"}]},"recordId":{"type":"string"},"recordResultId":{"type":["string","null"]},"result":{"description":"Any type"},"status":{"type":"string"},"stepCount":{"type":["integer","null"]}},"required":["agentExecutionId","createdAt","durationMs","error","executedAt","failedAt","failedStepCount","flowId","flowName","record","recordId","recordResultId","status","stepCount"],"title":"V1SchedulesRunsRunIdResultsGetResponsesContentApplicationJsonSchemaDataItems"},"V1SchedulesRunsRunIdResultsGetResponsesContentApplicationJsonSchemaPagination":{"type":"object","properties":{"hasMore":{"type":"boolean"},"limit":{"type":"integer"},"offset":{"type":"integer"},"total":{"type":"integer"}},"required":["hasMore","limit","offset","total"],"title":"V1SchedulesRunsRunIdResultsGetResponsesContentApplicationJsonSchemaPagination"},"V1SchedulesRunsRunIdResultsGetResponsesContentApplicationJsonSchemaSummary":{"type":"object","properties":{"recordsWithFailedSteps":{"type":"integer"}},"required":["recordsWithFailedSteps"],"title":"V1SchedulesRunsRunIdResultsGetResponsesContentApplicationJsonSchemaSummary"},"Schedules_getResultsForAScheduledRun_Response_200":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1SchedulesRunsRunIdResultsGetResponsesContentApplicationJsonSchemaDataItems"}},"pagination":{"$ref":"#/components/schemas/V1SchedulesRunsRunIdResultsGetResponsesContentApplicationJsonSchemaPagination"},"summary":{"$ref":"#/components/schemas/V1SchedulesRunsRunIdResultsGetResponsesContentApplicationJsonSchemaSummary"}},"required":["data","pagination"],"title":"Schedules_getResultsForAScheduledRun_Response_200"},"V1SchedulesSparklinesGetResponsesContentApplicationJsonSchemaDataItemsLast7DaysItems":{"type":"object","properties":{"date":{"type":"string"},"failed":{"type":"integer"},"runs":{"type":"integer"}},"required":["date","failed","runs"],"title":"V1SchedulesSparklinesGetResponsesContentApplicationJsonSchemaDataItemsLast7DaysItems"},"V1SchedulesSparklinesGetResponsesContentApplicationJsonSchemaDataItems":{"type":"object","properties":{"last7Days":{"type":"array","items":{"$ref":"#/components/schemas/V1SchedulesSparklinesGetResponsesContentApplicationJsonSchemaDataItemsLast7DaysItems"}},"scheduleId":{"type":"string"}},"required":["last7Days","scheduleId"],"title":"V1SchedulesSparklinesGetResponsesContentApplicationJsonSchemaDataItems"},"Schedules_getScheduleSparklines_Response_200":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1SchedulesSparklinesGetResponsesContentApplicationJsonSchemaDataItems"}}},"required":["data"],"title":"Schedules_getScheduleSparklines_Response_200"},"Schedules_getASchedule_Response_200":{"type":"object","properties":{"agentId":{"type":["string","null"]},"createdAt":{"type":"string"},"cron":{"type":["string","null"]},"enabled":{"type":"boolean"},"executionOptions":{"type":"object","additionalProperties":{"description":"Any type"}},"flowId":{"type":["string","null"]},"id":{"type":"string"},"inputs":{"type":["object","null"],"additionalProperties":{"description":"Any type"}},"lastRunAt":{"type":["string","null"]},"messages":{"description":"Any type"},"name":{"type":["string","null"]},"nextRunAt":{"type":["string","null"]},"organizationId":{"type":["string","null"]},"productSurfaceId":{"type":["string","null"]},"recordFilter":{"description":"Any type"},"recordIds":{"type":["array","null"],"items":{"type":"string"}},"recordType":{"type":["string","null"]},"runAt":{"type":["string","null"]},"timezone":{"type":["string","null"]},"triggerType":{"type":"string"},"updatedAt":{"type":"string"},"userId":{"type":"string"}},"required":["agentId","createdAt","cron","enabled","executionOptions","flowId","id","inputs","lastRunAt","name","nextRunAt","organizationId","productSurfaceId","recordIds","recordType","runAt","timezone","triggerType","updatedAt","userId"],"title":"Schedules_getASchedule_Response_200"},"V1SchedulesIdPutResponsesContentApplicationJsonSchemaStatus":{"type":"string","enum":["updated"],"title":"V1SchedulesIdPutResponsesContentApplicationJsonSchemaStatus"},"Schedules_updateASchedule_Response_200":{"type":"object","properties":{"id":{"type":"string"},"status":{"$ref":"#/components/schemas/V1SchedulesIdPutResponsesContentApplicationJsonSchemaStatus"}},"required":["id","status"],"title":"Schedules_updateASchedule_Response_200"},"Schedules_deleteASchedule_Response_200":{"type":"object","properties":{"success":{"type":"boolean"}},"required":["success"],"title":"Schedules_deleteASchedule_Response_200"},"V1SchedulesIdPausePostResponsesContentApplicationJsonSchemaStatus":{"type":"string","enum":["paused"],"title":"V1SchedulesIdPausePostResponsesContentApplicationJsonSchemaStatus"},"Schedules_pauseASchedule_Response_200":{"type":"object","properties":{"status":{"$ref":"#/components/schemas/V1SchedulesIdPausePostResponsesContentApplicationJsonSchemaStatus"}},"required":["status"],"title":"Schedules_pauseASchedule_Response_200"},"V1SchedulesIdResumePostResponsesContentApplicationJsonSchemaStatus":{"type":"string","enum":["resumed"],"title":"V1SchedulesIdResumePostResponsesContentApplicationJsonSchemaStatus"},"Schedules_resumeASchedule_Response_200":{"type":"object","properties":{"status":{"$ref":"#/components/schemas/V1SchedulesIdResumePostResponsesContentApplicationJsonSchemaStatus"}},"required":["status"],"title":"Schedules_resumeASchedule_Response_200"},"V1SchedulesIdRunNowPostResponsesContentApplicationJsonSchemaStatus":{"type":"string","enum":["queued","completed","failed"],"title":"V1SchedulesIdRunNowPostResponsesContentApplicationJsonSchemaStatus"},"Schedules_runAScheduleImmediately_Response_200":{"type":"object","properties":{"batchExecutionId":{"type":["string","null"]},"error":{"type":["string","null"]},"runId":{"type":["string","null"]},"status":{"$ref":"#/components/schemas/V1SchedulesIdRunNowPostResponsesContentApplicationJsonSchemaStatus"}},"required":["batchExecutionId","error","runId","status"],"title":"Schedules_runAScheduleImmediately_Response_200"},"V1SchedulesIdRunsGetResponsesContentApplicationJsonSchemaDataItems":{"type":"object","properties":{"agentExecutionId":{"type":["string","null"]},"agentId":{"type":["string","null"]},"batchExecutionId":{"type":["string","null"]},"completedAt":{"type":["string","null"]},"createdAt":{"type":"string"},"error":{"type":["string","null"]},"failedRecords":{"type":["integer","null"]},"flowId":{"type":["string","null"]},"id":{"type":"string"},"processedRecords":{"type":["integer","null"]},"run":{"$ref":"#/components/schemas/ScheduleRunLink"},"scheduleId":{"type":"string"},"startedAt":{"type":["string","null"]},"status":{"type":"string"},"totalRecords":{"type":["integer","null"]}},"required":["agentExecutionId","agentId","batchExecutionId","completedAt","createdAt","error","failedRecords","flowId","id","processedRecords","run","scheduleId","startedAt","status","totalRecords"],"title":"V1SchedulesIdRunsGetResponsesContentApplicationJsonSchemaDataItems"},"Schedules_listRunsForASchedule_Response_200":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1SchedulesIdRunsGetResponsesContentApplicationJsonSchemaDataItems"}},"hasMore":{"type":"boolean"},"nextCursor":{"type":["string","null"]}},"required":["data","hasMore","nextCursor"],"title":"Schedules_listRunsForASchedule_Response_200"},"V1SchedulesIdStatsGetResponsesContentApplicationJsonSchemaLast7DaysItems":{"type":"object","properties":{"date":{"type":"string"},"failed":{"type":"integer"},"runs":{"type":"integer"}},"required":["date","failed","runs"],"title":"V1SchedulesIdStatsGetResponsesContentApplicationJsonSchemaLast7DaysItems"},"Schedules_getScheduleStatistics_Response_200":{"type":"object","properties":{"avgBilledCostUsd":{"type":["number","null"],"format":"double","description":"Exact average raw Runtype-funded provider and hosted-tool cost before account margin over the same run count, or null when the split is unavailable."},"avgCostUsd":{"type":["number","null"],"format":"double"},"avgDurationMs":{"type":["number","null"],"format":"double"},"avgSelfReportedCostUsd":{"type":["number","null"],"format":"double","description":"Portion of avgCostUsd asserted by externally-run agents pushed to /v1/executions/ingest, over the same run count. Unverified: Runtype neither dispatched nor paid for it. 0 unless external runs were ingested."},"completed":{"type":"integer"},"failed":{"type":"integer"},"last7Days":{"type":"array","items":{"$ref":"#/components/schemas/V1SchedulesIdStatsGetResponsesContentApplicationJsonSchemaLast7DaysItems"}},"successRate":{"type":["number","null"],"format":"double"},"total":{"type":"integer"},"unpricedExecutions":{"type":"integer","description":"Count of rows behind these costs that recorded no cost figure. Their contribution is 0 because the cost is unknown, not because it was free."}},"required":["avgBilledCostUsd","avgCostUsd","avgDurationMs","avgSelfReportedCostUsd","completed","failed","last7Days","successRate","total","unpricedExecutions"],"title":"Schedules_getScheduleStatistics_Response_200"},"V1SecretsGetResponsesContentApplicationJsonSchemaDataItems":{"type":"object","properties":{"createdAt":{"type":"string"},"description":{"type":["string","null"]},"docsUrl":{"type":["string","null"],"description":"Optional acquisition link (https only) for the provider console where this credential is created."},"endUserId":{"type":["string","null"],"description":"End User scope (eu_*) when the secret is end-user-scoped; null otherwise."},"id":{"type":"string"},"key":{"type":"string"},"lastRotatedAt":{"type":["string","null"]},"phantomToken":{"type":["string","null"]},"productTenantId":{"type":["string","null"],"description":"Product Tenant scope (tnt_*) when the secret is tenant-scoped; null for org-level."},"status":{"type":"string"},"updatedAt":{"type":"string"},"valuePreview":{"type":["string","null"]},"version":{"type":"integer"}},"required":["createdAt","description","endUserId","id","key","lastRotatedAt","phantomToken","productTenantId","status","updatedAt","valuePreview","version"],"title":"V1SecretsGetResponsesContentApplicationJsonSchemaDataItems"},"Secrets_listSecretsMetadataOnly_Response_200":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1SecretsGetResponsesContentApplicationJsonSchemaDataItems"}},"total":{"type":"integer"}},"required":["data","total"],"title":"Secrets_listSecretsMetadataOnly_Response_200"},"V1SecretsPostResponsesContentApplicationJsonSchemaData":{"type":"object","properties":{"createdAt":{"type":"string"},"description":{"type":["string","null"]},"docsUrl":{"type":["string","null"],"description":"Optional acquisition link (https only) for the provider console where this credential is created."},"endUserId":{"type":["string","null"],"description":"End User scope (eu_*) when the secret is end-user-scoped; null otherwise."},"id":{"type":"string"},"key":{"type":"string"},"lastRotatedAt":{"type":["string","null"]},"phantomToken":{"type":["string","null"]},"productTenantId":{"type":["string","null"],"description":"Product Tenant scope (tnt_*) when the secret is tenant-scoped; null for org-level."},"status":{"type":"string"},"updatedAt":{"type":"string"},"valuePreview":{"type":["string","null"]},"version":{"type":"integer"}},"required":["createdAt","description","endUserId","id","key","lastRotatedAt","phantomToken","productTenantId","status","updatedAt","valuePreview","version"],"title":"V1SecretsPostResponsesContentApplicationJsonSchemaData"},"Secrets_createASecret_Response_201":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/V1SecretsPostResponsesContentApplicationJsonSchemaData"}},"required":["data"],"title":"Secrets_createASecret_Response_201"},"V1SecretsPostResponsesContentApplicationJsonSchemaDetailsItems":{"type":"object","properties":{"code":{"type":"string","description":"Stable Runtype validation code (e.g. MISSING_REQUIRED_FIELD, INVALID_ENUM)."},"message":{"type":"string"},"path":{"type":"string","description":"Dotted JSON path to the offending field."},"suggestion":{"type":"string","description":"Actionable hint (allowed values, accepted range, …)."}},"required":["message"],"title":"V1SecretsPostResponsesContentApplicationJsonSchemaDetailsItems"},"CreateASecretRequestBadRequestError":{"type":"object","properties":{"code":{"type":"string","description":"Stable error code. `insufficient_scope` marks an API key that lacks a scope this request needs."},"details":{"type":"array","items":{"$ref":"#/components/schemas/V1SecretsPostResponsesContentApplicationJsonSchemaDetailsItems"}},"error":{"type":"string"},"requiredScopes":{"type":"array","items":{"type":"string"},"description":"On `insufficient_scope`: every API key scope this request needs."}},"required":["error"],"title":"CreateASecretRequestBadRequestError"},"Secrets_checkWhichSecretKeysExistAreMissingOrRevoked_Response_200":{"type":"object","properties":{"found":{"type":"array","items":{"type":"string"}},"missing":{"type":"array","items":{"type":"string"}},"revoked":{"type":"array","items":{"type":"string"}}},"required":["found","missing","revoked"],"title":"Secrets_checkWhichSecretKeysExistAreMissingOrRevoked_Response_200"},"V1SecretsCheckPostResponsesContentApplicationJsonSchemaDetailsItems":{"type":"object","properties":{"code":{"type":"string","description":"Stable Runtype validation code (e.g. MISSING_REQUIRED_FIELD, INVALID_ENUM)."},"message":{"type":"string"},"path":{"type":"string","description":"Dotted JSON path to the offending field."},"suggestion":{"type":"string","description":"Actionable hint (allowed values, accepted range, …)."}},"required":["message"],"title":"V1SecretsCheckPostResponsesContentApplicationJsonSchemaDetailsItems"},"CheckWhichSecretKeysExistAreMissingOrRevokedRequestBadRequestError":{"type":"object","properties":{"code":{"type":"string","description":"Stable error code. `insufficient_scope` marks an API key that lacks a scope this request needs."},"details":{"type":"array","items":{"$ref":"#/components/schemas/V1SecretsCheckPostResponsesContentApplicationJsonSchemaDetailsItems"}},"error":{"type":"string"},"requiredScopes":{"type":"array","items":{"type":"string"},"description":"On `insufficient_scope`: every API key scope this request needs."}},"required":["error"],"title":"CheckWhichSecretKeysExistAreMissingOrRevokedRequestBadRequestError"},"V1SecretsIntakeManifestPostRequestBodyContentApplicationJsonSchemaSourceType":{"type":"string","enum":["manual","secret","product"],"title":"V1SecretsIntakeManifestPostRequestBodyContentApplicationJsonSchemaSourceType"},"V1SecretsIntakeManifestPostRequestBodyContentApplicationJsonSchemaSource":{"type":"object","properties":{"description":{"type":"string"},"key":{"type":"string"},"keys":{"type":"array","items":{"type":"string","minLength":1}},"productId":{"type":"string"},"type":{"$ref":"#/components/schemas/V1SecretsIntakeManifestPostRequestBodyContentApplicationJsonSchemaSourceType"}},"required":["type"],"title":"V1SecretsIntakeManifestPostRequestBodyContentApplicationJsonSchemaSource"},"V1SecretsIntakeManifestPostResponsesContentApplicationJsonSchemaConfigurationStatus":{"type":"string","enum":["configured","needs_configuration","revoked","invalid"],"title":"V1SecretsIntakeManifestPostResponsesContentApplicationJsonSchemaConfigurationStatus"},"V1SecretsIntakeManifestPostResponsesContentApplicationJsonSchemaHandoffOneOf0Type":{"type":"string","enum":["url"],"title":"V1SecretsIntakeManifestPostResponsesContentApplicationJsonSchemaHandoffOneOf0Type"},"V1SecretsIntakeManifestPostResponsesContentApplicationJsonSchemaHandoff0":{"type":"object","properties":{"expiresAt":{"type":"string"},"type":{"$ref":"#/components/schemas/V1SecretsIntakeManifestPostResponsesContentApplicationJsonSchemaHandoffOneOf0Type"},"url":{"type":"string"}},"required":["type","url"],"title":"V1SecretsIntakeManifestPostResponsesContentApplicationJsonSchemaHandoff0"},"V1SecretsIntakeManifestPostResponsesContentApplicationJsonSchemaHandoff":{"oneOf":[{"$ref":"#/components/schemas/V1SecretsIntakeManifestPostResponsesContentApplicationJsonSchemaHandoff0"}],"title":"V1SecretsIntakeManifestPostResponsesContentApplicationJsonSchemaHandoff"},"V1SecretsIntakeManifestPostResponsesContentApplicationJsonSchemaItemsItemsStatus":{"type":"string","enum":["configured","needs_configuration","revoked","invalid"],"title":"V1SecretsIntakeManifestPostResponsesContentApplicationJsonSchemaItemsItemsStatus"},"V1SecretsIntakeManifestPostResponsesContentApplicationJsonSchemaItemsItems":{"type":"object","properties":{"description":{"type":["string","null"]},"displayName":{"type":["string","null"]},"docsUrl":{"type":"string"},"helpText":{"type":"string"},"itemId":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean","default":true},"secretId":{"type":"string"},"secretKey":{"type":"string","minLength":1},"status":{"$ref":"#/components/schemas/V1SecretsIntakeManifestPostResponsesContentApplicationJsonSchemaItemsItemsStatus"},"version":{"type":"integer","minimum":0}},"required":["itemId","secretKey","status"],"title":"V1SecretsIntakeManifestPostResponsesContentApplicationJsonSchemaItemsItems"},"V1SecretsIntakeManifestPostResponsesContentApplicationJsonSchemaSourceType":{"type":"string","enum":["manual","secret","product"],"title":"V1SecretsIntakeManifestPostResponsesContentApplicationJsonSchemaSourceType"},"V1SecretsIntakeManifestPostResponsesContentApplicationJsonSchemaSource":{"type":"object","properties":{"description":{"type":"string"},"key":{"type":"string"},"keys":{"type":"array","items":{"type":"string","minLength":1}},"productId":{"type":"string"},"type":{"$ref":"#/components/schemas/V1SecretsIntakeManifestPostResponsesContentApplicationJsonSchemaSourceType"}},"required":["type"],"title":"V1SecretsIntakeManifestPostResponsesContentApplicationJsonSchemaSource"},"Secrets_getIntakeManifestForSecretConfiguration_Response_200":{"type":"object","properties":{"configurationStatus":{"$ref":"#/components/schemas/V1SecretsIntakeManifestPostResponsesContentApplicationJsonSchemaConfigurationStatus"},"description":{"type":"string"},"handoff":{"$ref":"#/components/schemas/V1SecretsIntakeManifestPostResponsesContentApplicationJsonSchemaHandoff"},"items":{"type":"array","items":{"$ref":"#/components/schemas/V1SecretsIntakeManifestPostResponsesContentApplicationJsonSchemaItemsItems"}},"pendingConfigurationCount":{"type":"integer","minimum":0},"returnUrl":{"type":"string"},"source":{"$ref":"#/components/schemas/V1SecretsIntakeManifestPostResponsesContentApplicationJsonSchemaSource"},"title":{"type":"string","minLength":1}},"required":["configurationStatus","items","pendingConfigurationCount","source","title"],"title":"Secrets_getIntakeManifestForSecretConfiguration_Response_200"},"V1SecretsIntakeManifestPostResponsesContentApplicationJsonSchemaDetailsItems":{"type":"object","properties":{"code":{"type":"string","description":"Stable Runtype validation code (e.g. MISSING_REQUIRED_FIELD, INVALID_ENUM)."},"message":{"type":"string"},"path":{"type":"string","description":"Dotted JSON path to the offending field."},"suggestion":{"type":"string","description":"Actionable hint (allowed values, accepted range, …)."}},"required":["message"],"title":"V1SecretsIntakeManifestPostResponsesContentApplicationJsonSchemaDetailsItems"},"GetIntakeManifestForSecretConfigurationRequestBadRequestError":{"type":"object","properties":{"code":{"type":"string","description":"Stable error code. `insufficient_scope` marks an API key that lacks a scope this request needs."},"details":{"type":"array","items":{"$ref":"#/components/schemas/V1SecretsIntakeManifestPostResponsesContentApplicationJsonSchemaDetailsItems"}},"error":{"type":"string"},"requiredScopes":{"type":"array","items":{"type":"string"},"description":"On `insufficient_scope`: every API key scope this request needs."}},"required":["error"],"title":"GetIntakeManifestForSecretConfigurationRequestBadRequestError"},"V1SecretsIntakeSubmitPostRequestBodyContentApplicationJsonSchemaItemsItems":{"type":"object","properties":{"description":{"type":"string"},"displayName":{"type":"string"},"docsUrl":{"type":"string","format":"uri","maxLength":2048},"expectedVersion":{"type":"integer","minimum":0},"itemId":{"type":"string"},"key":{"type":"string","minLength":2,"maxLength":100},"secretId":{"type":"string"},"value":{"type":"string"}},"title":"V1SecretsIntakeSubmitPostRequestBodyContentApplicationJsonSchemaItemsItems"},"V1SecretsIntakeSubmitPostRequestBodyContentApplicationJsonSchemaSourceType":{"type":"string","enum":["manual","secret","product"],"title":"V1SecretsIntakeSubmitPostRequestBodyContentApplicationJsonSchemaSourceType"},"V1SecretsIntakeSubmitPostRequestBodyContentApplicationJsonSchemaSource":{"type":"object","properties":{"description":{"type":"string"},"key":{"type":"string"},"keys":{"type":"array","items":{"type":"string","minLength":1}},"productId":{"type":"string"},"type":{"$ref":"#/components/schemas/V1SecretsIntakeSubmitPostRequestBodyContentApplicationJsonSchemaSourceType"}},"required":["type"],"title":"V1SecretsIntakeSubmitPostRequestBodyContentApplicationJsonSchemaSource"},"V1SecretsIntakeSubmitPostResponsesContentApplicationJsonSchemaManifestConfigurationStatus":{"type":"string","enum":["configured","needs_configuration","revoked","invalid"],"title":"V1SecretsIntakeSubmitPostResponsesContentApplicationJsonSchemaManifestConfigurationStatus"},"V1SecretsIntakeSubmitPostResponsesContentApplicationJsonSchemaManifestHandoffOneOf0Type":{"type":"string","enum":["url"],"title":"V1SecretsIntakeSubmitPostResponsesContentApplicationJsonSchemaManifestHandoffOneOf0Type"},"V1SecretsIntakeSubmitPostResponsesContentApplicationJsonSchemaManifestHandoff0":{"type":"object","properties":{"expiresAt":{"type":"string"},"type":{"$ref":"#/components/schemas/V1SecretsIntakeSubmitPostResponsesContentApplicationJsonSchemaManifestHandoffOneOf0Type"},"url":{"type":"string"}},"required":["type","url"],"title":"V1SecretsIntakeSubmitPostResponsesContentApplicationJsonSchemaManifestHandoff0"},"V1SecretsIntakeSubmitPostResponsesContentApplicationJsonSchemaManifestHandoff":{"oneOf":[{"$ref":"#/components/schemas/V1SecretsIntakeSubmitPostResponsesContentApplicationJsonSchemaManifestHandoff0"}],"title":"V1SecretsIntakeSubmitPostResponsesContentApplicationJsonSchemaManifestHandoff"},"V1SecretsIntakeSubmitPostResponsesContentApplicationJsonSchemaManifestItemsItemsStatus":{"type":"string","enum":["configured","needs_configuration","revoked","invalid"],"title":"V1SecretsIntakeSubmitPostResponsesContentApplicationJsonSchemaManifestItemsItemsStatus"},"V1SecretsIntakeSubmitPostResponsesContentApplicationJsonSchemaManifestItemsItems":{"type":"object","properties":{"description":{"type":["string","null"]},"displayName":{"type":["string","null"]},"docsUrl":{"type":"string"},"helpText":{"type":"string"},"itemId":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean","default":true},"secretId":{"type":"string"},"secretKey":{"type":"string","minLength":1},"status":{"$ref":"#/components/schemas/V1SecretsIntakeSubmitPostResponsesContentApplicationJsonSchemaManifestItemsItemsStatus"},"version":{"type":"integer","minimum":0}},"required":["itemId","secretKey","status"],"title":"V1SecretsIntakeSubmitPostResponsesContentApplicationJsonSchemaManifestItemsItems"},"V1SecretsIntakeSubmitPostResponsesContentApplicationJsonSchemaManifestSourceType":{"type":"string","enum":["manual","secret","product"],"title":"V1SecretsIntakeSubmitPostResponsesContentApplicationJsonSchemaManifestSourceType"},"V1SecretsIntakeSubmitPostResponsesContentApplicationJsonSchemaManifestSource":{"type":"object","properties":{"description":{"type":"string"},"key":{"type":"string"},"keys":{"type":"array","items":{"type":"string","minLength":1}},"productId":{"type":"string"},"type":{"$ref":"#/components/schemas/V1SecretsIntakeSubmitPostResponsesContentApplicationJsonSchemaManifestSourceType"}},"required":["type"],"title":"V1SecretsIntakeSubmitPostResponsesContentApplicationJsonSchemaManifestSource"},"V1SecretsIntakeSubmitPostResponsesContentApplicationJsonSchemaManifest":{"type":"object","properties":{"configurationStatus":{"$ref":"#/components/schemas/V1SecretsIntakeSubmitPostResponsesContentApplicationJsonSchemaManifestConfigurationStatus"},"description":{"type":"string"},"handoff":{"$ref":"#/components/schemas/V1SecretsIntakeSubmitPostResponsesContentApplicationJsonSchemaManifestHandoff"},"items":{"type":"array","items":{"$ref":"#/components/schemas/V1SecretsIntakeSubmitPostResponsesContentApplicationJsonSchemaManifestItemsItems"}},"pendingConfigurationCount":{"type":"integer","minimum":0},"returnUrl":{"type":"string"},"source":{"$ref":"#/components/schemas/V1SecretsIntakeSubmitPostResponsesContentApplicationJsonSchemaManifestSource"},"title":{"type":"string","minLength":1}},"required":["configurationStatus","items","pendingConfigurationCount","source","title"],"title":"V1SecretsIntakeSubmitPostResponsesContentApplicationJsonSchemaManifest"},"Secrets_submitSecretValuesFromIntakeScreen_Response_200":{"type":"object","properties":{"manifest":{"$ref":"#/components/schemas/V1SecretsIntakeSubmitPostResponsesContentApplicationJsonSchemaManifest"},"success":{"type":"boolean"}},"required":["manifest","success"],"title":"Secrets_submitSecretValuesFromIntakeScreen_Response_200"},"V1SecretsIntakeSubmitPostResponsesContentApplicationJsonSchemaDetailsItems":{"type":"object","properties":{"code":{"type":"string","description":"Stable Runtype validation code (e.g. MISSING_REQUIRED_FIELD, INVALID_ENUM)."},"message":{"type":"string"},"path":{"type":"string","description":"Dotted JSON path to the offending field."},"suggestion":{"type":"string","description":"Actionable hint (allowed values, accepted range, …)."}},"required":["message"],"title":"V1SecretsIntakeSubmitPostResponsesContentApplicationJsonSchemaDetailsItems"},"SubmitSecretValuesFromIntakeScreenRequestBadRequestError":{"type":"object","properties":{"code":{"type":"string","description":"Stable error code. `insufficient_scope` marks an API key that lacks a scope this request needs."},"details":{"type":"array","items":{"$ref":"#/components/schemas/V1SecretsIntakeSubmitPostResponsesContentApplicationJsonSchemaDetailsItems"}},"error":{"type":"string"},"requiredScopes":{"type":"array","items":{"type":"string"},"description":"On `insufficient_scope`: every API key scope this request needs."},"itemId":{"type":"string"}},"required":["error"],"title":"SubmitSecretValuesFromIntakeScreenRequestBadRequestError"},"V1SecretsSetupUrlPostRequestBodyContentApplicationJsonSchemaContextType":{"type":"string","enum":["product","agent","tool"],"title":"V1SecretsSetupUrlPostRequestBodyContentApplicationJsonSchemaContextType"},"V1SecretsSetupUrlPostRequestBodyContentApplicationJsonSchemaContext":{"type":"object","properties":{"id":{"type":"string"},"type":{"$ref":"#/components/schemas/V1SecretsSetupUrlPostRequestBodyContentApplicationJsonSchemaContextType"}},"required":["id","type"],"title":"V1SecretsSetupUrlPostRequestBodyContentApplicationJsonSchemaContext"},"Secrets_generateDashboardUrlForConfiguringMissingSecrets_Response_200":{"type":"object","properties":{"alreadyConfigured":{"type":"array","items":{"type":"string"}},"missing":{"type":"array","items":{"type":"string"}},"revoked":{"type":"array","items":{"type":"string"}},"url":{"type":["string","null"]}},"required":["alreadyConfigured","missing","revoked","url"],"title":"Secrets_generateDashboardUrlForConfiguringMissingSecrets_Response_200"},"V1SecretsSetupUrlPostResponsesContentApplicationJsonSchemaDetailsItems":{"type":"object","properties":{"code":{"type":"string","description":"Stable Runtype validation code (e.g. MISSING_REQUIRED_FIELD, INVALID_ENUM)."},"message":{"type":"string"},"path":{"type":"string","description":"Dotted JSON path to the offending field."},"suggestion":{"type":"string","description":"Actionable hint (allowed values, accepted range, …)."}},"required":["message"],"title":"V1SecretsSetupUrlPostResponsesContentApplicationJsonSchemaDetailsItems"},"GenerateDashboardUrlForConfiguringMissingSecretsRequestBadRequestError":{"type":"object","properties":{"code":{"type":"string","description":"Stable error code. `insufficient_scope` marks an API key that lacks a scope this request needs."},"details":{"type":"array","items":{"$ref":"#/components/schemas/V1SecretsSetupUrlPostResponsesContentApplicationJsonSchemaDetailsItems"}},"error":{"type":"string"},"requiredScopes":{"type":"array","items":{"type":"string"},"description":"On `insufficient_scope`: every API key scope this request needs."}},"required":["error"],"title":"GenerateDashboardUrlForConfiguringMissingSecretsRequestBadRequestError"},"V1SecretsIdGetResponsesContentApplicationJsonSchemaData":{"type":"object","properties":{"createdAt":{"type":"string"},"description":{"type":["string","null"]},"docsUrl":{"type":["string","null"],"description":"Optional acquisition link (https only) for the provider console where this credential is created."},"endUserId":{"type":["string","null"],"description":"End User scope (eu_*) when the secret is end-user-scoped; null otherwise."},"id":{"type":"string"},"key":{"type":"string"},"lastRotatedAt":{"type":["string","null"]},"phantomToken":{"type":["string","null"]},"productTenantId":{"type":["string","null"],"description":"Product Tenant scope (tnt_*) when the secret is tenant-scoped; null for org-level."},"status":{"type":"string"},"updatedAt":{"type":"string"},"valuePreview":{"type":["string","null"]},"version":{"type":"integer"}},"required":["createdAt","description","endUserId","id","key","lastRotatedAt","phantomToken","productTenantId","status","updatedAt","valuePreview","version"],"title":"V1SecretsIdGetResponsesContentApplicationJsonSchemaData"},"Secrets_getSecretMetadata_Response_200":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/V1SecretsIdGetResponsesContentApplicationJsonSchemaData"}},"required":["data"],"title":"Secrets_getSecretMetadata_Response_200"},"V1SecretsIdPutResponsesContentApplicationJsonSchemaData":{"type":"object","properties":{"createdAt":{"type":"string"},"description":{"type":["string","null"]},"docsUrl":{"type":["string","null"],"description":"Optional acquisition link (https only) for the provider console where this credential is created."},"endUserId":{"type":["string","null"],"description":"End User scope (eu_*) when the secret is end-user-scoped; null otherwise."},"id":{"type":"string"},"key":{"type":"string"},"lastRotatedAt":{"type":["string","null"]},"phantomToken":{"type":["string","null"]},"productTenantId":{"type":["string","null"],"description":"Product Tenant scope (tnt_*) when the secret is tenant-scoped; null for org-level."},"status":{"type":"string"},"updatedAt":{"type":"string"},"valuePreview":{"type":["string","null"]},"version":{"type":"integer"}},"required":["createdAt","description","endUserId","id","key","lastRotatedAt","phantomToken","productTenantId","status","updatedAt","valuePreview","version"],"title":"V1SecretsIdPutResponsesContentApplicationJsonSchemaData"},"Secrets_updateOrRotateASecret_Response_200":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/V1SecretsIdPutResponsesContentApplicationJsonSchemaData"}},"required":["data"],"title":"Secrets_updateOrRotateASecret_Response_200"},"V1SecretsIdPutResponsesContentApplicationJsonSchemaDetailsItems":{"type":"object","properties":{"code":{"type":"string","description":"Stable Runtype validation code (e.g. MISSING_REQUIRED_FIELD, INVALID_ENUM)."},"message":{"type":"string"},"path":{"type":"string","description":"Dotted JSON path to the offending field."},"suggestion":{"type":"string","description":"Actionable hint (allowed values, accepted range, …)."}},"required":["message"],"title":"V1SecretsIdPutResponsesContentApplicationJsonSchemaDetailsItems"},"UpdateOrRotateASecretRequestBadRequestError":{"type":"object","properties":{"code":{"type":"string","description":"Stable error code. `insufficient_scope` marks an API key that lacks a scope this request needs."},"details":{"type":"array","items":{"$ref":"#/components/schemas/V1SecretsIdPutResponsesContentApplicationJsonSchemaDetailsItems"}},"error":{"type":"string"},"requiredScopes":{"type":"array","items":{"type":"string"},"description":"On `insufficient_scope`: every API key scope this request needs."}},"required":["error"],"title":"UpdateOrRotateASecretRequestBadRequestError"},"Secrets_deleteASecret_Response_200":{"type":"object","properties":{"deletedId":{"type":"string"},"referenceCount":{"type":"integer"},"success":{"type":"boolean"}},"required":["deletedId","referenceCount","success"],"title":"Secrets_deleteASecret_Response_200"},"V1SignalBindingsGetParametersIncludeDisabled":{"type":"string","enum":["true","false"],"title":"V1SignalBindingsGetParametersIncludeDisabled"},"SignalBindingTargetKind":{"type":"string","enum":["agent"],"title":"SignalBindingTargetKind"},"SignalBindingTarget":{"type":"object","properties":{"id":{"type":"string"},"kind":{"$ref":"#/components/schemas/SignalBindingTargetKind"}},"required":["id","kind"],"title":"SignalBindingTarget"},"SignalBinding":{"type":"object","properties":{"coverage":{"type":"object","additionalProperties":{"description":"Any type"}},"createdAt":{"type":"string"},"disabledAt":{"type":["string","null"]},"enabled":{"type":"boolean"},"externalProcessingAcknowledgedAt":{"type":["string","null"]},"filter":{"type":"object","additionalProperties":{"description":"Any type"}},"id":{"type":"string"},"implicit":{"type":"boolean","description":"Created by the platform: the failure detector on a uniform 5% sample. Unbinding it records an opt-out (enabled false) and it is not recreated; an explicit failure_detector binding replaces it."},"signalSetId":{"type":"string"},"signalSetName":{"type":"string"},"signalSetVersionId":{"type":"string"},"target":{"$ref":"#/components/schemas/SignalBindingTarget"},"uniformShare":{"type":"number","format":"double"},"versionNumber":{"type":"integer"}},"required":["coverage","createdAt","disabledAt","enabled","externalProcessingAcknowledgedAt","filter","id","implicit","signalSetId","signalSetVersionId","target","uniformShare"],"title":"SignalBinding"},"Signals_listSignalBindings_Response_200":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/SignalBinding"}}},"required":["data"],"title":"Signals_listSignalBindings_Response_200"},"SignalError":{"type":"object","properties":{"code":{"type":"string","description":"Stable code, e.g. SIGNAL_SET_INVALID or SIGNALS_EXTERNAL_PROCESSING_UNACKNOWLEDGED."},"details":{"type":"object","additionalProperties":{"description":"Any type"}},"error":{"type":"string"},"requiredScopes":{"type":"array","items":{"type":"string"},"description":"On `insufficient_scope`: every API key scope this request needs."}},"required":["error"],"title":"SignalError"},"V1SignalBindingsPostRequestBodyContentApplicationJsonSchemaCoverageOneOf0Mode":{"type":"string","enum":["all"],"title":"V1SignalBindingsPostRequestBodyContentApplicationJsonSchemaCoverageOneOf0Mode"},"V1SignalBindingsPostRequestBodyContentApplicationJsonSchemaCoverage0":{"type":"object","properties":{"mode":{"$ref":"#/components/schemas/V1SignalBindingsPostRequestBodyContentApplicationJsonSchemaCoverageOneOf0Mode"}},"required":["mode"],"title":"V1SignalBindingsPostRequestBodyContentApplicationJsonSchemaCoverage0"},"V1SignalBindingsPostRequestBodyContentApplicationJsonSchemaCoverageOneOf1Mode":{"type":"string","enum":["sample"],"title":"V1SignalBindingsPostRequestBodyContentApplicationJsonSchemaCoverageOneOf1Mode"},"V1SignalBindingsPostRequestBodyContentApplicationJsonSchemaCoverage1":{"type":"object","properties":{"mode":{"$ref":"#/components/schemas/V1SignalBindingsPostRequestBodyContentApplicationJsonSchemaCoverageOneOf1Mode"},"rate":{"type":"number","format":"double","maximum":1,"exclusiveMinimum":0}},"required":["mode","rate"],"title":"V1SignalBindingsPostRequestBodyContentApplicationJsonSchemaCoverage1"},"V1SignalBindingsPostRequestBodyContentApplicationJsonSchemaCoverage":{"oneOf":[{"$ref":"#/components/schemas/V1SignalBindingsPostRequestBodyContentApplicationJsonSchemaCoverage0"},{"$ref":"#/components/schemas/V1SignalBindingsPostRequestBodyContentApplicationJsonSchemaCoverage1"}],"title":"V1SignalBindingsPostRequestBodyContentApplicationJsonSchemaCoverage"},"V1SignalBindingsPostRequestBodyContentApplicationJsonSchemaFilter":{"type":"object","properties":{"minTurns":{"type":"integer","minimum":1},"status":{"type":"array","items":{"type":"string"}}},"title":"V1SignalBindingsPostRequestBodyContentApplicationJsonSchemaFilter"},"V1SignalBindingsPostRequestBodyContentApplicationJsonSchemaTargetKind":{"type":"string","enum":["agent"],"title":"V1SignalBindingsPostRequestBodyContentApplicationJsonSchemaTargetKind"},"V1SignalBindingsPostRequestBodyContentApplicationJsonSchemaTarget":{"type":"object","properties":{"id":{"type":"string"},"kind":{"$ref":"#/components/schemas/V1SignalBindingsPostRequestBodyContentApplicationJsonSchemaTargetKind"}},"required":["id","kind"],"description":"Native and external (OTLP) agents bind alike.","title":"V1SignalBindingsPostRequestBodyContentApplicationJsonSchemaTarget"},"Signals_bindASignalSetToAnAgent_Response_201":{"type":"object","properties":{"binding":{"$ref":"#/components/schemas/SignalBinding"}},"required":["binding"],"title":"Signals_bindASignalSetToAnAgent_Response_201"},"Signals_unbindASignalSet_Response_200":{"type":"object","properties":{"binding":{"$ref":"#/components/schemas/SignalBinding"}},"required":["binding"],"title":"Signals_unbindASignalSet_Response_200"},"V1SignalSetsGetResponsesContentApplicationJsonSchemaDataItems":{"type":"object","properties":{"builtin":{"type":"boolean","description":"A platform-seeded set that runs on every agent with no model call; read-only on every surface."},"createdAt":{"type":"string"},"createdByUserId":{"type":["string","null"]},"currentVersionId":{"type":["string","null"]},"description":{"type":["string","null"]},"id":{"type":"string"},"lastModifiedSource":{"type":["string","null"]},"name":{"type":"string"},"organizationId":{"type":"string"},"preset":{"type":["string","null"],"description":"The preset this set was created from, if any."},"updatedAt":{"type":"string"},"latestVersionNumber":{"type":"integer"}},"required":["builtin","createdAt","createdByUserId","currentVersionId","description","id","lastModifiedSource","name","organizationId","preset","updatedAt","latestVersionNumber"],"title":"V1SignalSetsGetResponsesContentApplicationJsonSchemaDataItems"},"Signals_listSignalSets_Response_200":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1SignalSetsGetResponsesContentApplicationJsonSchemaDataItems"}}},"required":["data"],"title":"Signals_listSignalSets_Response_200"},"SignalSet":{"type":"object","properties":{"builtin":{"type":"boolean","description":"A platform-seeded set that runs on every agent with no model call; read-only on every surface."},"createdAt":{"type":"string"},"createdByUserId":{"type":["string","null"]},"currentVersionId":{"type":["string","null"]},"description":{"type":["string","null"]},"id":{"type":"string"},"lastModifiedSource":{"type":["string","null"]},"name":{"type":"string"},"organizationId":{"type":"string"},"preset":{"type":["string","null"],"description":"The preset this set was created from, if any."},"updatedAt":{"type":"string"}},"required":["builtin","createdAt","createdByUserId","currentVersionId","description","id","lastModifiedSource","name","organizationId","preset","updatedAt"],"title":"SignalSet"},"SignalSetVersion":{"type":"object","properties":{"createdAt":{"type":"string"},"createdByUserId":{"type":["string","null"]},"definition":{"type":"object","additionalProperties":{"description":"Any type"},"description":"A signal set version: `{ unit: \"turn\", context: { priorTurns }, signals: { <key>: { type, instructions, options?, notable?, ... } }, bands: { act, review } }`. bool and choice signals go to the decision model; text, number, date, duration, list and estimate go to the extraction model."},"id":{"type":"string"},"signalSetId":{"type":"string"},"unit":{"type":"string"},"versionNumber":{"type":"integer"}},"required":["createdAt","createdByUserId","definition","id","signalSetId","unit","versionNumber"],"title":"SignalSetVersion"},"Signals_createASignalSet_Response_201":{"type":"object","properties":{"signalSet":{"$ref":"#/components/schemas/SignalSet"},"version":{"$ref":"#/components/schemas/SignalSetVersion"}},"required":["signalSet","version"],"title":"Signals_createASignalSet_Response_201"},"V1SignalSetsPresetsGetResponsesContentApplicationJsonSchemaDataItems":{"type":"object","properties":{"definition":{"type":"object","additionalProperties":{"description":"Any type"},"description":"A signal set version: `{ unit: \"turn\", context: { priorTurns }, signals: { <key>: { type, instructions, options?, notable?, ... } }, bands: { act, review } }`. bool and choice signals go to the decision model; text, number, date, duration, list and estimate go to the extraction model."},"description":{"type":"string"},"id":{"type":"string"},"name":{"type":"string"}},"required":["definition","description","id","name"],"title":"V1SignalSetsPresetsGetResponsesContentApplicationJsonSchemaDataItems"},"Signals_listSignalSetPresets_Response_200":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1SignalSetsPresetsGetResponsesContentApplicationJsonSchemaDataItems"}}},"required":["data"],"title":"Signals_listSignalSetPresets_Response_200"},"V1SignalSetsIdGetResponsesContentApplicationJsonSchemaCurrentVersion":{"type":"object","properties":{"createdAt":{"type":"string"},"createdByUserId":{"type":["string","null"]},"definition":{"type":"object","additionalProperties":{"description":"Any type"},"description":"A signal set version: `{ unit: \"turn\", context: { priorTurns }, signals: { <key>: { type, instructions, options?, notable?, ... } }, bands: { act, review } }`. bool and choice signals go to the decision model; text, number, date, duration, list and estimate go to the extraction model."},"id":{"type":"string"},"signalSetId":{"type":"string"},"unit":{"type":"string"},"versionNumber":{"type":"integer"}},"required":["createdAt","createdByUserId","definition","id","signalSetId","unit","versionNumber"],"title":"V1SignalSetsIdGetResponsesContentApplicationJsonSchemaCurrentVersion"},"Signals_getASignalSet_Response_200":{"type":"object","properties":{"currentVersion":{"oneOf":[{"$ref":"#/components/schemas/V1SignalSetsIdGetResponsesContentApplicationJsonSchemaCurrentVersion"},{"type":"null"}]},"signalSet":{"$ref":"#/components/schemas/SignalSet"},"versions":{"type":"array","items":{"$ref":"#/components/schemas/SignalSetVersion"}}},"required":["currentVersion","signalSet","versions"],"title":"Signals_getASignalSet_Response_200"},"Signals_deleteASignalSet_Response_200":{"type":"object","properties":{"success":{"type":"boolean"}},"required":["success"],"title":"Signals_deleteASignalSet_Response_200"},"Signals_updateASignalSet_Response_200":{"type":"object","properties":{"signalSet":{"$ref":"#/components/schemas/SignalSet"}},"required":["signalSet"],"title":"Signals_updateASignalSet_Response_200"},"Signals_publishASignalSetVersion_Response_201":{"type":"object","properties":{"signalSet":{"$ref":"#/components/schemas/SignalSet"},"version":{"$ref":"#/components/schemas/SignalSetVersion"}},"required":["signalSet","version"],"title":"Signals_publishASignalSetVersion_Response_201"},"SignalPreviewReportSignalsItems":{"type":"object","properties":{"evaluated":{"type":"integer"},"fireRate":{"type":"number","format":"double"},"fired":{"type":"integer"},"key":{"type":"string"},"meanConfidence":{"type":["number","null"],"format":"double"},"reviewBand":{"type":"integer"},"type":{"type":"string"},"valueCounts":{"type":"object","additionalProperties":{"type":"number","format":"double"}}},"required":["evaluated","fireRate","fired","key","meanConfidence","reviewBand","type","valueCounts"],"title":"SignalPreviewReportSignalsItems"},"SignalPreviewReport":{"type":"object","properties":{"costUsd":{"type":"number","format":"double","description":"What this preview spent."},"evaluated":{"type":"integer"},"failed":{"type":"integer"},"labelAgreement":{"description":"Agreement with human labels; null until labels exist."},"monthlyTraceVolume":{"type":"integer"},"notes":{"type":"array","items":{"type":"string"}},"projectedMonthlyUsd":{"type":"number","format":"double","description":"Mean unit cost times the agent’s last-30-day trace volume."},"samples":{"type":"array","items":{"type":"object","additionalProperties":{"description":"Any type"}}},"signals":{"type":"array","items":{"$ref":"#/components/schemas/SignalPreviewReportSignalsItems"}},"tracesRead":{"type":"integer"}},"required":["costUsd","evaluated","failed","labelAgreement","monthlyTraceVolume","notes","projectedMonthlyUsd","samples","signals","tracesRead"],"title":"SignalPreviewReport"},"V1SignalsStatsGetParametersSample":{"type":"string","enum":["uniform","filtered"],"title":"V1SignalsStatsGetParametersSample"},"SignalStatRowSample":{"type":"string","enum":["uniform","filtered"],"title":"SignalStatRowSample"},"SignalStatRow":{"type":"object","properties":{"agentId":{"type":"string"},"agentVersionId":{"type":["string","null"]},"bindingId":{"type":"string"},"costMicros":{"type":"number","format":"double"},"evaluated":{"type":"number","format":"double"},"failed":{"type":"number","format":"double"},"fired":{"type":"number","format":"double"},"reviewBand":{"type":"number","format":"double"},"sample":{"$ref":"#/components/schemas/SignalStatRowSample"},"signalKey":{"type":"string","description":"`*` is the unit-level row: evaluated, skipped, failed and cost."},"signalSetId":{"type":"string"},"signalSetVersionId":{"type":"string"},"skipped":{"type":"number","format":"double"},"valueBucket":{"type":"string"},"versionNumber":{"type":"integer"}},"required":["agentId","agentVersionId","bindingId","costMicros","evaluated","failed","fired","reviewBand","sample","signalKey","signalSetId","signalSetVersionId","skipped","valueBucket","versionNumber"],"title":"SignalStatRow"},"V1SignalsStatsGetResponsesContentApplicationJsonSchemaWindow":{"type":"object","properties":{"from":{"type":"string"},"to":{"type":"string"}},"required":["from","to"],"title":"V1SignalsStatsGetResponsesContentApplicationJsonSchemaWindow"},"Signals_signalStats_Response_200":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/SignalStatRow"}},"window":{"$ref":"#/components/schemas/V1SignalsStatsGetResponsesContentApplicationJsonSchemaWindow"}},"required":["data","window"],"title":"Signals_signalStats_Response_200"},"EnrichedSkillProposalProposingAgent":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"title":"EnrichedSkillProposalProposingAgent"},"EnrichedSkillProposalSkill":{"type":"object","properties":{"description":{"type":["string","null"]},"id":{"type":"string"},"name":{"type":"string"},"status":{"type":"string"}},"required":["description","id","name","status"],"title":"EnrichedSkillProposalSkill"},"EnrichedSkillProposalVersionManifest":{"type":"object","properties":{"body":{"type":"string"},"frontmatter":{"type":"object","additionalProperties":{"description":"Any type"}},"runtype":{"type":"object","additionalProperties":{"description":"Any type"}}},"required":["body","frontmatter","runtype"],"title":"EnrichedSkillProposalVersionManifest"},"EnrichedSkillProposalVersion":{"type":"object","properties":{"id":{"type":"string"},"manifest":{"$ref":"#/components/schemas/EnrichedSkillProposalVersionManifest"},"versionNumber":{"type":"number","format":"double"}},"required":["id","manifest","versionNumber"],"title":"EnrichedSkillProposalVersion"},"EnrichedSkillProposal":{"type":"object","properties":{"createdAt":{"type":"string"},"id":{"type":"string"},"organizationId":{"type":["string","null"]},"proposingAgentExecutionId":{"type":["string","null"]},"proposingUserId":{"type":"string"},"rejectionReason":{"type":["string","null"]},"reviewedAt":{"type":["string","null"]},"reviewedBy":{"type":["string","null"]},"skillVersionId":{"type":"string"},"status":{"type":"string"},"proposingAgent":{"oneOf":[{"$ref":"#/components/schemas/EnrichedSkillProposalProposingAgent"},{"type":"null"}]},"resolvedCapabilityNames":{"type":"object","additionalProperties":{"type":["string","null"]}},"skill":{"oneOf":[{"$ref":"#/components/schemas/EnrichedSkillProposalSkill"},{"type":"null"}]},"version":{"oneOf":[{"$ref":"#/components/schemas/EnrichedSkillProposalVersion"},{"type":"null"}]}},"required":["createdAt","id","organizationId","proposingAgentExecutionId","proposingUserId","rejectionReason","reviewedAt","reviewedBy","skillVersionId","status","proposingAgent","resolvedCapabilityNames","skill","version"],"title":"EnrichedSkillProposal"},"Skill_Proposals_listPendingSkillProposals_Response_200":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/EnrichedSkillProposal"}}},"required":["data"],"title":"Skill Proposals_listPendingSkillProposals_Response_200"},"SkillProposal":{"type":"object","properties":{"createdAt":{"type":"string"},"id":{"type":"string"},"organizationId":{"type":["string","null"]},"proposingAgentExecutionId":{"type":["string","null"]},"proposingUserId":{"type":"string"},"rejectionReason":{"type":["string","null"]},"reviewedAt":{"type":["string","null"]},"reviewedBy":{"type":["string","null"]},"skillVersionId":{"type":"string"},"status":{"type":"string"}},"required":["createdAt","id","organizationId","proposingAgentExecutionId","proposingUserId","rejectionReason","reviewedAt","reviewedBy","skillVersionId","status"],"title":"SkillProposal"},"Skill_Proposals_approveASkillProposal_Response_200":{"type":"object","properties":{"proposal":{"$ref":"#/components/schemas/SkillProposal"}},"required":["proposal"],"title":"Skill Proposals_approveASkillProposal_Response_200"},"Skill_Proposals_rejectASkillProposal_Response_200":{"type":"object","properties":{"proposal":{"$ref":"#/components/schemas/SkillProposal"}},"required":["proposal"],"title":"Skill Proposals_rejectASkillProposal_Response_200"},"V1SkillsGetParametersStatus":{"type":"string","enum":["draft","active","archived"],"title":"V1SkillsGetParametersStatus"},"V1SkillsGetParametersView":{"type":"string","enum":["full","compact"],"description":"Response representation. `full` (default) preserves complete values; `compact` shortens every string value longer than 100 characters to a 100-character preview followed by `…`.","title":"V1SkillsGetParametersView"},"Skills_listSkills_Response_200":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","additionalProperties":{"description":"Any type"}}},"pagination":{"$ref":"#/components/schemas/Pagination"}},"required":["data","pagination"],"title":"Skills_listSkills_Response_200"},"Skills_listAnAgentsSkillBindings_Response_200":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","additionalProperties":{"description":"Any type"}}}},"required":["data"],"title":"Skills_listAnAgentsSkillBindings_Response_200"},"Skills_unbindASkillFromAnAgent_Response_200":{"type":"object","properties":{"success":{"type":"boolean"}},"required":["success"],"title":"Skills_unbindASkillFromAnAgent_Response_200"},"V1SkillsEnsurePostRequestBodyContentApplicationJsonSchemaDefinition":{"type":"object","properties":{"body":{"type":"string"},"frontmatter":{"type":"object","additionalProperties":{"description":"Any type"}},"markdown":{"type":"string","minLength":1}},"title":"V1SkillsEnsurePostRequestBodyContentApplicationJsonSchemaDefinition"},"V1SkillsEnsurePostRequestBodyContentApplicationJsonSchemaOnConflict":{"type":"string","enum":["error","overwrite"],"title":"V1SkillsEnsurePostRequestBodyContentApplicationJsonSchemaOnConflict"},"V1SkillsEnsurePostRequestBodyContentApplicationJsonSchemaRelease":{"type":"string","enum":["none","publish"],"title":"V1SkillsEnsurePostRequestBodyContentApplicationJsonSchemaRelease"},"SkillEnsureResponseOneOf0Result":{"type":"string","enum":["unchanged","created","updated"],"title":"SkillEnsureResponseOneOf0Result"},"SkillEnsureResponse0":{"type":"object","properties":{"contentHash":{"type":"string","description":"Server-computed canonical content hash. Clients should echo this hash in probes."},"result":{"$ref":"#/components/schemas/SkillEnsureResponseOneOf0Result"},"skillId":{"type":"string"},"versionId":{"type":["string","null"]}},"required":["contentHash","result","skillId","versionId"],"title":"SkillEnsureResponse0"},"SkillEnsureResponseOneOf1Result":{"type":"string","enum":["definitionRequired"],"title":"SkillEnsureResponseOneOf1Result"},"SkillEnsureResponse1":{"type":"object","properties":{"result":{"$ref":"#/components/schemas/SkillEnsureResponseOneOf1Result"}},"required":["result"],"title":"SkillEnsureResponse1"},"SkillEnsureResponseOneOf2Changes":{"type":"string","enum":["none","create","update"],"title":"SkillEnsureResponseOneOf2Changes"},"SkillEnsureResponseOneOf2Result":{"type":"string","enum":["plan"],"title":"SkillEnsureResponseOneOf2Result"},"SkillEnsureResponse2":{"type":"object","properties":{"changedKeys":{"type":"array","items":{"type":"string"}},"changes":{"$ref":"#/components/schemas/SkillEnsureResponseOneOf2Changes"},"contentHash":{"type":"string"},"remoteHash":{"type":"string"},"result":{"$ref":"#/components/schemas/SkillEnsureResponseOneOf2Result"},"skillId":{"type":"string"}},"required":["changedKeys","changes","contentHash","result"],"title":"SkillEnsureResponse2"},"SkillEnsureResponse":{"oneOf":[{"$ref":"#/components/schemas/SkillEnsureResponse0"},{"$ref":"#/components/schemas/SkillEnsureResponse1"},{"$ref":"#/components/schemas/SkillEnsureResponse2"}],"title":"SkillEnsureResponse"},"SkillEnsureConflictCode":{"type":"string","enum":["external_modification","remote_changed"],"title":"SkillEnsureConflictCode"},"SkillEnsureConflict":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/SkillEnsureConflictCode"},"currentHash":{"type":["string","null"]},"error":{"type":"string"},"lastModifiedSource":{"type":"string"},"modifiedAt":{"type":["string","null"]}},"required":["code","error"],"title":"SkillEnsureConflict"},"SkillEnsureHashMismatchCode":{"type":"string","enum":["content_hash_mismatch"],"title":"SkillEnsureHashMismatchCode"},"SkillEnsureHashMismatch":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/SkillEnsureHashMismatchCode"},"contentHash":{"type":"string","description":"The server-computed canonical hash of the submitted manifest."},"error":{"type":"string"}},"required":["code","contentHash","error"],"title":"SkillEnsureHashMismatch"},"SkillEnsureUnsupportedCapabilityCode":{"type":"string","enum":["unsupported_capability"],"title":"SkillEnsureUnsupportedCapabilityCode"},"SkillEnsureUnsupportedCapability":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/SkillEnsureUnsupportedCapabilityCode"},"error":{"type":"string"}},"required":["code","error"],"title":"SkillEnsureUnsupportedCapability"},"SkillEnsureUnprocessable":{"oneOf":[{"$ref":"#/components/schemas/SkillEnsureHashMismatch"},{"$ref":"#/components/schemas/SkillEnsureUnsupportedCapability"}],"title":"SkillEnsureUnprocessable"},"SkillPullResponseDefinition":{"type":"object","properties":{"manifest":{"type":"object","additionalProperties":{"description":"Any type"}},"name":{"type":"string"}},"required":["manifest","name"],"title":"SkillPullResponseDefinition"},"SkillPullResponse":{"type":"object","properties":{"contentHash":{"type":"string"},"definition":{"$ref":"#/components/schemas/SkillPullResponseDefinition"},"lastModifiedSource":{"type":["string","null"]},"skillId":{"type":"string"},"updatedAt":{"type":["string","null"]},"versionId":{"type":["string","null"]}},"required":["contentHash","definition","lastModifiedSource","skillId","updatedAt","versionId"],"title":"SkillPullResponse"},"Skills_deleteASkill_Response_200":{"type":"object","properties":{"success":{"type":"boolean"}},"required":["success"],"title":"Skills_deleteASkill_Response_200"},"V1SkillsIdBindingsGetResponsesContentApplicationJsonSchemaDataItemsAgent":{"type":"object","properties":{"agentType":{"type":"string"},"id":{"type":"string"},"name":{"type":"string"}},"required":["agentType","id","name"],"title":"V1SkillsIdBindingsGetResponsesContentApplicationJsonSchemaDataItemsAgent"},"V1SkillsIdBindingsGetResponsesContentApplicationJsonSchemaDataItems":{"type":"object","properties":{"agent":{"$ref":"#/components/schemas/V1SkillsIdBindingsGetResponsesContentApplicationJsonSchemaDataItemsAgent"},"agentId":{"type":"string"},"createdAt":{"type":"string"},"displayOrder":{"type":"number","format":"double"},"enabled":{"type":"boolean"},"id":{"type":"string"},"skillId":{"type":"string"},"skillVersionId":{"type":["string","null"]}},"required":["agent","agentId","createdAt","displayOrder","enabled","id","skillId","skillVersionId"],"title":"V1SkillsIdBindingsGetResponsesContentApplicationJsonSchemaDataItems"},"Skills_listTheAgentsASkillIsBoundTo_Response_200":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1SkillsIdBindingsGetResponsesContentApplicationJsonSchemaDataItems"}}},"required":["data"],"title":"Skills_listTheAgentsASkillIsBoundTo_Response_200"},"Skills_listASkillsVersions_Response_200":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","additionalProperties":{"description":"Any type"}}}},"required":["data"],"title":"Skills_listASkillsVersions_Response_200"},"Skills_publishASkillVersion_Response_200":{"type":"object","properties":{"success":{"type":"boolean"}},"required":["success"],"title":"Skills_publishASkillVersion_Response_200"},"V1TelemetryIngestHealthGetResponsesContentApplicationJsonSchemaAdmission":{"type":"object","properties":{"activeRequests":{"type":"integer","minimum":0},"availableBytes":{"type":"integer","minimum":0},"availableRecords":{"type":"integer","minimum":0},"maximumConcurrentRequests":{"type":"integer","minimum":0}},"required":["activeRequests","availableBytes","availableRecords","maximumConcurrentRequests"],"title":"V1TelemetryIngestHealthGetResponsesContentApplicationJsonSchemaAdmission"},"V1TelemetryIngestHealthGetResponsesContentApplicationJsonSchemaErrorsItems":{"type":"object","properties":{"code":{"type":"string"},"records":{"type":"integer","minimum":0}},"required":["code","records"],"title":"V1TelemetryIngestHealthGetResponsesContentApplicationJsonSchemaErrorsItems"},"V1TelemetryIngestHealthGetResponsesContentApplicationJsonSchemaStatus":{"type":"string","enum":["idle","observing","degraded","queryable"],"title":"V1TelemetryIngestHealthGetResponsesContentApplicationJsonSchemaStatus"},"V1TelemetryIngestHealthGetResponsesContentApplicationJsonSchemaTiersCanonical":{"type":"object","properties":{"confirmed":{"type":"integer","minimum":0},"maximumConfirmedLagMs":{"type":["number","null"],"format":"double","minimum":0},"oldestPendingAgeMs":{"type":["number","null"],"format":"double","minimum":0},"repairs":{"type":"integer","minimum":0},"waiting":{"type":"integer","minimum":0}},"required":["confirmed","maximumConfirmedLagMs","oldestPendingAgeMs","repairs","waiting"],"description":"Deprecated: the canonical storage tier is retired and every field is permanently zero. It is emitted only so already-published SDKs, which model it as required, keep parsing; it is removed in a following release.","title":"V1TelemetryIngestHealthGetResponsesContentApplicationJsonSchemaTiersCanonical"},"V1TelemetryIngestHealthGetResponsesContentApplicationJsonSchemaTiersHot":{"type":"object","properties":{"confirmed":{"type":"integer","minimum":0},"maximumConfirmedLagMs":{"type":["number","null"],"format":"double","minimum":0},"oldestPendingAgeMs":{"type":["number","null"],"format":"double","minimum":0},"repairs":{"type":"integer","minimum":0},"waiting":{"type":"integer","minimum":0}},"required":["confirmed","maximumConfirmedLagMs","oldestPendingAgeMs","repairs","waiting"],"description":"Hot tier: confirmed by a positive receipt read, not a stream acknowledgment.","title":"V1TelemetryIngestHealthGetResponsesContentApplicationJsonSchemaTiersHot"},"V1TelemetryIngestHealthGetResponsesContentApplicationJsonSchemaTiersRaw":{"type":"object","properties":{"confirmed":{"type":"integer","minimum":0},"maximumConfirmedLagMs":{"type":["number","null"],"format":"double","minimum":0},"oldestPendingAgeMs":{"type":["number","null"],"format":"double","minimum":0},"repairs":{"type":"integer","minimum":0},"waiting":{"type":"integer","minimum":0}},"required":["confirmed","maximumConfirmedLagMs","oldestPendingAgeMs","repairs","waiting"],"description":"Raw storage tier: confirmed when its send succeeds (at-least-once, no read-back). `waiting` counts rows whose send has not yet succeeded.","title":"V1TelemetryIngestHealthGetResponsesContentApplicationJsonSchemaTiersRaw"},"V1TelemetryIngestHealthGetResponsesContentApplicationJsonSchemaTiers":{"type":"object","properties":{"canonical":{"$ref":"#/components/schemas/V1TelemetryIngestHealthGetResponsesContentApplicationJsonSchemaTiersCanonical","description":"Deprecated: the canonical storage tier is retired and every field is permanently zero. It is emitted only so already-published SDKs, which model it as required, keep parsing; it is removed in a following release."},"hot":{"$ref":"#/components/schemas/V1TelemetryIngestHealthGetResponsesContentApplicationJsonSchemaTiersHot","description":"Hot tier: confirmed by a positive receipt read, not a stream acknowledgment."},"raw":{"$ref":"#/components/schemas/V1TelemetryIngestHealthGetResponsesContentApplicationJsonSchemaTiersRaw","description":"Raw storage tier: confirmed when its send succeeds (at-least-once, no read-back). `waiting` counts rows whose send has not yet succeeded."}},"required":["canonical","hot","raw"],"title":"V1TelemetryIngestHealthGetResponsesContentApplicationJsonSchemaTiers"},"V1TelemetryIngestHealthGetResponsesContentApplicationJsonSchemaTotals":{"type":"object","properties":{"accepted":{"type":"integer","minimum":0},"claimConflicts":{"type":"integer","minimum":0},"complete":{"type":"integer","minimum":0},"deleted":{"type":"integer","minimum":0},"exhaustedAttempts":{"type":"integer","minimum":0},"expired":{"type":"integer","minimum":0},"pending":{"type":"integer","minimum":0},"pendingBytes":{"type":"integer","minimum":0},"suppressed":{"type":"integer","minimum":0}},"required":["accepted","claimConflicts","complete","deleted","exhaustedAttempts","expired","pending","pendingBytes","suppressed"],"title":"V1TelemetryIngestHealthGetResponsesContentApplicationJsonSchemaTotals"},"V1TelemetryIngestHealthGetResponsesContentApplicationJsonSchemaTraceDelivery":{"type":"object","properties":{"accepted":{"type":"integer","minimum":0},"canonicalConfirmed":{"type":"integer","minimum":0,"description":"Deprecated: the canonical storage tier is retired and every field is permanently zero. It is emitted only so already-published SDKs, which model it as required, keep parsing; it is removed in a following release."},"complete":{"type":"integer","minimum":0},"hotConfirmed":{"type":"integer","minimum":0},"pending":{"type":"integer","minimum":0},"rawConfirmed":{"type":"integer","minimum":0}},"required":["accepted","canonicalConfirmed","complete","hotConfirmed","pending","rawConfirmed"],"description":"Receipt counts for this trace only; hot confirmations require a positive receipt read, raw confirmations a successful send.","title":"V1TelemetryIngestHealthGetResponsesContentApplicationJsonSchemaTraceDelivery"},"V1TelemetryIngestHealthGetResponsesContentApplicationJsonSchemaTrace":{"type":"object","properties":{"acceptedAt":{"type":"string"},"completeness":{"type":"string"},"delivery":{"$ref":"#/components/schemas/V1TelemetryIngestHealthGetResponsesContentApplicationJsonSchemaTraceDelivery","description":"Receipt counts for this trace only; hot confirmations require a positive receipt read, raw confirmations a successful send."},"diagnostics":{"type":"object","additionalProperties":{"description":"Any type"}},"expiresAt":{"type":"string"},"revision":{"type":"integer","minimum":0},"traceId":{"type":"string"}},"required":["acceptedAt","completeness","delivery","diagnostics","expiresAt","revision","traceId"],"title":"V1TelemetryIngestHealthGetResponsesContentApplicationJsonSchemaTrace"},"Telemetry_getOtlpIngestHealth_Response_200":{"type":"object","properties":{"admission":{"$ref":"#/components/schemas/V1TelemetryIngestHealthGetResponsesContentApplicationJsonSchemaAdmission"},"errors":{"type":"array","items":{"$ref":"#/components/schemas/V1TelemetryIngestHealthGetResponsesContentApplicationJsonSchemaErrorsItems"}},"lastAcceptedAt":{"type":["string","null"]},"observedAt":{"type":"string"},"receiptHistoryDays":{"type":"integer","minimum":0},"status":{"$ref":"#/components/schemas/V1TelemetryIngestHealthGetResponsesContentApplicationJsonSchemaStatus"},"tiers":{"$ref":"#/components/schemas/V1TelemetryIngestHealthGetResponsesContentApplicationJsonSchemaTiers"},"totals":{"$ref":"#/components/schemas/V1TelemetryIngestHealthGetResponsesContentApplicationJsonSchemaTotals"},"trace":{"oneOf":[{"$ref":"#/components/schemas/V1TelemetryIngestHealthGetResponsesContentApplicationJsonSchemaTrace"},{"type":"null"}]}},"required":["admission","errors","lastAcceptedAt","observedAt","receiptHistoryDays","status","tiers","totals","trace"],"title":"Telemetry_getOtlpIngestHealth_Response_200"},"ToolApprovalGrant":{"type":"object","properties":{"agentId":{"type":"string"},"createdAt":{"type":"string"},"decision":{"type":"string"},"endUserRef":{"type":["string","null"]},"expiresAt":{"type":["string","null"]},"id":{"type":"string"},"sourceApprovalId":{"type":["string","null"]},"sourceExecutionId":{"type":["string","null"]},"toolName":{"type":"string"},"toolType":{"type":"string"}},"required":["agentId","createdAt","decision","endUserRef","expiresAt","id","sourceApprovalId","sourceExecutionId","toolName","toolType"],"title":"ToolApprovalGrant"},"Tool_Approval_Grants_listRememberedToolApprovalGrants_Response_200":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/ToolApprovalGrant"}}},"required":["data"],"title":"Tool Approval Grants_listRememberedToolApprovalGrants_Response_200"},"Tool_Approval_Grants_revokeARememberedToolApprovalGrant_Response_200":{"type":"object","properties":{"revoked":{"type":"boolean"}},"required":["revoked"],"title":"Tool Approval Grants_revokeARememberedToolApprovalGrant_Response_200"},"V1ToolsGetParametersView":{"type":"string","enum":["full","compact"],"description":"Response representation. `full` (default) preserves complete values; `compact` shortens every string value longer than 100 characters to a 100-character preview followed by `…`.","title":"V1ToolsGetParametersView"},"V1ToolsGetResponsesContentApplicationJsonSchemaDataItems":{"type":"object","properties":{"createdAt":{"type":"string"},"description":{"type":["string","null"]},"id":{"type":"string"},"isActive":{"type":"boolean"},"name":{"type":"string"},"parametersSchema":{"type":"object","additionalProperties":{"description":"Any type"}},"toolType":{"type":"string"},"updatedAt":{"type":"string"}},"required":["createdAt","description","id","isActive","name","toolType","updatedAt"],"title":"V1ToolsGetResponsesContentApplicationJsonSchemaDataItems"},"Tools_listTools_Response_200":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1ToolsGetResponsesContentApplicationJsonSchemaDataItems"}},"pagination":{"$ref":"#/components/schemas/Pagination"}},"required":["data","pagination"],"title":"Tools_listTools_Response_200"},"V1ToolsPostRequestBodyContentApplicationJsonSchemaToolType":{"type":"string","enum":["flow","custom","external","graphql","mcp","local","subagent"],"title":"V1ToolsPostRequestBodyContentApplicationJsonSchemaToolType"},"V1ToolsPostResponsesContentApplicationJsonSchemaValidationWarningsItemsSeverity":{"type":"string","enum":["error","warning"],"title":"V1ToolsPostResponsesContentApplicationJsonSchemaValidationWarningsItemsSeverity"},"V1ToolsPostResponsesContentApplicationJsonSchemaValidationWarningsItems":{"type":"object","properties":{"code":{"type":"string"},"column":{"type":"number","format":"double"},"line":{"type":"number","format":"double"},"message":{"type":"string"},"severity":{"$ref":"#/components/schemas/V1ToolsPostResponsesContentApplicationJsonSchemaValidationWarningsItemsSeverity"},"suggestion":{"type":"string"}},"required":["code","message","severity"],"title":"V1ToolsPostResponsesContentApplicationJsonSchemaValidationWarningsItems"},"V1ToolsPostResponsesContentApplicationJsonSchemaValidation":{"type":"object","properties":{"recommendations":{"type":"array","items":{"$ref":"#/components/schemas/FlowValidationIssue"}},"warnings":{"type":"array","items":{"$ref":"#/components/schemas/V1ToolsPostResponsesContentApplicationJsonSchemaValidationWarningsItems"}}},"required":["warnings"],"description":"Non-blocking findings from a successful write. `warnings` also carries `SESSION_PREVIEW_URL` when `config.url` or `config.serverUrl` is a session sandbox preview URL, which stops working when that sandbox container stops.","title":"V1ToolsPostResponsesContentApplicationJsonSchemaValidation"},"Tools_createTool_Response_200":{"type":"object","properties":{"config":{"type":["object","null"],"additionalProperties":{"description":"Any type"}},"createdAt":{"type":"string"},"description":{"type":["string","null"]},"id":{"type":"string"},"isActive":{"type":"boolean"},"lastModifiedSource":{"type":["string","null"]},"name":{"type":"string"},"organizationId":{"type":["string","null"]},"parametersSchema":{"type":"object","additionalProperties":{"description":"Any type"}},"toolType":{"type":"string"},"updatedAt":{"type":"string"},"userId":{"type":["string","null"]},"validation":{"$ref":"#/components/schemas/V1ToolsPostResponsesContentApplicationJsonSchemaValidation","description":"Non-blocking findings from a successful write. `warnings` also carries `SESSION_PREVIEW_URL` when `config.url` or `config.serverUrl` is a session sandbox preview URL, which stops working when that sandbox container stops."}},"required":["config","createdAt","description","id","isActive","name","organizationId","toolType","updatedAt","userId"],"title":"Tools_createTool_Response_200"},"V1ToolsBuiltinGetResponsesContentApplicationJsonSchemaDataItemsModelCompatibilityItems":{"type":"object","properties":{"models":{"type":"array","items":{"type":"string"}},"provider":{"type":"string"}},"required":["models","provider"],"title":"V1ToolsBuiltinGetResponsesContentApplicationJsonSchemaDataItemsModelCompatibilityItems"},"V1ToolsBuiltinGetResponsesContentApplicationJsonSchemaDataItems":{"type":"object","properties":{"category":{"type":"string"},"defaultConfig":{"type":"object","additionalProperties":{"description":"Any type"}},"description":{"type":"string"},"documentationUrl":{"type":"string"},"id":{"type":"string"},"modelCompatibility":{"type":"array","items":{"$ref":"#/components/schemas/V1ToolsBuiltinGetResponsesContentApplicationJsonSchemaDataItemsModelCompatibilityItems"}},"name":{"type":"string"},"parametersSchema":{"type":"object","additionalProperties":{"description":"Any type"}},"providers":{"type":"array","items":{"type":"string"}}},"required":["category","description","id","name","parametersSchema","providers"],"title":"V1ToolsBuiltinGetResponsesContentApplicationJsonSchemaDataItems"},"Tools_listBuiltInTools_Response_200":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1ToolsBuiltinGetResponsesContentApplicationJsonSchemaDataItems"}},"total":{"type":"integer"}},"required":["data","total"],"title":"Tools_listBuiltInTools_Response_200"},"V1ToolsBuiltinCompatibleGetResponsesContentApplicationJsonSchemaDataItemsModelCompatibilityItems":{"type":"object","properties":{"models":{"type":"array","items":{"type":"string"}},"provider":{"type":"string"}},"required":["models","provider"],"title":"V1ToolsBuiltinCompatibleGetResponsesContentApplicationJsonSchemaDataItemsModelCompatibilityItems"},"V1ToolsBuiltinCompatibleGetResponsesContentApplicationJsonSchemaDataItems":{"type":"object","properties":{"category":{"type":"string"},"defaultConfig":{"type":"object","additionalProperties":{"description":"Any type"}},"description":{"type":"string"},"documentationUrl":{"type":"string"},"id":{"type":"string"},"modelCompatibility":{"type":"array","items":{"$ref":"#/components/schemas/V1ToolsBuiltinCompatibleGetResponsesContentApplicationJsonSchemaDataItemsModelCompatibilityItems"}},"name":{"type":"string"},"parametersSchema":{"type":"object","additionalProperties":{"description":"Any type"}},"providers":{"type":"array","items":{"type":"string"}}},"required":["category","description","id","name","parametersSchema","providers"],"title":"V1ToolsBuiltinCompatibleGetResponsesContentApplicationJsonSchemaDataItems"},"Tools_listCompatibleBuiltInTools_Response_200":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1ToolsBuiltinCompatibleGetResponsesContentApplicationJsonSchemaDataItems"}},"total":{"type":"integer"}},"required":["data","total"],"title":"Tools_listCompatibleBuiltInTools_Response_200"},"Tools_getBuiltInToolSchema_Response_200":{"type":"object","properties":{"defaultConfig":{"type":"object","additionalProperties":{"description":"Any type"}},"description":{"type":"string"},"id":{"type":"string"},"name":{"type":"string"},"parametersSchema":{"type":"object","additionalProperties":{"description":"Any type"}}},"required":["description","id","name","parametersSchema"],"title":"Tools_getBuiltInToolSchema_Response_200"},"V1ToolsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionToolType":{"type":"string","enum":["flow","custom","external","graphql","mcp","local","subagent"],"title":"V1ToolsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionToolType"},"V1ToolsEnsurePostRequestBodyContentApplicationJsonSchemaDefinition":{"type":"object","properties":{"config":{"type":"object","additionalProperties":{"description":"Any type"}},"description":{"type":"string","minLength":1,"maxLength":500},"name":{"type":"string","minLength":1,"maxLength":100},"parametersSchema":{"type":"object","additionalProperties":{"description":"Any type"}},"toolType":{"$ref":"#/components/schemas/V1ToolsEnsurePostRequestBodyContentApplicationJsonSchemaDefinitionToolType"}},"required":["config","description","name","parametersSchema","toolType"],"title":"V1ToolsEnsurePostRequestBodyContentApplicationJsonSchemaDefinition"},"V1ToolsEnsurePostRequestBodyContentApplicationJsonSchemaOnConflict":{"type":"string","enum":["error","overwrite"],"title":"V1ToolsEnsurePostRequestBodyContentApplicationJsonSchemaOnConflict"},"ToolEnsureResponseOneOf0Result":{"type":"string","enum":["unchanged","created","updated"],"title":"ToolEnsureResponseOneOf0Result"},"ToolEnsureResponse0":{"type":"object","properties":{"contentHash":{"type":"string","description":"Server-computed canonical content hash. Clients should echo this hash in probes."},"result":{"$ref":"#/components/schemas/ToolEnsureResponseOneOf0Result"},"toolId":{"type":"string"}},"required":["contentHash","result","toolId"],"title":"ToolEnsureResponse0"},"ToolEnsureResponseOneOf1Result":{"type":"string","enum":["definitionRequired"],"title":"ToolEnsureResponseOneOf1Result"},"ToolEnsureResponse1":{"type":"object","properties":{"result":{"$ref":"#/components/schemas/ToolEnsureResponseOneOf1Result"}},"required":["result"],"title":"ToolEnsureResponse1"},"ToolEnsureResponseOneOf2Changes":{"type":"string","enum":["none","create","update"],"title":"ToolEnsureResponseOneOf2Changes"},"ToolEnsureResponseOneOf2Result":{"type":"string","enum":["plan"],"title":"ToolEnsureResponseOneOf2Result"},"ToolEnsureResponse2":{"type":"object","properties":{"changedKeys":{"type":"array","items":{"type":"string"}},"changes":{"$ref":"#/components/schemas/ToolEnsureResponseOneOf2Changes"},"contentHash":{"type":"string"},"remoteHash":{"type":"string"},"result":{"$ref":"#/components/schemas/ToolEnsureResponseOneOf2Result"},"toolId":{"type":"string"}},"required":["changedKeys","changes","contentHash","result"],"title":"ToolEnsureResponse2"},"ToolEnsureResponse":{"oneOf":[{"$ref":"#/components/schemas/ToolEnsureResponse0"},{"$ref":"#/components/schemas/ToolEnsureResponse1"},{"$ref":"#/components/schemas/ToolEnsureResponse2"}],"title":"ToolEnsureResponse"},"ToolEnsureConflictCode":{"type":"string","enum":["external_modification","remote_changed"],"title":"ToolEnsureConflictCode"},"ToolEnsureConflict":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/ToolEnsureConflictCode"},"currentHash":{"type":["string","null"]},"error":{"type":"string"},"lastModifiedSource":{"type":"string"},"modifiedAt":{"type":["string","null"]}},"required":["code","error"],"title":"ToolEnsureConflict"},"ToolEnsureHashMismatchCode":{"type":"string","enum":["content_hash_mismatch"],"title":"ToolEnsureHashMismatchCode"},"ToolEnsureHashMismatch":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/ToolEnsureHashMismatchCode"},"contentHash":{"type":"string","description":"The server-computed canonical hash of the submitted definition."},"error":{"type":"string"}},"required":["code","contentHash","error"],"title":"ToolEnsureHashMismatch"},"V1ToolsFlowsFlowIdConvertToToolPostResponsesContentApplicationJsonSchemaValidationWarningsItemsSeverity":{"type":"string","enum":["error","warning"],"title":"V1ToolsFlowsFlowIdConvertToToolPostResponsesContentApplicationJsonSchemaValidationWarningsItemsSeverity"},"V1ToolsFlowsFlowIdConvertToToolPostResponsesContentApplicationJsonSchemaValidationWarningsItems":{"type":"object","properties":{"code":{"type":"string"},"column":{"type":"number","format":"double"},"line":{"type":"number","format":"double"},"message":{"type":"string"},"severity":{"$ref":"#/components/schemas/V1ToolsFlowsFlowIdConvertToToolPostResponsesContentApplicationJsonSchemaValidationWarningsItemsSeverity"},"suggestion":{"type":"string"}},"required":["code","message","severity"],"title":"V1ToolsFlowsFlowIdConvertToToolPostResponsesContentApplicationJsonSchemaValidationWarningsItems"},"V1ToolsFlowsFlowIdConvertToToolPostResponsesContentApplicationJsonSchemaValidation":{"type":"object","properties":{"recommendations":{"type":"array","items":{"$ref":"#/components/schemas/FlowValidationIssue"}},"warnings":{"type":"array","items":{"$ref":"#/components/schemas/V1ToolsFlowsFlowIdConvertToToolPostResponsesContentApplicationJsonSchemaValidationWarningsItems"}}},"required":["warnings"],"description":"Non-blocking findings from a successful write. `warnings` also carries `SESSION_PREVIEW_URL` when `config.url` or `config.serverUrl` is a session sandbox preview URL, which stops working when that sandbox container stops.","title":"V1ToolsFlowsFlowIdConvertToToolPostResponsesContentApplicationJsonSchemaValidation"},"Tools_convertFlowToTool_Response_200":{"type":"object","properties":{"config":{"type":["object","null"],"additionalProperties":{"description":"Any type"}},"createdAt":{"type":"string"},"description":{"type":["string","null"]},"id":{"type":"string"},"isActive":{"type":"boolean"},"lastModifiedSource":{"type":["string","null"]},"name":{"type":"string"},"organizationId":{"type":["string","null"]},"parametersSchema":{"type":"object","additionalProperties":{"description":"Any type"}},"toolType":{"type":"string"},"updatedAt":{"type":"string"},"userId":{"type":["string","null"]},"validation":{"$ref":"#/components/schemas/V1ToolsFlowsFlowIdConvertToToolPostResponsesContentApplicationJsonSchemaValidation","description":"Non-blocking findings from a successful write. `warnings` also carries `SESSION_PREVIEW_URL` when `config.url` or `config.serverUrl` is a session sandbox preview URL, which stops working when that sandbox container stops."}},"required":["config","createdAt","description","id","isActive","name","organizationId","toolType","updatedAt","userId"],"title":"Tools_convertFlowToTool_Response_200"},"ToolPullResponseDefinitionToolType":{"type":"string","enum":["flow","custom","external","graphql","mcp","local","subagent"],"title":"ToolPullResponseDefinitionToolType"},"ToolPullResponseDefinition":{"type":"object","properties":{"config":{"type":"object","additionalProperties":{"description":"Any type"}},"description":{"type":"string","minLength":1,"maxLength":500},"name":{"type":"string","minLength":1,"maxLength":100},"parametersSchema":{"type":"object","additionalProperties":{"description":"Any type"}},"toolType":{"$ref":"#/components/schemas/ToolPullResponseDefinitionToolType"}},"required":["config","description","name","parametersSchema","toolType"],"title":"ToolPullResponseDefinition"},"ToolPullResponse":{"type":"object","properties":{"contentHash":{"type":"string"},"definition":{"$ref":"#/components/schemas/ToolPullResponseDefinition"},"lastModifiedSource":{"type":["string","null"]},"toolId":{"type":"string"},"updatedAt":{"type":["string","null"]}},"required":["contentHash","definition","lastModifiedSource","toolId","updatedAt"],"title":"ToolPullResponse"},"V1ToolsSandboxCfSandboxDeployPostRequestBodyContentApplicationJsonSchemaLanguage":{"type":"string","enum":["javascript","typescript","python"],"title":"V1ToolsSandboxCfSandboxDeployPostRequestBodyContentApplicationJsonSchemaLanguage"},"V1ToolsSandboxCfSandboxDeployPostRequestBodyContentApplicationJsonSchemaRetention":{"type":"string","enum":["10m","1h","24h","unlimited"],"title":"V1ToolsSandboxCfSandboxDeployPostRequestBodyContentApplicationJsonSchemaRetention"},"V1ToolsSandboxCfSandboxDeployPostRequestBodyContentApplicationJsonSchemaSleepPolicyOneOf0Mode":{"type":"string","enum":["never"],"title":"V1ToolsSandboxCfSandboxDeployPostRequestBodyContentApplicationJsonSchemaSleepPolicyOneOf0Mode"},"V1ToolsSandboxCfSandboxDeployPostRequestBodyContentApplicationJsonSchemaSleepPolicy0":{"type":"object","properties":{"mode":{"$ref":"#/components/schemas/V1ToolsSandboxCfSandboxDeployPostRequestBodyContentApplicationJsonSchemaSleepPolicyOneOf0Mode"}},"required":["mode"],"title":"V1ToolsSandboxCfSandboxDeployPostRequestBodyContentApplicationJsonSchemaSleepPolicy0"},"V1ToolsSandboxCfSandboxDeployPostRequestBodyContentApplicationJsonSchemaSleepPolicyOneOf1After":{"type":"string","enum":["5m","15m","30m","1h"],"title":"V1ToolsSandboxCfSandboxDeployPostRequestBodyContentApplicationJsonSchemaSleepPolicyOneOf1After"},"V1ToolsSandboxCfSandboxDeployPostRequestBodyContentApplicationJsonSchemaSleepPolicyOneOf1Mode":{"type":"string","enum":["idle"],"title":"V1ToolsSandboxCfSandboxDeployPostRequestBodyContentApplicationJsonSchemaSleepPolicyOneOf1Mode"},"V1ToolsSandboxCfSandboxDeployPostRequestBodyContentApplicationJsonSchemaSleepPolicy1":{"type":"object","properties":{"after":{"$ref":"#/components/schemas/V1ToolsSandboxCfSandboxDeployPostRequestBodyContentApplicationJsonSchemaSleepPolicyOneOf1After"},"mode":{"$ref":"#/components/schemas/V1ToolsSandboxCfSandboxDeployPostRequestBodyContentApplicationJsonSchemaSleepPolicyOneOf1Mode"}},"required":["after","mode"],"title":"V1ToolsSandboxCfSandboxDeployPostRequestBodyContentApplicationJsonSchemaSleepPolicy1"},"V1ToolsSandboxCfSandboxDeployPostRequestBodyContentApplicationJsonSchemaSleepPolicy":{"oneOf":[{"$ref":"#/components/schemas/V1ToolsSandboxCfSandboxDeployPostRequestBodyContentApplicationJsonSchemaSleepPolicy0"},{"$ref":"#/components/schemas/V1ToolsSandboxCfSandboxDeployPostRequestBodyContentApplicationJsonSchemaSleepPolicy1"}],"title":"V1ToolsSandboxCfSandboxDeployPostRequestBodyContentApplicationJsonSchemaSleepPolicy"},"V1ToolsSandboxCfSandboxDeployPostResponsesContentApplicationJsonSchemaEffectivePolicyMetering":{"type":"string","enum":["active","legacy-untracked"],"title":"V1ToolsSandboxCfSandboxDeployPostResponsesContentApplicationJsonSchemaEffectivePolicyMetering"},"V1ToolsSandboxCfSandboxDeployPostResponsesContentApplicationJsonSchemaEffectivePolicyOrigin":{"type":"string","enum":["explicit","legacy-default"],"title":"V1ToolsSandboxCfSandboxDeployPostResponsesContentApplicationJsonSchemaEffectivePolicyOrigin"},"V1ToolsSandboxCfSandboxDeployPostResponsesContentApplicationJsonSchemaEffectivePolicyRetention":{"type":"string","enum":["10m","1h","24h","unlimited"],"title":"V1ToolsSandboxCfSandboxDeployPostResponsesContentApplicationJsonSchemaEffectivePolicyRetention"},"V1ToolsSandboxCfSandboxDeployPostResponsesContentApplicationJsonSchemaEffectivePolicySleepPolicyOneOf0Mode":{"type":"string","enum":["never"],"title":"V1ToolsSandboxCfSandboxDeployPostResponsesContentApplicationJsonSchemaEffectivePolicySleepPolicyOneOf0Mode"},"V1ToolsSandboxCfSandboxDeployPostResponsesContentApplicationJsonSchemaEffectivePolicySleepPolicy0":{"type":"object","properties":{"mode":{"$ref":"#/components/schemas/V1ToolsSandboxCfSandboxDeployPostResponsesContentApplicationJsonSchemaEffectivePolicySleepPolicyOneOf0Mode"}},"required":["mode"],"title":"V1ToolsSandboxCfSandboxDeployPostResponsesContentApplicationJsonSchemaEffectivePolicySleepPolicy0"},"V1ToolsSandboxCfSandboxDeployPostResponsesContentApplicationJsonSchemaEffectivePolicySleepPolicyOneOf1After":{"type":"string","enum":["5m","15m","30m","1h"],"title":"V1ToolsSandboxCfSandboxDeployPostResponsesContentApplicationJsonSchemaEffectivePolicySleepPolicyOneOf1After"},"V1ToolsSandboxCfSandboxDeployPostResponsesContentApplicationJsonSchemaEffectivePolicySleepPolicyOneOf1Mode":{"type":"string","enum":["idle"],"title":"V1ToolsSandboxCfSandboxDeployPostResponsesContentApplicationJsonSchemaEffectivePolicySleepPolicyOneOf1Mode"},"V1ToolsSandboxCfSandboxDeployPostResponsesContentApplicationJsonSchemaEffectivePolicySleepPolicy1":{"type":"object","properties":{"after":{"$ref":"#/components/schemas/V1ToolsSandboxCfSandboxDeployPostResponsesContentApplicationJsonSchemaEffectivePolicySleepPolicyOneOf1After"},"mode":{"$ref":"#/components/schemas/V1ToolsSandboxCfSandboxDeployPostResponsesContentApplicationJsonSchemaEffectivePolicySleepPolicyOneOf1Mode"}},"required":["after","mode"],"title":"V1ToolsSandboxCfSandboxDeployPostResponsesContentApplicationJsonSchemaEffectivePolicySleepPolicy1"},"V1ToolsSandboxCfSandboxDeployPostResponsesContentApplicationJsonSchemaEffectivePolicySleepPolicy":{"oneOf":[{"$ref":"#/components/schemas/V1ToolsSandboxCfSandboxDeployPostResponsesContentApplicationJsonSchemaEffectivePolicySleepPolicy0"},{"$ref":"#/components/schemas/V1ToolsSandboxCfSandboxDeployPostResponsesContentApplicationJsonSchemaEffectivePolicySleepPolicy1"}],"title":"V1ToolsSandboxCfSandboxDeployPostResponsesContentApplicationJsonSchemaEffectivePolicySleepPolicy"},"V1ToolsSandboxCfSandboxDeployPostResponsesContentApplicationJsonSchemaEffectivePolicy":{"type":"object","properties":{"autoDeleteInterval":{"type":"number","format":"double"},"autoStopInterval":{"type":"number","format":"double"},"containerEpoch":{"type":"integer","description":"Runtype Sandbox: the container epoch the preview URL is bound to; a new epoch mints a new URL."},"expiresAt":{"type":["string","null"]},"freshContainer":{"type":"boolean","description":"Runtype Sandbox: true when this deploy started a new container rather than reusing a running one."},"metering":{"$ref":"#/components/schemas/V1ToolsSandboxCfSandboxDeployPostResponsesContentApplicationJsonSchemaEffectivePolicyMetering"},"origin":{"$ref":"#/components/schemas/V1ToolsSandboxCfSandboxDeployPostResponsesContentApplicationJsonSchemaEffectivePolicyOrigin"},"previewUrlChanged":{"type":"boolean","description":"Runtype Sandbox: true when the preview URL differs from the one the previous successful deploy to this sandbox returned. Re-register any saved copy of the old URL. False for a first deploy."},"retention":{"$ref":"#/components/schemas/V1ToolsSandboxCfSandboxDeployPostResponsesContentApplicationJsonSchemaEffectivePolicyRetention"},"sleepPolicy":{"$ref":"#/components/schemas/V1ToolsSandboxCfSandboxDeployPostResponsesContentApplicationJsonSchemaEffectivePolicySleepPolicy"}},"required":["expiresAt","metering","origin","retention"],"title":"V1ToolsSandboxCfSandboxDeployPostResponsesContentApplicationJsonSchemaEffectivePolicy"},"Tools_deployRuntypeSandbox_Response_200":{"type":"object","properties":{"effectivePolicy":{"$ref":"#/components/schemas/V1ToolsSandboxCfSandboxDeployPostResponsesContentApplicationJsonSchemaEffectivePolicy"},"error":{"type":"string"},"output":{"type":"string"},"previewUrl":{"type":"string"},"sandboxId":{"type":"string"},"stage":{"type":"string"},"status":{"type":"string"}},"required":["sandboxId","status"],"title":"Tools_deployRuntypeSandbox_Response_200"},"Tools_cleanupRuntypeSandbox_Response_200":{"type":"object","properties":{"success":{"type":"boolean"}},"required":["success"],"title":"Tools_cleanupRuntypeSandbox_Response_200"},"V1ToolsSandboxDeployPostRequestBodyContentApplicationJsonSchemaLanguage":{"type":"string","enum":["javascript","typescript","python"],"title":"V1ToolsSandboxDeployPostRequestBodyContentApplicationJsonSchemaLanguage"},"V1ToolsSandboxDeployPostRequestBodyContentApplicationJsonSchemaRetention":{"type":"string","enum":["10m","1h","24h","unlimited"],"title":"V1ToolsSandboxDeployPostRequestBodyContentApplicationJsonSchemaRetention"},"V1ToolsSandboxDeployPostRequestBodyContentApplicationJsonSchemaSleepPolicyOneOf0Mode":{"type":"string","enum":["never"],"title":"V1ToolsSandboxDeployPostRequestBodyContentApplicationJsonSchemaSleepPolicyOneOf0Mode"},"V1ToolsSandboxDeployPostRequestBodyContentApplicationJsonSchemaSleepPolicy0":{"type":"object","properties":{"mode":{"$ref":"#/components/schemas/V1ToolsSandboxDeployPostRequestBodyContentApplicationJsonSchemaSleepPolicyOneOf0Mode"}},"required":["mode"],"title":"V1ToolsSandboxDeployPostRequestBodyContentApplicationJsonSchemaSleepPolicy0"},"V1ToolsSandboxDeployPostRequestBodyContentApplicationJsonSchemaSleepPolicyOneOf1After":{"type":"string","enum":["5m","15m","30m","1h"],"title":"V1ToolsSandboxDeployPostRequestBodyContentApplicationJsonSchemaSleepPolicyOneOf1After"},"V1ToolsSandboxDeployPostRequestBodyContentApplicationJsonSchemaSleepPolicyOneOf1Mode":{"type":"string","enum":["idle"],"title":"V1ToolsSandboxDeployPostRequestBodyContentApplicationJsonSchemaSleepPolicyOneOf1Mode"},"V1ToolsSandboxDeployPostRequestBodyContentApplicationJsonSchemaSleepPolicy1":{"type":"object","properties":{"after":{"$ref":"#/components/schemas/V1ToolsSandboxDeployPostRequestBodyContentApplicationJsonSchemaSleepPolicyOneOf1After"},"mode":{"$ref":"#/components/schemas/V1ToolsSandboxDeployPostRequestBodyContentApplicationJsonSchemaSleepPolicyOneOf1Mode"}},"required":["after","mode"],"title":"V1ToolsSandboxDeployPostRequestBodyContentApplicationJsonSchemaSleepPolicy1"},"V1ToolsSandboxDeployPostRequestBodyContentApplicationJsonSchemaSleepPolicy":{"oneOf":[{"$ref":"#/components/schemas/V1ToolsSandboxDeployPostRequestBodyContentApplicationJsonSchemaSleepPolicy0"},{"$ref":"#/components/schemas/V1ToolsSandboxDeployPostRequestBodyContentApplicationJsonSchemaSleepPolicy1"}],"title":"V1ToolsSandboxDeployPostRequestBodyContentApplicationJsonSchemaSleepPolicy"},"V1ToolsSandboxDeployPostResponsesContentApplicationJsonSchemaEffectivePolicyMetering":{"type":"string","enum":["active","legacy-untracked"],"title":"V1ToolsSandboxDeployPostResponsesContentApplicationJsonSchemaEffectivePolicyMetering"},"V1ToolsSandboxDeployPostResponsesContentApplicationJsonSchemaEffectivePolicyOrigin":{"type":"string","enum":["explicit","legacy-default"],"title":"V1ToolsSandboxDeployPostResponsesContentApplicationJsonSchemaEffectivePolicyOrigin"},"V1ToolsSandboxDeployPostResponsesContentApplicationJsonSchemaEffectivePolicyRetention":{"type":"string","enum":["10m","1h","24h","unlimited"],"title":"V1ToolsSandboxDeployPostResponsesContentApplicationJsonSchemaEffectivePolicyRetention"},"V1ToolsSandboxDeployPostResponsesContentApplicationJsonSchemaEffectivePolicySleepPolicyOneOf0Mode":{"type":"string","enum":["never"],"title":"V1ToolsSandboxDeployPostResponsesContentApplicationJsonSchemaEffectivePolicySleepPolicyOneOf0Mode"},"V1ToolsSandboxDeployPostResponsesContentApplicationJsonSchemaEffectivePolicySleepPolicy0":{"type":"object","properties":{"mode":{"$ref":"#/components/schemas/V1ToolsSandboxDeployPostResponsesContentApplicationJsonSchemaEffectivePolicySleepPolicyOneOf0Mode"}},"required":["mode"],"title":"V1ToolsSandboxDeployPostResponsesContentApplicationJsonSchemaEffectivePolicySleepPolicy0"},"V1ToolsSandboxDeployPostResponsesContentApplicationJsonSchemaEffectivePolicySleepPolicyOneOf1After":{"type":"string","enum":["5m","15m","30m","1h"],"title":"V1ToolsSandboxDeployPostResponsesContentApplicationJsonSchemaEffectivePolicySleepPolicyOneOf1After"},"V1ToolsSandboxDeployPostResponsesContentApplicationJsonSchemaEffectivePolicySleepPolicyOneOf1Mode":{"type":"string","enum":["idle"],"title":"V1ToolsSandboxDeployPostResponsesContentApplicationJsonSchemaEffectivePolicySleepPolicyOneOf1Mode"},"V1ToolsSandboxDeployPostResponsesContentApplicationJsonSchemaEffectivePolicySleepPolicy1":{"type":"object","properties":{"after":{"$ref":"#/components/schemas/V1ToolsSandboxDeployPostResponsesContentApplicationJsonSchemaEffectivePolicySleepPolicyOneOf1After"},"mode":{"$ref":"#/components/schemas/V1ToolsSandboxDeployPostResponsesContentApplicationJsonSchemaEffectivePolicySleepPolicyOneOf1Mode"}},"required":["after","mode"],"title":"V1ToolsSandboxDeployPostResponsesContentApplicationJsonSchemaEffectivePolicySleepPolicy1"},"V1ToolsSandboxDeployPostResponsesContentApplicationJsonSchemaEffectivePolicySleepPolicy":{"oneOf":[{"$ref":"#/components/schemas/V1ToolsSandboxDeployPostResponsesContentApplicationJsonSchemaEffectivePolicySleepPolicy0"},{"$ref":"#/components/schemas/V1ToolsSandboxDeployPostResponsesContentApplicationJsonSchemaEffectivePolicySleepPolicy1"}],"title":"V1ToolsSandboxDeployPostResponsesContentApplicationJsonSchemaEffectivePolicySleepPolicy"},"V1ToolsSandboxDeployPostResponsesContentApplicationJsonSchemaEffectivePolicy":{"type":"object","properties":{"autoDeleteInterval":{"type":"number","format":"double"},"autoStopInterval":{"type":"number","format":"double"},"containerEpoch":{"type":"integer","description":"Runtype Sandbox: the container epoch the preview URL is bound to; a new epoch mints a new URL."},"expiresAt":{"type":["string","null"]},"freshContainer":{"type":"boolean","description":"Runtype Sandbox: true when this deploy started a new container rather than reusing a running one."},"metering":{"$ref":"#/components/schemas/V1ToolsSandboxDeployPostResponsesContentApplicationJsonSchemaEffectivePolicyMetering"},"origin":{"$ref":"#/components/schemas/V1ToolsSandboxDeployPostResponsesContentApplicationJsonSchemaEffectivePolicyOrigin"},"previewUrlChanged":{"type":"boolean","description":"Runtype Sandbox: true when the preview URL differs from the one the previous successful deploy to this sandbox returned. Re-register any saved copy of the old URL. False for a first deploy."},"retention":{"$ref":"#/components/schemas/V1ToolsSandboxDeployPostResponsesContentApplicationJsonSchemaEffectivePolicyRetention"},"sleepPolicy":{"$ref":"#/components/schemas/V1ToolsSandboxDeployPostResponsesContentApplicationJsonSchemaEffectivePolicySleepPolicy"}},"required":["expiresAt","metering","origin","retention"],"title":"V1ToolsSandboxDeployPostResponsesContentApplicationJsonSchemaEffectivePolicy"},"Tools_deployDaytonaSandbox_Response_200":{"type":"object","properties":{"effectivePolicy":{"$ref":"#/components/schemas/V1ToolsSandboxDeployPostResponsesContentApplicationJsonSchemaEffectivePolicy"},"error":{"type":"string"},"output":{"type":"string"},"previewUrl":{"type":"string"},"sandboxId":{"type":"string"},"status":{"type":"string"}},"required":["status"],"title":"Tools_deployDaytonaSandbox_Response_200"},"Tools_cleanupDaytonaSandbox_Response_200":{"type":"object","properties":{"success":{"type":"boolean"}},"required":["success"],"title":"Tools_cleanupDaytonaSandbox_Response_200"},"V1ToolsSchemaGetResponsesContentApplicationJsonSchemaToolsItems":{"type":"object","properties":{"description":{"type":["string","null"]},"id":{"type":"string"},"name":{"type":"string"},"parametersSchema":{"type":["object","null"],"additionalProperties":{"description":"Any type"}},"toolType":{"type":"string"}},"required":["description","id","name","parametersSchema","toolType"],"title":"V1ToolsSchemaGetResponsesContentApplicationJsonSchemaToolsItems"},"Tools_getToolSchemas_Response_200":{"type":"object","properties":{"tools":{"type":"array","items":{"$ref":"#/components/schemas/V1ToolsSchemaGetResponsesContentApplicationJsonSchemaToolsItems"}}},"required":["tools"],"title":"Tools_getToolSchemas_Response_200"},"Tools_getToolDetails_Response_200":{"type":"object","properties":{"config":{"type":["object","null"],"additionalProperties":{"description":"Any type"}},"createdAt":{"type":"string"},"description":{"type":["string","null"]},"id":{"type":"string"},"isActive":{"type":"boolean"},"lastModifiedSource":{"type":["string","null"]},"name":{"type":"string"},"organizationId":{"type":["string","null"]},"parametersSchema":{"type":"object","additionalProperties":{"description":"Any type"}},"toolType":{"type":"string"},"updatedAt":{"type":"string"},"userId":{"type":["string","null"]}},"required":["config","createdAt","description","id","isActive","name","organizationId","toolType","updatedAt","userId"],"title":"Tools_getToolDetails_Response_200"},"V1ToolsIdPutResponsesContentApplicationJsonSchemaValidationWarningsItemsSeverity":{"type":"string","enum":["error","warning"],"title":"V1ToolsIdPutResponsesContentApplicationJsonSchemaValidationWarningsItemsSeverity"},"V1ToolsIdPutResponsesContentApplicationJsonSchemaValidationWarningsItems":{"type":"object","properties":{"code":{"type":"string"},"column":{"type":"number","format":"double"},"line":{"type":"number","format":"double"},"message":{"type":"string"},"severity":{"$ref":"#/components/schemas/V1ToolsIdPutResponsesContentApplicationJsonSchemaValidationWarningsItemsSeverity"},"suggestion":{"type":"string"}},"required":["code","message","severity"],"title":"V1ToolsIdPutResponsesContentApplicationJsonSchemaValidationWarningsItems"},"V1ToolsIdPutResponsesContentApplicationJsonSchemaValidation":{"type":"object","properties":{"recommendations":{"type":"array","items":{"$ref":"#/components/schemas/FlowValidationIssue"}},"warnings":{"type":"array","items":{"$ref":"#/components/schemas/V1ToolsIdPutResponsesContentApplicationJsonSchemaValidationWarningsItems"}}},"required":["warnings"],"description":"Non-blocking findings from a successful write. `warnings` also carries `SESSION_PREVIEW_URL` when `config.url` or `config.serverUrl` is a session sandbox preview URL, which stops working when that sandbox container stops.","title":"V1ToolsIdPutResponsesContentApplicationJsonSchemaValidation"},"Tools_updateTool_Response_200":{"type":"object","properties":{"config":{"type":["object","null"],"additionalProperties":{"description":"Any type"}},"createdAt":{"type":"string"},"description":{"type":["string","null"]},"id":{"type":"string"},"isActive":{"type":"boolean"},"lastModifiedSource":{"type":["string","null"]},"name":{"type":"string"},"organizationId":{"type":["string","null"]},"parametersSchema":{"type":"object","additionalProperties":{"description":"Any type"}},"toolType":{"type":"string"},"updatedAt":{"type":"string"},"userId":{"type":["string","null"]},"validation":{"$ref":"#/components/schemas/V1ToolsIdPutResponsesContentApplicationJsonSchemaValidation","description":"Non-blocking findings from a successful write. `warnings` also carries `SESSION_PREVIEW_URL` when `config.url` or `config.serverUrl` is a session sandbox preview URL, which stops working when that sandbox container stops."}},"required":["config","createdAt","description","id","isActive","name","organizationId","toolType","updatedAt","userId"],"title":"Tools_updateTool_Response_200"},"Tools_deleteTool_Response_200":{"type":"object","properties":{"deletedId":{"type":"string"},"success":{"type":"boolean"}},"required":["deletedId","success"],"title":"Tools_deleteTool_Response_200"},"V1ToolsIdExecutePostRequestBodyContentApplicationJsonSchemaContext":{"type":"object","properties":{"flowExecutionId":{"type":"string"},"stepId":{"type":"string"},"userId":{"type":"string"}},"required":["userId"],"title":"V1ToolsIdExecutePostRequestBodyContentApplicationJsonSchemaContext"},"BuiltinToolExecuteResult":{"type":"object","properties":{"metadata":{"type":"object","additionalProperties":{"description":"Any type"},"description":"Execution metadata for the caller, never part of a model-facing tool result. builtin:decision_judge sets metadata.judgment: requestedModel, resolvedModelId (null when not reported), provider, route, calibrationId (null when absent), keySource, questionSetId and questionSetVersion (configured mode), usage { inputTokens, outputTokens, reported }, and estimatedCostUsd (provider rates, before margin)."},"result":{"description":"Any type"},"toolId":{"type":"string"},"toolName":{"type":"string"}},"required":["toolId","toolName"],"title":"BuiltinToolExecuteResult"},"V1ToolsIdExecutePostResponsesContentApplicationJsonSchemaOneOf1Status":{"type":"string","enum":["pending","success","failed","waiting_for_local"],"title":"V1ToolsIdExecutePostResponsesContentApplicationJsonSchemaOneOf1Status"},"ToolsExecuteToolResponse2001":{"type":"object","properties":{"error":{"type":"string"},"executionId":{"type":"string"},"executionTimeMs":{"type":"number","format":"double"},"result":{"description":"Any type"},"status":{"$ref":"#/components/schemas/V1ToolsIdExecutePostResponsesContentApplicationJsonSchemaOneOf1Status"}},"required":["executionId","executionTimeMs","status"],"title":"ToolsExecuteToolResponse2001"},"Tools_executeTool_Response_200":{"oneOf":[{"$ref":"#/components/schemas/BuiltinToolExecuteResult"},{"$ref":"#/components/schemas/ToolsExecuteToolResponse2001"}],"title":"Tools_executeTool_Response_200"},"ToolExecuteError":{"type":"object","properties":{"code":{"type":"string","description":"Stable code for a caller-fixable failure, e.g. JUDGMENT_QUESTIONS_INVALID or QUESTION_SET_UNRESOLVED."},"details":{"type":"object","additionalProperties":{"description":"Any type"}},"error":{"type":"string"},"requiredScopes":{"type":"array","items":{"type":"string"},"description":"On `insufficient_scope`: every API key scope this request needs."}},"required":["error"],"title":"ToolExecuteError"},"V1ToolsIdTestPostResponsesContentApplicationJsonSchemaOneOf1Status":{"type":"string","enum":["pending","success","failed","waiting_for_local"],"title":"V1ToolsIdTestPostResponsesContentApplicationJsonSchemaOneOf1Status"},"ToolsTestToolResponse2001":{"type":"object","properties":{"error":{"type":"string"},"executionId":{"type":"string"},"executionTimeMs":{"type":"number","format":"double"},"result":{"description":"Any type"},"status":{"$ref":"#/components/schemas/V1ToolsIdTestPostResponsesContentApplicationJsonSchemaOneOf1Status"}},"required":["executionId","executionTimeMs","status"],"title":"ToolsTestToolResponse2001"},"Tools_testTool_Response_200":{"oneOf":[{"$ref":"#/components/schemas/BuiltinToolExecuteResult"},{"$ref":"#/components/schemas/ToolsTestToolResponse2001"}],"title":"Tools_testTool_Response_200"},"UsageResponseUsageDailyExecutionCapReason":{"type":"string","enum":["no_card_ceiling"],"title":"UsageResponseUsageDailyExecutionCapReason"},"UsageResponseUsageDaily":{"type":"object","properties":{"atSpendLimit":{"type":"boolean"},"date":{"type":"string"},"executionCapReason":{"$ref":"#/components/schemas/UsageResponseUsageDailyExecutionCapReason"},"executionLimit":{"type":"number","format":"double"},"executionsUsed":{"type":"number","format":"double"},"inSlowMode":{"type":"boolean"},"isAtLimit":{"type":"boolean"},"isNearLimit":{"type":"boolean"},"isOverage":{"type":"boolean"},"isUnlimited":{"type":"boolean"},"overageCount":{"type":"number","format":"double"},"percentUsed":{"type":"number","format":"double"},"periodType":{"type":"string"},"remaining":{"type":["number","null"],"format":"double"},"resetsAt":{"type":"string"},"spendLimit":{"type":["number","null"],"format":"double"},"spendLimitEnabled":{"type":"boolean"},"tier":{"type":"string"}},"required":["atSpendLimit","date","executionCapReason","executionLimit","executionsUsed","inSlowMode","isAtLimit","isNearLimit","isOverage","isUnlimited","overageCount","percentUsed","periodType","remaining","resetsAt","spendLimit","spendLimitEnabled","tier"],"title":"UsageResponseUsageDaily"},"UsageResponseUsageMonthlyExecutionCapReason":{"type":"string","enum":["no_card_ceiling"],"title":"UsageResponseUsageMonthlyExecutionCapReason"},"UsageResponseUsageMonthly":{"type":"object","properties":{"atSpendLimit":{"type":"boolean"},"date":{"type":"string"},"executionCapReason":{"$ref":"#/components/schemas/UsageResponseUsageMonthlyExecutionCapReason"},"executionLimit":{"type":"number","format":"double"},"executionsUsed":{"type":"number","format":"double"},"inSlowMode":{"type":"boolean"},"isAtLimit":{"type":"boolean"},"isNearLimit":{"type":"boolean"},"isOverage":{"type":"boolean"},"isUnlimited":{"type":"boolean"},"overageCount":{"type":"number","format":"double"},"percentUsed":{"type":"number","format":"double"},"periodType":{"type":"string"},"remaining":{"type":["number","null"],"format":"double"},"resetsAt":{"type":"string"},"spendLimit":{"type":["number","null"],"format":"double"},"spendLimitEnabled":{"type":"boolean"},"tier":{"type":"string"}},"required":["atSpendLimit","date","executionCapReason","executionLimit","executionsUsed","inSlowMode","isAtLimit","isNearLimit","isOverage","isUnlimited","overageCount","percentUsed","periodType","remaining","resetsAt","spendLimit","spendLimitEnabled","tier"],"title":"UsageResponseUsageMonthly"},"UsageResponseUsage":{"type":"object","properties":{"atSpendLimit":{"type":"boolean"},"daily":{"$ref":"#/components/schemas/UsageResponseUsageDaily"},"isNearLimit":{"type":"boolean"},"isOverLimit":{"type":"boolean"},"isUnlimited":{"type":"boolean"},"month":{"type":"string"},"monthly":{"$ref":"#/components/schemas/UsageResponseUsageMonthly"},"percentUsed":{"type":"number","format":"double"},"platformTokenLimit":{"type":["number","null"],"format":"double"},"platformTokensUsed":{"type":"number","format":"double"},"remaining":{"type":["number","null"],"format":"double"},"spendLimit":{"type":["number","null"],"format":"double"},"spendLimitEnabled":{"type":"boolean"},"userId":{"type":"string"}},"required":["atSpendLimit","isNearLimit","isOverLimit","isUnlimited","month","percentUsed","platformTokenLimit","platformTokensUsed","remaining","spendLimit","spendLimitEnabled","userId"],"title":"UsageResponseUsage"},"UsageResponse":{"type":"object","properties":{"usage":{"$ref":"#/components/schemas/UsageResponseUsage"}},"required":["usage"],"title":"UsageResponse"},"DailyUsageResponseDailyExecutionCapReason":{"type":"string","enum":["no_card_ceiling"],"title":"DailyUsageResponseDailyExecutionCapReason"},"DailyUsageResponseDaily":{"type":"object","properties":{"atSpendLimit":{"type":"boolean"},"date":{"type":"string"},"executionCapReason":{"$ref":"#/components/schemas/DailyUsageResponseDailyExecutionCapReason"},"executionLimit":{"type":"number","format":"double"},"executionsUsed":{"type":"number","format":"double"},"inSlowMode":{"type":"boolean"},"isAtLimit":{"type":"boolean"},"isNearLimit":{"type":"boolean"},"isOverage":{"type":"boolean"},"isUnlimited":{"type":"boolean"},"overageCount":{"type":"number","format":"double"},"percentUsed":{"type":"number","format":"double"},"periodType":{"type":"string"},"remaining":{"type":["number","null"],"format":"double"},"resetsAt":{"type":"string"},"spendLimit":{"type":["number","null"],"format":"double"},"spendLimitEnabled":{"type":"boolean"},"tier":{"type":"string"}},"required":["atSpendLimit","date","executionCapReason","executionLimit","executionsUsed","inSlowMode","isAtLimit","isNearLimit","isOverage","isUnlimited","overageCount","percentUsed","periodType","remaining","resetsAt","spendLimit","spendLimitEnabled","tier"],"title":"DailyUsageResponseDaily"},"DailyUsageResponseMonthlyExecutionCapReason":{"type":"string","enum":["no_card_ceiling"],"title":"DailyUsageResponseMonthlyExecutionCapReason"},"DailyUsageResponseMonthly":{"type":"object","properties":{"atSpendLimit":{"type":"boolean"},"date":{"type":"string"},"executionCapReason":{"$ref":"#/components/schemas/DailyUsageResponseMonthlyExecutionCapReason"},"executionLimit":{"type":"number","format":"double"},"executionsUsed":{"type":"number","format":"double"},"inSlowMode":{"type":"boolean"},"isAtLimit":{"type":"boolean"},"isNearLimit":{"type":"boolean"},"isOverage":{"type":"boolean"},"isUnlimited":{"type":"boolean"},"overageCount":{"type":"number","format":"double"},"percentUsed":{"type":"number","format":"double"},"periodType":{"type":"string"},"remaining":{"type":["number","null"],"format":"double"},"resetsAt":{"type":"string"},"spendLimit":{"type":["number","null"],"format":"double"},"spendLimitEnabled":{"type":"boolean"},"tier":{"type":"string"}},"required":["atSpendLimit","date","executionCapReason","executionLimit","executionsUsed","inSlowMode","isAtLimit","isNearLimit","isOverage","isUnlimited","overageCount","percentUsed","periodType","remaining","resetsAt","spendLimit","spendLimitEnabled","tier"],"title":"DailyUsageResponseMonthly"},"DailyUsageResponse":{"type":"object","properties":{"daily":{"$ref":"#/components/schemas/DailyUsageResponseDaily"},"monthly":{"$ref":"#/components/schemas/DailyUsageResponseMonthly"}},"title":"DailyUsageResponse"},"Users_completeOnboarding_Response_200":{"type":"object","properties":{"completed":{"type":"boolean"},"completedAt":{"type":["string","null"]}},"required":["completed","completedAt"],"title":"Users_completeOnboarding_Response_200"},"V1UsersOnboardingIntentPostRequestBodyContentApplicationJsonSchemaOnboardingIntent":{"type":"string","enum":["build_new","connect_existing","unstated"],"title":"V1UsersOnboardingIntentPostRequestBodyContentApplicationJsonSchemaOnboardingIntent"},"V1UsersOnboardingIntentPostResponsesContentApplicationJsonSchemaOnboardingIntent":{"type":"string","enum":["build_new","connect_existing","unstated"],"title":"V1UsersOnboardingIntentPostResponsesContentApplicationJsonSchemaOnboardingIntent"},"Users_setOnboardingIntent_Response_200":{"type":"object","properties":{"onboardingIntent":{"$ref":"#/components/schemas/V1UsersOnboardingIntentPostResponsesContentApplicationJsonSchemaOnboardingIntent"}},"required":["onboardingIntent"],"title":"Users_setOnboardingIntent_Response_200"},"Users_resetOnboarding_Response_200":{"type":"object","properties":{"completed":{"type":"boolean"},"completedAt":{"type":["string","null"]}},"required":["completed","completedAt"],"title":"Users_resetOnboarding_Response_200"},"V1UsersProfileGetResponsesContentApplicationJsonSchemaFeatures":{"type":"object","properties":{"dashboardAssistantModel":{"type":"string"},"enableAgentKeyRequests":{"type":"boolean"},"enableAgentSkills":{"type":"boolean"},"enableCanvasOnboarding":{"type":"boolean"},"enableChromeSurface":{"type":"boolean"},"enableClaudeManagedAgents":{"type":"boolean"},"enableCliSurface":{"type":"boolean"},"enableCliSurfaceInstallDomain":{"type":"boolean"},"enableCliSurfacePublish":{"type":"boolean"},"enableDashboardAssistant":{"type":"boolean"},"enableDecisionModelsDashboard":{"type":"boolean"},"enableDelegateToOtto":{"type":"boolean"},"enableDelegateToRuntype":{"type":"boolean"},"enableEndUserUsageAnalytics":{"type":"boolean"},"enableMassiveWebRender":{"type":"boolean"},"enableMcpSurfaceCustomerIdp":{"type":"boolean"},"enableMcpSurfaceDeviceGrant":{"type":"boolean"},"enableMcpSurfaceOobApprovals":{"type":"boolean"},"enableMcpSurfaceSignIn":{"type":"boolean"},"enableOnboardingIntentGate":{"type":"boolean"},"enableOpenAiLiveVoice":{"type":"boolean"},"enableRuntown":{"type":"boolean"},"enableRuntypeApps":{"type":"boolean"},"enableSelfServeOauthClients":{"type":"boolean"},"enableSimulationLocalTargets":{"type":"boolean"},"enableVoice":{"type":"boolean"},"enableWorkbench":{"type":"boolean"},"enableWorkspaceModel":{"type":"boolean"},"externalTelemetryAllowed":{"type":"boolean"},"modelCreditPromoMultiplier":{"type":"number","format":"double","minimum":0,"maximum":1},"signalsConfigured":{"type":"boolean"},"simulationsAvailable":{"type":"boolean"},"workspaceModelEligible":{"type":"boolean"},"workspaceModelReady":{"type":"boolean"}},"required":["dashboardAssistantModel","enableAgentKeyRequests","enableAgentSkills","enableCanvasOnboarding","enableChromeSurface","enableDashboardAssistant","enableDecisionModelsDashboard","enableEndUserUsageAnalytics","enableMassiveWebRender","enableOnboardingIntentGate","enableRuntown","enableRuntypeApps","enableSelfServeOauthClients","enableVoice","enableWorkbench","enableWorkspaceModel","workspaceModelEligible","workspaceModelReady"],"title":"V1UsersProfileGetResponsesContentApplicationJsonSchemaFeatures"},"V1UsersProfileGetResponsesContentApplicationJsonSchemaPreferences":{"type":"object","properties":{"notifications":{"type":"boolean"},"theme":{"type":"string"}},"required":["notifications","theme"],"title":"V1UsersProfileGetResponsesContentApplicationJsonSchemaPreferences"},"Users_getUserProfile_Response_200":{"type":"object","properties":{"createdAt":{"type":"string"},"dashboardUrl":{"type":"string"},"email":{"type":["string","null"]},"features":{"$ref":"#/components/schemas/V1UsersProfileGetResponsesContentApplicationJsonSchemaFeatures"},"id":{"type":"string"},"orgId":{"type":["string","null"]},"orgName":{"type":["string","null"]},"preferences":{"$ref":"#/components/schemas/V1UsersProfileGetResponsesContentApplicationJsonSchemaPreferences"}},"required":["createdAt","dashboardUrl","email","features","id","orgName","preferences"],"title":"Users_getUserProfile_Response_200"},"V1UsersProfilePutRequestBodyContentApplicationJsonSchemaPreferencesTheme":{"type":"string","enum":["light","dark","system"],"title":"V1UsersProfilePutRequestBodyContentApplicationJsonSchemaPreferencesTheme"},"V1UsersProfilePutRequestBodyContentApplicationJsonSchemaPreferences":{"type":"object","properties":{"defaultModel":{"type":"string"},"notifications":{"type":"boolean"},"theme":{"$ref":"#/components/schemas/V1UsersProfilePutRequestBodyContentApplicationJsonSchemaPreferencesTheme"}},"title":"V1UsersProfilePutRequestBodyContentApplicationJsonSchemaPreferences"},"UpdateUserProfileResponsePreferencesTheme":{"type":"string","enum":["light","dark","system"],"title":"UpdateUserProfileResponsePreferencesTheme"},"UpdateUserProfileResponsePreferences":{"type":"object","properties":{"defaultModel":{"type":"string"},"notifications":{"type":"boolean"},"theme":{"$ref":"#/components/schemas/UpdateUserProfileResponsePreferencesTheme"}},"title":"UpdateUserProfileResponsePreferences"},"UpdateUserProfileResponse":{"type":"object","properties":{"email":{"type":"string"},"firstName":{"type":"string"},"id":{"type":"string"},"lastName":{"type":"string"},"preferences":{"$ref":"#/components/schemas/UpdateUserProfileResponsePreferences"},"updatedAt":{"type":"string"}},"required":["id","updatedAt"],"title":"UpdateUserProfileResponse"},"V1UsersStatsGetResponsesContentApplicationJsonSchemaStats":{"type":"object","properties":{"totalExecutions":{"type":"number","format":"double"},"totalFlows":{"type":"number","format":"double"},"totalPrompts":{"type":"number","format":"double"},"totalRecords":{"type":"number","format":"double"}},"required":["totalExecutions","totalFlows","totalPrompts","totalRecords"],"title":"V1UsersStatsGetResponsesContentApplicationJsonSchemaStats"},"Users_getUserStatistics_Response_200":{"type":"object","properties":{"lastActive":{"type":"string"},"stats":{"$ref":"#/components/schemas/V1UsersStatsGetResponsesContentApplicationJsonSchemaStats"},"userId":{"type":"string"}},"required":["lastActive","stats","userId"],"title":"Users_getUserStatistics_Response_200"},"V1ValidateLiquidTemplatePostResponsesContentApplicationJsonSchemaIssuesItems":{"type":"object","properties":{},"title":"V1ValidateLiquidTemplatePostResponsesContentApplicationJsonSchemaIssuesItems"},"Validation_validateLiquidTemplate_Response_200":{"type":"object","properties":{"issues":{"type":"array","items":{"$ref":"#/components/schemas/V1ValidateLiquidTemplatePostResponsesContentApplicationJsonSchemaIssuesItems"}},"valid":{"type":"boolean"}},"required":["issues","valid"],"title":"Validation_validateLiquidTemplate_Response_200"},"V1ValidateTransformCodePostResponsesContentApplicationJsonSchemaIssuesItems":{"type":"object","properties":{},"title":"V1ValidateTransformCodePostResponsesContentApplicationJsonSchemaIssuesItems"},"Validation_validateTransformCode_Response_200":{"type":"object","properties":{"issues":{"type":"array","items":{"$ref":"#/components/schemas/V1ValidateTransformCodePostResponsesContentApplicationJsonSchemaIssuesItems"}},"valid":{"type":"boolean"}},"required":["issues","valid"],"title":"Validation_validateTransformCode_Response_200"}},"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","description":"API key or Clerk session token"},"A2ASurfaceKey":{"type":"apiKey","in":"header","name":"Authorization","description":"A2A surface key sent as `Authorization: Bearer a2a_...` or `X-API-Key: a2a_...`."}}}}