import createOpenAPIClient, { ClientOptions } from "openapi-fetch";

//#region src/api.d.ts

/**
 * This file was auto-generated by openapi-typescript.
 * Do not make direct changes to the file.
 */
interface paths {
  "/v1/agent-approvals/{approvalId}": {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    /**
     * Poll an approval
     * @description Reports where an approval stands, so an agent holding an approval_required response can wait for the sponsor's decision and retry. Only the agent the approval belongs to can read it.
     */
    get: operations["getV1Agent-approvalsByApprovalId"];
    put?: never;
    post?: never;
    delete?: never;
    options?: never;
    head?: never;
    patch?: never;
    trace?: never;
  };
  "/v1/apps": {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    /**
     * List apps
     * @deprecated
     * @description ⚠️ Experimental endpoint: this API is in active development and may change at any time without notice. ⚠️
     *
     *     Deprecated: use `GET /v1/services` instead.
     *
     *     Returns all apps the token has access to, ordered by creation time (oldest first). Optionally filter by project ID. Supports cursor-based pagination.
     */
    get: operations["getV1Apps"];
    put?: never;
    /**
     * Create app
     * @deprecated
     * @description ⚠️ Experimental endpoint: this API is in active development and may change at any time without notice. ⚠️
     *
     *     Deprecated: use `POST /v1/services` instead.
     *
     *     Creates a new app under the specified project. The `projectId` is required in the request body. The app is placed in the given region, or the project's default region if omitted (falling back to us-east-1). Returns `409 Conflict` when an app already occupies the slot on the resolved branch, either by name or by `logicalId`; the body includes the existing app's id, name, branch, and logical id, and `conflict` says which attribute clashed. The name is checked first. `logicalId` cannot be combined with `branchGitName`; pass `branchId` instead.
     */
    post: operations["postV1Apps"];
    delete?: never;
    options?: never;
    head?: never;
    patch?: never;
    trace?: never;
  };
  "/v1/apps/{appId}": {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    /**
     * Get app
     * @deprecated
     * @description ⚠️ Experimental endpoint: this API is in active development and may change at any time without notice. ⚠️
     *
     *     Deprecated: use `GET /v1/services/{serviceId}` instead.
     *
     *     Returns an app by ID, including its region and active promoted deployment reference.
     */
    get: operations["getV1AppsByAppId"];
    put?: never;
    post?: never;
    /**
     * Delete app
     * @deprecated
     * @description ⚠️ Experimental endpoint: this API is in active development and may change at any time without notice. ⚠️
     *
     *     Deprecated: use `DELETE /v1/services/{serviceId}` instead.
     *
     *     Deletes an app. Deployments under the app are deleted before the app is deleted.
     */
    delete: operations["deleteV1AppsByAppId"];
    options?: never;
    head?: never;
    /**
     * Update app
     * @deprecated
     * @description ⚠️ Experimental endpoint: this API is in active development and may change at any time without notice. ⚠️
     *
     *     Deprecated: use `PATCH /v1/services/{serviceId}` instead.
     *
     *     Updates the display name, logical id, or branch of an app. `logicalId` cannot be combined with `branchId` or `branchGitName` in one request; move the app first, then set its `logicalId`.
     */
    patch: operations["patchV1AppsByAppId"];
    trace?: never;
  };
  "/v1/apps/{appId}/promote": {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    get?: never;
    put?: never;
    /**
     * Promote deployment
     * @deprecated
     * @description ⚠️ Experimental endpoint: this API is in active development and may change at any time without notice. ⚠️
     *
     *     Deprecated: use `POST /v1/services/{serviceId}/promote` instead.
     *
     *     Promotes a deployment to be the active deployment behind the app's stable endpoint. The deployment must be running. Returns the app endpoint domain.
     */
    post: operations["postV1AppsByAppIdPromote"];
    delete?: never;
    options?: never;
    head?: never;
    patch?: never;
    trace?: never;
  };
  "/v1/apps/{appId}/rollback": {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    get?: never;
    put?: never;
    /**
     * Roll an app back to an existing deployment
     * @deprecated
     * @description ⚠️ Experimental endpoint: this API is in active development and may change at any time without notice. ⚠️
     *
     *     Deprecated: use `POST /v1/services/{serviceId}/rollback` instead.
     *
     *     Makes any eligible existing deployment live behind the app's stable endpoint (rollback or roll-forward). Unlike promote, a stopped target is started and waited until it is running before the endpoint is switched, so the currently-live deployment keeps serving with zero downtime. Returns the app endpoint domain.
     */
    post: operations["postV1AppsByAppIdRollback"];
    delete?: never;
    options?: never;
    head?: never;
    patch?: never;
    trace?: never;
  };
  "/v1/apps/{appId}/domains": {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    /**
     * List custom domains for an app
     * @deprecated
     * @description ⚠️ Experimental endpoint: this API is in active development and may change at any time without notice. ⚠️
     *
     *     Deprecated: use `GET /v1/services/{serviceId}/domains` instead.
     *
     *     Returns all custom domains attached to any deployment of the app. Domains are aggregated across all deployments since Foundry lists per deployment.
     */
    get: operations["getV1AppsByAppIdDomains"];
    put?: never;
    /**
     * Create a custom domain
     * @deprecated
     * @description ⚠️ Experimental endpoint: this API is in active development and may change at any time without notice. ⚠️
     *
     *     Deprecated: use `POST /v1/services/{serviceId}/domains` instead.
     *
     *     Registers a custom hostname for the app. The hostname must CNAME to the regional switchboard target before DNS verification can succeed. Returns 429 if the app has reached its domain quota (default: 3).
     */
    post: operations["postV1AppsByAppIdDomains"];
    delete?: never;
    options?: never;
    head?: never;
    patch?: never;
    trace?: never;
  };
  "/v1/apps/{appId}/deployments": {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    /**
     * List deployments
     * @deprecated
     * @description ⚠️ Experimental endpoint: this API is in active development and may change at any time without notice. ⚠️
     *
     *     Deprecated: use `GET /v1/services/{serviceId}/deployments` instead.
     *
     *     Returns all deployments belonging to an app, ordered by creation time (newest first). Supports cursor-based pagination.
     */
    get: operations["getV1AppsByAppIdDeployments"];
    put?: never;
    /**
     * Create deployment
     * @deprecated
     * @description ⚠️ Experimental endpoint: this API is in active development and may change at any time without notice. ⚠️
     *
     *     Deprecated: use `POST /v1/services/{serviceId}/deployments` instead.
     *
     *     Creates a new deployment under the specified app. Returns a pre-signed upload URL for the artifact unless `skipCodeUpload` is set (which forks the active promoted deployment's artifact). Environment variables are resolved automatically from the app's attached Branch (production-class templates for the production Branch; preview-class templates for preview Branches). Manage env vars via the `/v1/environment-variables` endpoints, not as part of the deploy payload.
     */
    post: operations["postV1AppsByAppIdDeployments"];
    delete?: never;
    options?: never;
    head?: never;
    patch?: never;
    trace?: never;
  };
  "/v1/services": {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    /**
     * List services
     * @description ⚠️ Experimental endpoint: this API is in active development and may change at any time without notice. ⚠️
     *
     *     Returns all services the token has access to, ordered by creation time (oldest first). Optionally filter by project ID. Supports cursor-based pagination.
     */
    get: operations["getV1Services"];
    put?: never;
    /**
     * Create service
     * @description ⚠️ Experimental endpoint: this API is in active development and may change at any time without notice. ⚠️
     *
     *     Creates a new service under the specified project. The `projectId` is required in the request body. The service is placed in the given region, or the project's default region if omitted (falling back to us-east-1). Returns `409 Conflict` when a service already occupies the slot on the resolved branch, either by name or by `logicalId`; the body includes the existing service's id, name, branch, and logical id, and `conflict` says which attribute clashed. The name is checked first. `logicalId` cannot be combined with `branchGitName`; pass `branchId` instead.
     */
    post: operations["postV1Services"];
    delete?: never;
    options?: never;
    head?: never;
    patch?: never;
    trace?: never;
  };
  "/v1/services/{serviceId}": {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    /**
     * Get service
     * @description ⚠️ Experimental endpoint: this API is in active development and may change at any time without notice. ⚠️
     *
     *     Returns a service by ID, including its region and active promoted deployment reference.
     */
    get: operations["getV1ServicesByServiceId"];
    put?: never;
    post?: never;
    /**
     * Delete service
     * @description ⚠️ Experimental endpoint: this API is in active development and may change at any time without notice. ⚠️
     *
     *     Deletes a service. Deployments under the service are deleted before the service is deleted.
     */
    delete: operations["deleteV1ServicesByServiceId"];
    options?: never;
    head?: never;
    /**
     * Update service
     * @description ⚠️ Experimental endpoint: this API is in active development and may change at any time without notice. ⚠️
     *
     *     Updates the display name, logical id, or branch of a service. `logicalId` cannot be combined with `branchId` or `branchGitName` in one request; move the service first, then set its `logicalId`.
     */
    patch: operations["patchV1ServicesByServiceId"];
    trace?: never;
  };
  "/v1/services/{serviceId}/promote": {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    get?: never;
    put?: never;
    /**
     * Promote deployment
     * @description ⚠️ Experimental endpoint: this API is in active development and may change at any time without notice. ⚠️
     *
     *     Promotes a deployment to be the active deployment behind the service's stable endpoint. The deployment must be running. Returns the service endpoint domain.
     */
    post: operations["postV1ServicesByServiceIdPromote"];
    delete?: never;
    options?: never;
    head?: never;
    patch?: never;
    trace?: never;
  };
  "/v1/services/{serviceId}/rollback": {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    get?: never;
    put?: never;
    /**
     * Roll a service back to an existing deployment
     * @description ⚠️ Experimental endpoint: this API is in active development and may change at any time without notice. ⚠️
     *
     *     Makes any eligible existing deployment live behind the service's stable endpoint (rollback or roll-forward). Unlike promote, a stopped target is started and waited until it is running before the endpoint is switched, so the currently-live deployment keeps serving with zero downtime. Returns the service endpoint domain.
     */
    post: operations["postV1ServicesByServiceIdRollback"];
    delete?: never;
    options?: never;
    head?: never;
    patch?: never;
    trace?: never;
  };
  "/v1/services/{serviceId}/domains": {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    /**
     * List custom domains for a service
     * @description ⚠️ Experimental endpoint: this API is in active development and may change at any time without notice. ⚠️
     *
     *     Returns all custom domains attached to any deployment of the service. Domains are aggregated across all deployments since Foundry lists per deployment.
     */
    get: operations["getV1ServicesByServiceIdDomains"];
    put?: never;
    /**
     * Create a custom domain
     * @description ⚠️ Experimental endpoint: this API is in active development and may change at any time without notice. ⚠️
     *
     *     Registers a custom hostname for the service. The hostname must CNAME to the regional switchboard target before DNS verification can succeed. Returns 429 if the service has reached its domain quota (default: 3).
     */
    post: operations["postV1ServicesByServiceIdDomains"];
    delete?: never;
    options?: never;
    head?: never;
    patch?: never;
    trace?: never;
  };
  "/v1/services/{serviceId}/deployments": {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    /**
     * List deployments
     * @description ⚠️ Experimental endpoint: this API is in active development and may change at any time without notice. ⚠️
     *
     *     Returns all deployments belonging to a service, ordered by creation time (newest first). Supports cursor-based pagination.
     */
    get: operations["getV1ServicesByServiceIdDeployments"];
    put?: never;
    /**
     * Create deployment
     * @description ⚠️ Experimental endpoint: this API is in active development and may change at any time without notice. ⚠️
     *
     *     Creates a new deployment under the specified service. Returns a pre-signed upload URL for the artifact unless `skipCodeUpload` is set (which forks the active promoted deployment's artifact). Environment variables are resolved automatically from the service's attached Branch (production-class templates for the production Branch; preview-class templates for preview Branches). Manage env vars via the `/v1/environment-variables` endpoints, not as part of the deploy payload.
     */
    post: operations["postV1ServicesByServiceIdDeployments"];
    delete?: never;
    options?: never;
    head?: never;
    patch?: never;
    trace?: never;
  };
  "/v1/projects/{projectId}/branches": {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    /**
     * List branches in a project
     * @description ⚠️ Experimental endpoint: this API is in active development and may change at any time without notice. ⚠️
     *
     *     Returns the live Branches of a Project. Supports two mutually exclusive filters: ?gitName= (exact match — at most one row), ?gitNameContains= (case-sensitive substring). Soft-deleted Branches are not returned. Ordered by createdAt ascending.
     */
    get: operations["getV1ProjectsByProjectIdBranches"];
    put?: never;
    /**
     * Create a branch
     * @description ⚠️ Experimental endpoint: this API is in active development and may change at any time without notice. ⚠️
     *
     *     Creates a Branch under the specified Project. The first Branch in a Project is always created with isDefault=true and role=production regardless of the body value. Later Branches are created with role=preview. Setting isDefault=true while another Branch already holds the default atomically swaps the default flag only.
     */
    post: operations["postV1ProjectsByProjectIdBranches"];
    delete?: never;
    options?: never;
    head?: never;
    patch?: never;
    trace?: never;
  };
  "/v1/branches/{branchId}": {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    /**
     * Get a branch
     * @description ⚠️ Experimental endpoint: this API is in active development and may change at any time without notice. ⚠️
     *
     *     Returns a single Branch by ID. Member resources are not inlined — list them via /v1/databases?branchId= and /v1/apps?branchId=.
     */
    get: operations["getV1BranchesByBranchId"];
    put?: never;
    post?: never;
    /**
     * Soft-delete a branch
     * @description ⚠️ Experimental endpoint: this API is in active development and may change at any time without notice. ⚠️
     *
     *     Soft-deletes a Branch (sets deletedAt). Refuses if the Branch is the Project's current default, the Project's production Branch, or has live members.
     */
    delete: operations["deleteV1BranchesByBranchId"];
    options?: never;
    head?: never;
    /**
     * Update a branch
     * @description ⚠️ Experimental endpoint: this API is in active development and may change at any time without notice. ⚠️
     *
     *     Promotes a Branch to be the Project's default. Only isDefault is mutable — gitName rename and role changes are rejected.
     */
    patch: operations["patchV1BranchesByBranchId"];
    trace?: never;
  };
  "/v1/buckets": {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    /**
     * List buckets
     * @description Returns all object-store buckets the token has access to. Optionally filter by project ID.
     */
    get: operations["getV1Buckets"];
    put?: never;
    /**
     * Create bucket
     * @description Creates a new object-store bucket in the specified project.
     */
    post: operations["postV1Buckets"];
    delete?: never;
    options?: never;
    head?: never;
    patch?: never;
    trace?: never;
  };
  "/v1/buckets/{bucketId}": {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    /**
     * Get bucket
     * @description Returns the bucket with the given ID.
     */
    get: operations["getV1BucketsByBucketId"];
    put?: never;
    post?: never;
    /**
     * Delete bucket
     * @description Permanently deletes the bucket with the given ID, all objects stored in it, and all its access keys. This action cannot be undone.
     */
    delete: operations["deleteV1BucketsByBucketId"];
    options?: never;
    head?: never;
    /**
     * Update bucket
     * @description Updates the display name, logical id, or branch of the bucket with the given ID. The display name is a label only: the provider bucket name, the objects, and the access keys do not change. `logicalId` cannot be combined with `branchId` or `branchGitName` in one request; move the bucket first, then set its `logicalId`.
     */
    patch: operations["patchV1BucketsByBucketId"];
    trace?: never;
  };
  "/v1/buckets/{bucketId}/keys": {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    /**
     * List bucket keys
     * @description Returns all access keys for the given bucket.
     */
    get: operations["getV1BucketsByBucketIdKeys"];
    put?: never;
    /**
     * Create bucket key
     * @description Creates a new access key for the given bucket. The `secretAccessKey` field is returned exactly once in this response and is never stored — copy it immediately.
     */
    post: operations["postV1BucketsByBucketIdKeys"];
    delete?: never;
    options?: never;
    head?: never;
    patch?: never;
    trace?: never;
  };
  "/v1/buckets/{bucketId}/keys/{keyId}": {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    get?: never;
    put?: never;
    post?: never;
    /**
     * Delete bucket key
     * @description Revokes and deletes the bucket key with the given ID.
     */
    delete: operations["deleteV1BucketsByBucketIdKeysByKeyId"];
    options?: never;
    head?: never;
    patch?: never;
    trace?: never;
  };
  "/v1/builds": {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    /**
     * List builds
     * @description ⚠️ Experimental endpoint: this API is in active development and may change at any time without notice. ⚠️
     *
     *     Lists the builds of the caller's workspace, newest first, filtered by project, branch, or state. `cursor` is opaque: pass back the `nextCursor` the previous page returned.
     */
    get: operations["getV1Builds"];
    put?: never;
    /**
     * Report a build
     * @description ⚠️ Experimental endpoint: this API is in active development and may change at any time without notice. ⚠️
     *
     *     Records a build any deploy tool is running — a CI workflow, a deploy script, or Composer from a laptop. The workspace comes from the token, never from the body, which is what lets a build be reported before the project it will create exists. Supplying `runIdentity` makes the call idempotent: a repeat for the same run returns the build already recorded rather than a second one. The response is the same either way; a caller cannot tell whether it created the build or joined one.
     *
     *     A build reported with no `runIdentity` has no dedup key, so a client that retries a lost response creates a second build. Supply a `runIdentity` whenever the run has one.
     */
    post: operations["postV1Builds"];
    delete?: never;
    options?: never;
    head?: never;
    patch?: never;
    trace?: never;
  };
  "/v1/builds/{buildId}": {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    /**
     * Get a build
     * @description ⚠️ Experimental endpoint: this API is in active development and may change at any time without notice. ⚠️
     *
     *     Returns one build with the resources it reported acting on.
     */
    get: operations["getV1BuildsByBuildId"];
    put?: never;
    post?: never;
    delete?: never;
    options?: never;
    head?: never;
    /**
     * Update a build
     * @description ⚠️ Experimental endpoint: this API is in active development and may change at any time without notice. ⚠️
     *
     *     Records progress on a build. Any holder of the workspace token may patch any field — the webhook, the CI run and Composer each report the part of a deploy they can see, and the token is the boundary. Reaching `running` stamps `startedAt` and reaching a terminal state stamps `finishedAt`, both only if unset, so re-reporting the same state does not move the clock. Once a build has finished, its state no longer changes: a later report updates the other fields and leaves the state as the finishing report set it.
     *
     *     `projectId`, `branchId`, `deployedUrl` and `applicationTopologyContentHash` can each be set once and never changed: a reporter that resolves them partway through a deploy sets them here, but a value already recorded cannot be changed and the attempt is a conflict. Sending the value already recorded is accepted and changes nothing. `projectId` and `branchId` must belong to the caller's workspace, and a branch must belong to the build's project, so a branch from another project is refused.
     */
    patch: operations["patchV1BuildsByBuildId"];
    trace?: never;
  };
  "/v1/builds/{buildId}/resources/{resourceType}/{resourceId}": {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    get?: never;
    /**
     * Report a resource a build acted on
     * @description ⚠️ Experimental endpoint: this API is in active development and may change at any time without notice. ⚠️
     *
     *     Records that the build created, acted on, or deleted a platform resource — the provenance a deploy run leaves behind. Idempotent: re-reporting the same resource updates the row rather than adding one, and never weakens the recorded action. The resource must belong to the caller's workspace, and must still be findable: a soft-deleted resource can be reported, but `project`, `database`, `service_key` and `config_variable` leave no row behind, so a build that deletes one must report it before deleting it. Reporting a deployment as `created` also attaches the deployment to the build and records the app it deployed into, both in the same transaction, because a deployment relates its build to that app whether or not the reporter says so.
     */
    put: operations["putV1BuildsByBuildIdResourcesByResourceTypeByResourceId"];
    post?: never;
    delete?: never;
    options?: never;
    head?: never;
    patch?: never;
    trace?: never;
  };
  "/v1/builds/{buildId}/logs": {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    /**
     * Stream build logs
     * @description ⚠️ Experimental endpoint: this API is in active development and may change at any time without notice. ⚠️
     *
     *     Streams the full build log for a build as newline-delimited JSON (`application/x-ndjson`). Each line is a JSON object discriminated by `type`: `log` (a build output line) or `terminal` (end-of-stream marker with a `cursor` for resumption). The default is a finite dump that ends once the stream is drained; pass `follow=true` to keep the connection open for an in-flight build, and `cursor` to resume from a prior terminal cursor.
     */
    get: operations["getV1BuildsByBuildIdLogs"];
    put?: never;
    post?: never;
    delete?: never;
    options?: never;
    head?: never;
    patch?: never;
    trace?: never;
  };
  "/v1/domains/{domainId}": {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    /**
     * Get a custom domain
     * @description ⚠️ Experimental endpoint: this API is in active development and may change at any time without notice. ⚠️
     *
     *     Returns details for a custom domain by id. Authorization is derived from the parent compute service's workspace.
     */
    get: operations["getV1DomainsByDomainId"];
    put?: never;
    post?: never;
    /**
     * Delete a custom domain
     * @description ⚠️ Experimental endpoint: this API is in active development and may change at any time without notice. ⚠️
     *
     *     Removes a custom domain binding. Authorization is derived from the parent compute service's workspace.
     */
    delete: operations["deleteV1DomainsByDomainId"];
    options?: never;
    head?: never;
    patch?: never;
    trace?: never;
  };
  "/v1/domains/{domainId}/retry": {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    get?: never;
    put?: never;
    /**
     * Retry custom domain provisioning
     * @description ⚠️ Experimental endpoint: this API is in active development and may change at any time without notice. ⚠️
     *
     *     Retries DNS verification and certificate issuance for a failed or pending domain. Returns 409 if the domain is not yet eligible for retry (e.g. still provisioning).
     */
    post: operations["postV1DomainsByDomainIdRetry"];
    delete?: never;
    options?: never;
    head?: never;
    patch?: never;
    trace?: never;
  };
  "/v1/connections": {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    /**
     * List connections
     * @description Returns all connections the actor has access to, with optional database filter.
     */
    get: operations["getV1Connections"];
    put?: never;
    /**
     * Create connection
     * @description Creates a new connection for the specified database.
     */
    post: operations["postV1Connections"];
    delete?: never;
    options?: never;
    head?: never;
    patch?: never;
    trace?: never;
  };
  "/v1/connections/{id}": {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    /**
     * Get connection
     * @description Returns the connection with the given ID.
     */
    get: operations["getV1ConnectionsById"];
    put?: never;
    post?: never;
    /**
     * Delete connection
     * @description Deletes the connection with the given ID.
     */
    delete: operations["deleteV1ConnectionsById"];
    options?: never;
    head?: never;
    patch?: never;
    trace?: never;
  };
  "/v1/connections/{id}/rotate": {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    get?: never;
    put?: never;
    /**
     * Rotate connection credentials
     * @description Generates new credentials for the connection with the given ID. Revocation of the previous credentials is best-effort.
     */
    post: operations["postV1ConnectionsByIdRotate"];
    delete?: never;
    options?: never;
    head?: never;
    patch?: never;
    trace?: never;
  };
  "/v1/databases": {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    /**
     * List databases
     * @description Returns all databases the token has access to. Optionally filter by project ID.
     */
    get: operations["getV1Databases"];
    put?: never;
    /**
     * Create database
     * @description Creates a new database in the specified project. `logicalId` cannot be combined with `branchGitName`; pass `branchId` instead.
     */
    post: operations["postV1Databases"];
    delete?: never;
    options?: never;
    head?: never;
    patch?: never;
    trace?: never;
  };
  "/v1/databases/{databaseId}": {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    /**
     * Get database
     * @description Returns the database with the given ID.
     */
    get: operations["getV1DatabasesByDatabaseId"];
    put?: never;
    post?: never;
    /**
     * Delete database
     * @description Deletes the database with the given ID.
     */
    delete: operations["deleteV1DatabasesByDatabaseId"];
    options?: never;
    head?: never;
    /**
     * Update database
     * @description Updates the database with the given ID. `logicalId` cannot be combined with `branchId` or `branchGitName` in one request; move the database first, then set its `logicalId`.
     */
    patch: operations["patchV1DatabasesByDatabaseId"];
    trace?: never;
  };
  "/v1/databases/{databaseId}/connections": {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    /**
     * Get list of database connections
     * @description Returns all connections for the given database.
     */
    get: operations["getV1DatabasesByDatabaseIdConnections"];
    put?: never;
    /**
     * Create database connection string
     * @description Creates a new connection string for the given database.
     */
    post: operations["postV1DatabasesByDatabaseIdConnections"];
    delete?: never;
    options?: never;
    head?: never;
    patch?: never;
    trace?: never;
  };
  "/v1/databases/{databaseId}/backups": {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    /**
     * Get list of backups
     * @description Returns backups for the specified database.
     */
    get: operations["getV1DatabasesByDatabaseIdBackups"];
    put?: never;
    post?: never;
    delete?: never;
    options?: never;
    head?: never;
    patch?: never;
    trace?: never;
  };
  "/v1/databases/{targetDatabaseId}/restore": {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    get?: never;
    put?: never;
    /**
     * Restore database (destructive)
     * @description ⚠️ **Destructive operation** — this immediately and irreversibly overwrites all data in the target database with the contents of the specified backup. Any data written since the backup was taken will be lost. Ensure you have a recent backup of the target database before proceeding.
     *
     *     Replaces the data in an existing database from a backup. Connections and credentials are preserved — only the data layer is replaced.
     */
    post: operations["postV1DatabasesByTargetDatabaseIdRestore"];
    delete?: never;
    options?: never;
    head?: never;
    patch?: never;
    trace?: never;
  };
  "/v1/databases/{databaseId}/usage": {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    /**
     * Get database usage metrics
     * @description Returns usage metrics for the specified database.
     */
    get: operations["getV1DatabasesByDatabaseIdUsage"];
    put?: never;
    post?: never;
    delete?: never;
    options?: never;
    head?: never;
    patch?: never;
    trace?: never;
  };
  "/v1/deployments/{deploymentId}": {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    /**
     * Get deployment
     * @description ⚠️ Experimental endpoint: this API is in active development and may change at any time without notice. ⚠️
     *
     *     Returns a deployment by ID, including its current status derived from the underlying VM state.
     */
    get: operations["getV1DeploymentsByDeploymentId"];
    put?: never;
    post?: never;
    /**
     * Delete deployment
     * @description ⚠️ Experimental endpoint: this API is in active development and may change at any time without notice. ⚠️
     *
     *     Permanently deletes the deployment, its metadata, and any associated VM. The deployment must be stopped or in the `new` state before it can be deleted.
     */
    delete: operations["deleteV1DeploymentsByDeploymentId"];
    options?: never;
    head?: never;
    patch?: never;
    trace?: never;
  };
  "/v1/deployments/{deploymentId}/start": {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    get?: never;
    put?: never;
    /**
     * Start deployment
     * @description ⚠️ Experimental endpoint: this API is in active development and may change at any time without notice. ⚠️
     *
     *     Requests VM creation and startup for the deployment. The artifact must be uploaded before calling this endpoint. Returns a preview domain that becomes reachable once the VM is running. Poll the status endpoint until `running` is reached.
     */
    post: operations["postV1DeploymentsByDeploymentIdStart"];
    delete?: never;
    options?: never;
    head?: never;
    patch?: never;
    trace?: never;
  };
  "/v1/deployments/{deploymentId}/stop": {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    get?: never;
    put?: never;
    /**
     * Stop deployment
     * @description ⚠️ Experimental endpoint: this API is in active development and may change at any time without notice. ⚠️
     *
     *     Requests VM shutdown for the deployment. The deployment record and metadata are retained. Poll the status endpoint until `stopped` is reached.
     */
    post: operations["postV1DeploymentsByDeploymentIdStop"];
    delete?: never;
    options?: never;
    head?: never;
    patch?: never;
    trace?: never;
  };
  "/v1/deployments/{deploymentId}/logs": {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    /**
     * Get deployment logs
     * @description ⚠️ Experimental endpoint: this API is in active development and may change at any time without notice. ⚠️
     *
     *     Returns log output for the specified deployment. Each record is a JSON object with `type: "log"` (log text + byte metadata) or `type: "terminal"` (end-of-page signal with a resume cursor). A plain GET responds with newline-delimited JSON (`application/x-ndjson`): it drains the requested window (`tail`, `from_start`, or `cursor`), ends with a terminal record carrying the cursor for the next page, and closes. Send an `Upgrade: websocket` header to follow the log live instead; a live segment ends after 10 minutes with the same terminal/cursor mechanism.
     */
    get: operations["getV1DeploymentsByDeploymentIdLogs"];
    put?: never;
    post?: never;
    delete?: never;
    options?: never;
    head?: never;
    patch?: never;
    trace?: never;
  };
  "/v1/projects": {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    /**
     * Get list of projects
     * @description Returns the list of projects the token has access to.
     */
    get: operations["getV1Projects"];
    put?: never;
    /**
     * Create project with a postgres database
     * @description Creates a new project with a postgres database.
     */
    post: operations["postV1Projects"];
    delete?: never;
    options?: never;
    head?: never;
    patch?: never;
    trace?: never;
  };
  "/v1/projects/{id}": {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    /**
     * Get project
     * @description Returns the project with the given ID.
     */
    get: operations["getV1ProjectsById"];
    put?: never;
    post?: never;
    /**
     * Delete project
     * @description Deletes the project with the given ID.
     */
    delete: operations["deleteV1ProjectsById"];
    options?: never;
    head?: never;
    /**
     * Update project
     * @description Updates the project with the given ID.
     */
    patch: operations["patchV1ProjectsById"];
    trace?: never;
  };
  "/v1/projects/{id}/transfer": {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    get?: never;
    put?: never;
    /**
     * Transfer project
     * @description Transfer the project with the given ID to the new owner's workspace
     */
    post: operations["postV1ProjectsByIdTransfer"];
    delete?: never;
    options?: never;
    head?: never;
    patch?: never;
    trace?: never;
  };
  "/v1/projects/{projectId}/branches/{branchId}/alchemy-state/lease": {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    get?: never;
    put?: never;
    /**
     * Acquire Alchemy deploy lease
     * @description ⚠️ Experimental endpoint: this API is in active development and may change at any time without notice. ⚠️
     *
     *     Acquires the deploy lease for a (branch, stack, stage). An expired lease is replaced atomically; a live lease fails fast with 409 naming the current holder — there is no queueing. Every Alchemy state operation requires a live deploy lease.
     */
    post: operations["postV1ProjectsByProjectIdBranchesByBranchIdAlchemy-stateLease"];
    /**
     * Release Alchemy deploy lease
     * @description ⚠️ Experimental endpoint: this API is in active development and may change at any time without notice. ⚠️
     *
     *     Releases the deploy lease addressed by the Alchemy-State-Lease-Id header on clean deploy exit. A missing, replaced, or expired lease returns 404 — a lost lease at release time is surfaced, not idempotently swallowed.
     */
    delete: operations["deleteV1ProjectsByProjectIdBranchesByBranchIdAlchemy-stateLease"];
    options?: never;
    head?: never;
    /**
     * Heartbeat Alchemy deploy lease
     * @description ⚠️ Experimental endpoint: this API is in active development and may change at any time without notice. ⚠️
     *
     *     Extends the unexpired deploy lease addressed by the Alchemy-State-Lease-Id header from now. A missing, replaced, or expired lease returns 404 — the lost-lease signal; an expired lease can never be revived.
     */
    patch: operations["patchV1ProjectsByProjectIdBranchesByBranchIdAlchemy-stateLease"];
    trace?: never;
  };
  "/v1/projects/{projectId}/branches/{branchId}/alchemy-state/version": {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    /**
     * Alchemy state store version
     * @description ⚠️ Experimental endpoint: this API is in active development and may change at any time without notice. ⚠️
     *
     *     Unauthenticated contract-version probe served verbatim from the pinned alchemy HttpStateApi contract. Returns the constant only and never inspects the addressed project or branch.
     */
    get: operations["getV1ProjectsByProjectIdBranchesByBranchIdAlchemy-stateVersion"];
    put?: never;
    post?: never;
    delete?: never;
    options?: never;
    head?: never;
    patch?: never;
    trace?: never;
  };
  "/v1/projects/{projectId}/branches/{branchId}/alchemy-state/state/stacks": {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    /**
     * List Alchemy stacks
     * @description ⚠️ Experimental endpoint: this API is in active development and may change at any time without notice. ⚠️
     *
     *     Lists the distinct stack names with state or output rows on the branch. Requires no deploy lease: the stock client's auth probe (checkHttpStateStoreAuth) calls this endpoint bare, and it exposes stack names only.
     */
    get: operations["getV1ProjectsByProjectIdBranchesByBranchIdAlchemy-stateStateStacks"];
    put?: never;
    post?: never;
    delete?: never;
    options?: never;
    head?: never;
    patch?: never;
    trace?: never;
  };
  "/v1/projects/{projectId}/branches/{branchId}/alchemy-state/state/stacks/{stack}/stages": {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    /**
     * List Alchemy stages
     * @description ⚠️ Experimental endpoint: this API is in active development and may change at any time without notice. ⚠️
     *
     *     Lists the distinct stage names with state or output rows for the stack. Accepts a live deploy lease on any stage of the stack.
     */
    get: operations["getV1ProjectsByProjectIdBranchesByBranchIdAlchemy-stateStateStacksByStackStages"];
    put?: never;
    post?: never;
    delete?: never;
    options?: never;
    head?: never;
    patch?: never;
    trace?: never;
  };
  "/v1/projects/{projectId}/branches/{branchId}/alchemy-state/state/stacks/{stack}/stages/{stage}/resources": {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    /**
     * List Alchemy resources
     * @description ⚠️ Experimental endpoint: this API is in active development and may change at any time without notice. ⚠️
     *
     *     Lists the resource FQNs stored for the stage, ordered by FQN.
     */
    get: operations["getV1ProjectsByProjectIdBranchesByBranchIdAlchemy-stateStateStacksByStackStagesByStageResources"];
    put?: never;
    post?: never;
    delete?: never;
    options?: never;
    head?: never;
    patch?: never;
    trace?: never;
  };
  "/v1/projects/{projectId}/branches/{branchId}/alchemy-state/state/stacks/{stack}/stages/{stage}/resources/{fqn}": {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    /**
     * Get Alchemy resource state
     * @description ⚠️ Experimental endpoint: this API is in active development and may change at any time without notice. ⚠️
     *
     *     Returns the stored resource state, or a JSON null body when absent (the stock client maps null to undefined).
     */
    get: operations["getV1ProjectsByProjectIdBranchesByBranchIdAlchemy-stateStateStacksByStackStagesByStageResourcesByFqn"];
    /**
     * Set Alchemy resource state
     * @description ⚠️ Experimental endpoint: this API is in active development and may change at any time without notice. ⚠️
     *
     *     Stores the resource state encrypted at rest and echoes the stored value.
     */
    put: operations["putV1ProjectsByProjectIdBranchesByBranchIdAlchemy-stateStateStacksByStackStagesByStageResourcesByFqn"];
    post?: never;
    /**
     * Delete Alchemy resource state
     * @description ⚠️ Experimental endpoint: this API is in active development and may change at any time without notice. ⚠️
     *
     *     Deletes the resource state row. Idempotent: deleting an absent row also returns 204.
     */
    delete: operations["deleteV1ProjectsByProjectIdBranchesByBranchIdAlchemy-stateStateStacksByStackStagesByStageResourcesByFqn"];
    options?: never;
    head?: never;
    patch?: never;
    trace?: never;
  };
  "/v1/projects/{projectId}/branches/{branchId}/alchemy-state/state/stacks/{stack}/stages/{stage}/replaced-resources": {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    /**
     * List replaced Alchemy resources
     * @description ⚠️ Experimental endpoint: this API is in active development and may change at any time without notice. ⚠️
     *
     *     Returns the decrypted resource states of the stage whose status is "replaced".
     */
    get: operations["getV1ProjectsByProjectIdBranchesByBranchIdAlchemy-stateStateStacksByStackStagesByStageReplaced-resources"];
    put?: never;
    post?: never;
    delete?: never;
    options?: never;
    head?: never;
    patch?: never;
    trace?: never;
  };
  "/v1/projects/{projectId}/branches/{branchId}/alchemy-state/state/stacks/{stack}/stages/{stage}/output": {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    /**
     * Get Alchemy stack output
     * @description ⚠️ Experimental endpoint: this API is in active development and may change at any time without notice. ⚠️
     *
     *     Returns the stored stack output for the stage, or a JSON null body when absent (the stock client maps null to undefined).
     */
    get: operations["getV1ProjectsByProjectIdBranchesByBranchIdAlchemy-stateStateStacksByStackStagesByStageOutput"];
    /**
     * Set Alchemy stack output
     * @description ⚠️ Experimental endpoint: this API is in active development and may change at any time without notice. ⚠️
     *
     *     Overwrites the stack output for the stage, encrypted at rest, and echoes the stored value.
     */
    put: operations["putV1ProjectsByProjectIdBranchesByBranchIdAlchemy-stateStateStacksByStackStagesByStageOutput"];
    post?: never;
    delete?: never;
    options?: never;
    head?: never;
    patch?: never;
    trace?: never;
  };
  "/v1/projects/{projectId}/branches/{branchId}/alchemy-state/state/stacks/{stack}": {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    get?: never;
    put?: never;
    post?: never;
    /**
     * Delete Alchemy stack state
     * @description ⚠️ Experimental endpoint: this API is in active development and may change at any time without notice. ⚠️
     *
     *     Deletes every resource-state and output row of the stack, or only the given stage's rows when the stage query parameter is set. Requires a live deploy lease on the affected stage; without a stage it additionally requires that no other stage of the stack holds a live lease, so one stage's deploy can never delete state another stage's deploy is using. Idempotent.
     */
    delete: operations["deleteV1ProjectsByProjectIdBranchesByBranchIdAlchemy-stateStateStacksByStack"];
    options?: never;
    head?: never;
    patch?: never;
    trace?: never;
  };
  "/v1/projects/{projectId}/branches/{branchId}/application-topology": {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    /**
     * Get branch topology
     * @description ⚠️ Experimental endpoint: this API is in active development and may change at any time without notice. ⚠️
     *
     *     Returns the stored topology graph for the branch — the same shape Composer submitted. Nodes, ports, and edges are returned in deterministic order.
     */
    get: operations["getV1ProjectsByProjectIdBranchesByBranchIdApplication-topology"];
    /**
     * Replace branch topology
     * @description ⚠️ Experimental endpoint: this API is in active development and may change at any time without notice. ⚠️
     *
     *     Atomically replaces the entire topology for a branch. Composer calls this after Load, before the apply. On error, Composer warns and continues — the previous topology is preserved.
     */
    put: operations["putV1ProjectsByProjectIdBranchesByBranchIdApplication-topology"];
    post?: never;
    delete?: never;
    options?: never;
    head?: never;
    patch?: never;
    trace?: never;
  };
  "/v1/projects/{projectId}/databases": {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    /**
     * Get list of databases
     * @description Returns databases for the given project.
     */
    get: operations["getV1ProjectsByProjectIdDatabases"];
    put?: never;
    /**
     * Create database
     * @description Creates a new database for the given project.
     */
    post: operations["postV1ProjectsByProjectIdDatabases"];
    delete?: never;
    options?: never;
    head?: never;
    patch?: never;
    trace?: never;
  };
  "/v1/environment-variables": {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    /**
     * List environment variables
     * @description ⚠️ Experimental endpoint: this API is in active development and may change at any time without notice. ⚠️
     *
     *     Returns a paginated list of environment variables. All filters are optional; combine `projectId`, `class`, and `key` to look up a specific variable by name.
     */
    get: operations["getV1Environment-variables"];
    put?: never;
    /**
     * Create an environment variable
     * @description ⚠️ Experimental endpoint: this API is in active development and may change at any time without notice. ⚠️
     *
     *     Creates a new environment variable in a project's `production` or `preview` environment, or a preview branch override when `branchId` is supplied. Returns 409 if a variable with the same key already exists in that scope — use PATCH to replace its value. Values are stored encrypted and are not returned by subsequent reads.
     */
    post: operations["postV1Environment-variables"];
    delete?: never;
    options?: never;
    head?: never;
    patch?: never;
    trace?: never;
  };
  "/v1/environment-variables/{envVarId}": {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    /**
     * Get an environment variable
     * @description ⚠️ Experimental endpoint: this API is in active development and may change at any time without notice. ⚠️
     *
     *     Returns a single environment variable's metadata. The value is not returned.
     */
    get: operations["getV1Environment-variablesByEnvVarId"];
    put?: never;
    post?: never;
    /**
     * Delete an environment variable
     * @description ⚠️ Experimental endpoint: this API is in active development and may change at any time without notice. ⚠️
     *
     *     Removes an environment variable. A second delete of the same variable returns 404.
     */
    delete: operations["deleteV1Environment-variablesByEnvVarId"];
    options?: never;
    head?: never;
    /**
     * Update an environment variable's value
     * @description ⚠️ Experimental endpoint: this API is in active development and may change at any time without notice. ⚠️
     *
     *     Replaces the value of an existing environment variable. Only the value is mutable — the project, environment, key, and branch are fixed at create-time.
     */
    patch: operations["patchV1Environment-variablesByEnvVarId"];
    trace?: never;
  };
  "/v1/integrations": {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    /**
     * Get list of integrations
     * @description Returns integrations filtered by workspace ID.
     */
    get: operations["getV1Integrations"];
    put?: never;
    post?: never;
    delete?: never;
    options?: never;
    head?: never;
    patch?: never;
    trace?: never;
  };
  "/v1/integrations/{id}": {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    /**
     * Get integration by ID
     * @description Returns a single integration by its ID.
     */
    get: operations["getV1IntegrationsById"];
    put?: never;
    post?: never;
    /**
     * Delete integration
     * @description Revokes the integration tokens by integration ID.
     */
    delete: operations["deleteV1IntegrationsById"];
    options?: never;
    head?: never;
    patch?: never;
    trace?: never;
  };
  "/v1/me": {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    /**
     * Get current authenticated principal
     * @description Returns the user, workspace, and credential represented by the current token.
     */
    get: operations["getV1Me"];
    put?: never;
    post?: never;
    delete?: never;
    options?: never;
    head?: never;
    patch?: never;
    trace?: never;
  };
  "/v1/workspaces/{workspaceId}/integrations": {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    /**
     * Get list of integrations
     * @description Returns integrations for the given workspace.
     */
    get: operations["getV1WorkspacesByWorkspaceIdIntegrations"];
    put?: never;
    post?: never;
    delete?: never;
    options?: never;
    head?: never;
    patch?: never;
    trace?: never;
  };
  "/v1/workspaces/{workspaceId}/integrations/{clientId}": {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    get?: never;
    put?: never;
    post?: never;
    /**
     * Revoke integration tokens
     * @description Revokes the integration tokens with the given client ID.
     */
    delete: operations["deleteV1WorkspacesByWorkspaceIdIntegrationsByClientId"];
    options?: never;
    head?: never;
    patch?: never;
    trace?: never;
  };
  "/v1/workspaces/{workspaceId}/service-tokens": {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    /**
     * List service tokens
     * @description Returns the service tokens for the given workspace, newest first.
     */
    get: operations["getV1WorkspacesByWorkspaceIdService-tokens"];
    put?: never;
    /**
     * Create service token
     * @description Creates a new service token for the given workspace. The `value` field is returned exactly once in this response and is never stored — copy it immediately.
     */
    post: operations["postV1WorkspacesByWorkspaceIdService-tokens"];
    delete?: never;
    options?: never;
    head?: never;
    patch?: never;
    trace?: never;
  };
  "/v1/workspaces/{workspaceId}/service-tokens/{serviceTokenId}": {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    get?: never;
    put?: never;
    post?: never;
    /**
     * Delete service token
     * @description Revokes the service token with the given ID by deleting it.
     */
    delete: operations["deleteV1WorkspacesByWorkspaceIdService-tokensByServiceTokenId"];
    options?: never;
    head?: never;
    patch?: never;
    trace?: never;
  };
  "/v1/auth/github-actions/token": {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    get?: never;
    put?: never;
    /**
     * Exchange a GitHub Actions OIDC token for a workspace service token
     * @description ⚠️ Experimental endpoint: this API is in active development and may change at any time without notice. ⚠️
     *
     *     Verifies the GitHub Actions OIDC token and mints a short-lived workspace service token. The caller must request the token with audience `prisma-cloud`. Any verification failure returns a generic 401 — the response never reveals whether a repository is connected.
     */
    post: operations["postV1AuthGithub-actionsToken"];
    delete?: never;
    options?: never;
    head?: never;
    patch?: never;
    trace?: never;
  };
  "/v1/regions": {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    /**
     * Get all regions
     * @description Returns all available regions across products. Optionally filter by product.
     */
    get: operations["getV1Regions"];
    put?: never;
    post?: never;
    delete?: never;
    options?: never;
    head?: never;
    patch?: never;
    trace?: never;
  };
  "/v1/regions/postgres": {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    /**
     * Get Prisma Postgres regions
     * @description Returns all available regions for Prisma Postgres.
     */
    get: operations["getV1RegionsPostgres"];
    put?: never;
    post?: never;
    delete?: never;
    options?: never;
    head?: never;
    patch?: never;
    trace?: never;
  };
  "/v1/regions/accelerate": {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    /**
     * Get Prisma Accelerate regions
     * @description Returns all available regions for Prisma Accelerate.
     */
    get: operations["getV1RegionsAccelerate"];
    put?: never;
    post?: never;
    delete?: never;
    options?: never;
    head?: never;
    patch?: never;
    trace?: never;
  };
  "/v1/scm-installations": {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    /**
     * List SCM installations for a workspace
     * @description ⚠️ Experimental endpoint: this API is in active development and may change at any time without notice. ⚠️
     *
     *     Lists active SCM installations connected to the given workspace.
     */
    get: operations["getV1Scm-installations"];
    put?: never;
    post?: never;
    delete?: never;
    options?: never;
    head?: never;
    patch?: never;
    trace?: never;
  };
  "/v1/scm-installations/install-intents": {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    get?: never;
    put?: never;
    /**
     * Create an SCM App installation intent
     * @description ⚠️ Experimental endpoint: this API is in active development and may change at any time without notice. ⚠️
     *
     *     Creates an installation intent for the given workspace. If an existing installation can be proven to belong to the caller it is linked immediately (`alreadyLinked`); otherwise the response carries a URL the user opens to install the SCM app. Pass `repository` (owner/name) so an installation that already covers it but cannot be linked automatically is detected and explained in `hint`. Currently only `github` is supported.
     */
    post: operations["postV1Scm-installationsInstall-intents"];
    delete?: never;
    options?: never;
    head?: never;
    patch?: never;
    trace?: never;
  };
  "/v1/scm-installations/{installationId}/repositories": {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    /**
     * List repositories accessible to an SCM installation
     * @description ⚠️ Experimental endpoint: this API is in active development and may change at any time without notice. ⚠️
     *
     *     Lists repositories accessible to the given SCM installation.
     */
    get: operations["getV1Scm-installationsByInstallationIdRepositories"];
    put?: never;
    post?: never;
    delete?: never;
    options?: never;
    head?: never;
    patch?: never;
    trace?: never;
  };
  "/v1/source-repositories": {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    /**
     * List source repositories
     * @description ⚠️ Experimental endpoint: this API is in active development and may change at any time without notice. ⚠️
     *
     *     Returns source repositories linked to a project. Requires projectId query parameter.
     */
    get: operations["getV1Source-repositories"];
    put?: never;
    /**
     * Link a source repository to a project
     * @description ⚠️ Experimental endpoint: this API is in active development and may change at any time without notice. ⚠️
     *
     *     Links a GitHub repository to a Prisma project via an existing SCM installation.
     */
    post: operations["postV1Source-repositories"];
    delete?: never;
    options?: never;
    head?: never;
    patch?: never;
    trace?: never;
  };
  "/v1/source-repositories/{id}": {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    /**
     * Get a source repository
     * @description ⚠️ Experimental endpoint: this API is in active development and may change at any time without notice. ⚠️
     *
     *     Returns a single source repository link by ID.
     */
    get: operations["getV1Source-repositoriesById"];
    put?: never;
    post?: never;
    /**
     * Disconnect a source repository
     * @description ⚠️ Experimental endpoint: this API is in active development and may change at any time without notice. ⚠️
     *
     *     Disconnects the source repository link. Existing branches and their attached resources are preserved.
     */
    delete: operations["deleteV1Source-repositoriesById"];
    options?: never;
    head?: never;
    patch?: never;
    trace?: never;
  };
  "/v1/workspaces": {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    /**
     * Get list of workspaces
     * @description Returns the list of workspaces the current token can access.
     */
    get: operations["getV1Workspaces"];
    put?: never;
    /**
     * Create a workspace
     * @description ⚠️ Experimental endpoint: this API is in active development and may change at any time without notice. ⚠️
     *
     *     Creates a new free-plan workspace owned by the authenticated user. For agent tokens the workspace is created for the agent's sponsor, and the agent's permission policy treats this as an admin action — under the default policy the sponsor approves it first.
     */
    post: operations["postV1Workspaces"];
    delete?: never;
    options?: never;
    head?: never;
    patch?: never;
    trace?: never;
  };
  "/v1/workspaces/{id}": {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    /**
     * Get workspace
     * @description Returns the workspace with the given ID.
     */
    get: operations["getV1WorkspacesById"];
    put?: never;
    post?: never;
    delete?: never;
    options?: never;
    head?: never;
    patch?: never;
    trace?: never;
  };
  "/v1/workspaces/{id}/subscription": {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    /**
     * Get workspace subscription
     * @description Returns subscription information for the workspace with the given ID.
     */
    get: operations["getV1WorkspacesByIdSubscription"];
    put?: never;
    post?: never;
    delete?: never;
    options?: never;
    head?: never;
    patch?: never;
    trace?: never;
  };
}
type webhooks = Record<string, never>;
interface components {
  schemas: never;
  responses: never;
  parameters: never;
  requestBodies: never;
  headers: never;
  pathItems: never;
}
type $defs = Record<string, never>;
interface operations {
  "getV1Agent-approvalsByApprovalId": {
    parameters: {
      query?: never;
      header?: never;
      path: {
        approvalId: string;
      };
      cookie?: never;
    };
    requestBody?: never;
    responses: {
      /** @description The approval's current state */
      200: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            id: string;
            /** @enum {string} */
            status: "pending" | "approved" | "approved_window" | "denied" | "expired" | "consumed";
            expiresAt: string;
            windowExpiresAt: string | null;
            decidedAt: string | null;
            hint?: string;
          };
        };
      };
      /** @description No such approval for this agent */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  getV1Apps: {
    parameters: {
      query?: {
        cursor?: string | null;
        limit?: number;
        projectId?: string;
        logicalId?: string;
        branchId?: "unassigned" | string;
        branchGitName?: string;
      };
      header?: never;
      path?: never;
      cookie?: never;
    };
    requestBody?: never;
    responses: {
      /** @description Returns the list of apps. */
      200: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              id: string;
              /** @constant */
              type: "app";
              /** Format: uri */
              url: string;
              name: string;
              region: {
                id: string;
                name: string;
              };
              projectId: string;
              branchId: string | null;
              latestDeploymentId: string | null;
              appEndpointDomain: string;
              /** Format: date-time */
              createdAt: string;
              logicalId: string | null;
            }[];
            pagination: {
              /** @description Next cursor to continue pagination */
              nextCursor: string | null;
              /** @description Whether there are more items to paginate */
              hasMore: boolean;
            };
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Insufficient permissions to access this resource. */
      403: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Validation failed (e.g. malformed projectId filter). */
      422: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Rate limit exceeded. */
      429: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  postV1Apps: {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    requestBody?: {
      content: {
        "application/json": {
          displayName: string;
          /**
           * @default us-east-1
           * @enum {string}
           */
          regionId?: "us-east-1" | "us-west-1" | "eu-west-3" | "eu-central-1" | "ap-northeast-1" | "ap-southeast-1";
          branchId?: string | null;
          branchGitName?: string | null;
          projectId: string;
          /** @description Declared identity of the resource, unique within its branch. Set by the tool that declares the resource. */
          logicalId?: string;
        };
      };
    };
    responses: {
      /** @description App created. */
      201: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              id: string;
              /** @constant */
              type: "app";
              /** Format: uri */
              url: string;
              name: string;
              region: {
                id: string;
                name: string;
              };
              projectId: string;
              branchId: string | null;
              latestDeploymentId: string | null;
              appEndpointDomain: string;
              /** Format: date-time */
              createdAt: string;
              logicalId: string | null;
            };
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Insufficient permissions to access this resource. */
      403: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Project not found. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description An app already occupies the slot on the resolved branch, by `displayName` or by `logicalId`. The body includes the existing app's id, name, branch git name, and logical id; `conflict` says which attribute clashed. */
      409: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              /** @constant */
              code: "app:already_exists";
              message: string;
              existingAppId: string;
              name: string;
              branchGitName: string;
              /**
               * @description Which attribute of the existing app clashed.
               * @enum {string}
               */
              conflict?: "name" | "logicalId";
              /** @description The existing app's logical id. */
              logicalId?: string | null;
            };
          };
        };
      };
      /** @description Request body exceeds this endpoint's size cap. */
      413: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Validation failed (e.g. missing projectId, empty display name, or invalid region). */
      422: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Rate limit exceeded. */
      429: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  getV1AppsByAppId: {
    parameters: {
      query?: never;
      header?: never;
      path: {
        appId: string;
      };
      cookie?: never;
    };
    requestBody?: never;
    responses: {
      /** @description App retrieved. */
      200: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              id: string;
              /** @constant */
              type: "app";
              /** Format: uri */
              url: string;
              name: string;
              region: {
                id: string;
                name: string;
              };
              projectId: string;
              branchId: string | null;
              latestDeploymentId: string | null;
              appEndpointDomain: string;
              /** Format: date-time */
              createdAt: string;
              logicalId: string | null;
            };
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Insufficient permissions to access this resource. */
      403: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description App not found. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Rate limit exceeded. */
      429: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  deleteV1AppsByAppId: {
    parameters: {
      query?: never;
      header?: never;
      path: {
        appId: string;
      };
      cookie?: never;
    };
    requestBody?: never;
    responses: {
      /** @description App deleted. */
      204: {
        headers: {
          [name: string]: unknown;
        };
        content?: never;
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Insufficient permissions to access this resource. */
      403: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description App not found. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description A deployment could not be deleted, or a concurrent deployment was created while deleting the app. */
      409: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Rate limit exceeded. */
      429: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  patchV1AppsByAppId: {
    parameters: {
      query?: never;
      header?: never;
      path: {
        appId: string;
      };
      cookie?: never;
    };
    requestBody?: {
      content: {
        "application/json": {
          displayName?: string;
          /** @description Declared identity of the resource, unique within its branch. Set by the tool that declares the resource. */
          logicalId?: string;
          branchId?: string | null;
          branchGitName?: string | null;
        };
      };
    };
    responses: {
      /** @description App updated. */
      200: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              id: string;
              /** @constant */
              type: "app";
              /** Format: uri */
              url: string;
              name: string;
              region: {
                id: string;
                name: string;
              };
              projectId: string;
              branchId: string | null;
              latestDeploymentId: string | null;
              appEndpointDomain: string;
              /** Format: date-time */
              createdAt: string;
              logicalId: string | null;
            };
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Insufficient permissions to access this resource. */
      403: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description App not found. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description An app with the same `logicalId` already exists on the branch. */
      409: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Request body exceeds this endpoint's size cap. */
      413: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Validation failed (e.g. empty display name). */
      422: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Rate limit exceeded. */
      429: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  postV1AppsByAppIdPromote: {
    parameters: {
      query?: never;
      header?: never;
      path: {
        appId: string;
      };
      cookie?: never;
    };
    requestBody?: {
      content: {
        "application/json": {
          deploymentId?: string;
          /**
           * @deprecated
           * @description Deprecated: use `deploymentId` instead. Ignored when `deploymentId` is also present.
           */
          versionId?: string;
        };
      };
    };
    responses: {
      /** @description Deployment promoted to app endpoint. The `reassignedDomains` field indicates how many custom domains were moved from the previously-promoted deployment to the new one. */
      200: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              appEndpointDomain: string;
              reassignedDomains: number;
            };
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Insufficient permissions to access this resource. */
      403: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description App or deployment not found. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description The deployment is not running. */
      409: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Request body exceeds this endpoint's size cap. */
      413: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Validation failed (e.g. malformed app ID or missing deployment ID). */
      422: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Rate limit or Compute resource limit exceeded. */
      429: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  postV1AppsByAppIdRollback: {
    parameters: {
      query?: never;
      header?: never;
      path: {
        appId: string;
      };
      cookie?: never;
    };
    requestBody?: {
      content: {
        "application/json": {
          deploymentId?: string;
          /**
           * @deprecated
           * @description Deprecated: use `deploymentId` instead. Ignored when `deploymentId` is also present.
           */
          versionId?: string;
        };
      };
    };
    responses: {
      /** @description Deployment made live behind the app endpoint. The `reassignedDomains` field indicates how many custom domains were moved from the previously-live deployment to the new one. */
      200: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              appEndpointDomain: string;
              reassignedDomains: number;
            };
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Insufficient permissions to access this resource. */
      403: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description App or deployment not found, or the deployment's Foundry artifact no longer exists. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description The deployment cannot be made live (e.g. it has no runnable artifact or is mid-teardown and cannot reach a running state). */
      409: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Request body exceeds this endpoint's size cap. */
      413: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Validation failed (e.g. malformed app ID or missing deployment ID). */
      422: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Rate limit or Compute resource limit exceeded. */
      429: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  getV1AppsByAppIdDomains: {
    parameters: {
      query?: never;
      header?: never;
      path: {
        appId: string;
      };
      cookie?: never;
    };
    requestBody?: never;
    responses: {
      /** @description List of custom domains. */
      200: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              id: string;
              /** @constant */
              type: "custom-domain";
              /** Format: uri */
              url: string;
              hostname: string;
              appId: string;
              /**
               * @deprecated
               * @description Deprecated: use `appId` instead.
               */
              computeServiceId: string;
              /** @enum {string} */
              status: "pending_dns" | "verifying" | "verified_routing_blocked" | "provisioning_tls" | "active" | "failed" | "removing";
              foundryStatus: string;
              failureReason: string | null;
              /** @enum {string|null} */
              failureCategory: "dns" | "acme" | "storage" | "unknown" | null;
              /** Format: date-time */
              certExpiresAt: string | null;
              /** Format: date-time */
              createdAt: string;
              /** Format: date-time */
              updatedAt: string;
              dnsRecords: {
                /** @constant */
                type: "CNAME";
                name: string;
                value: string;
                ttl: number | null;
              }[];
            }[];
            pagination: {
              /** @constant */
              hasMore: false;
              nextCursor: null;
            };
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Insufficient permissions. */
      403: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description App not found. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Rate limit exceeded. */
      429: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  postV1AppsByAppIdDomains: {
    parameters: {
      query?: never;
      header?: never;
      path: {
        appId: string;
      };
      cookie?: never;
    };
    requestBody?: {
      content: {
        "application/json": {
          hostname: string;
        };
      };
    };
    responses: {
      /** @description Custom domain already registered on this app. */
      200: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              id: string;
              /** @constant */
              type: "custom-domain";
              /** Format: uri */
              url: string;
              hostname: string;
              appId: string;
              /**
               * @deprecated
               * @description Deprecated: use `appId` instead.
               */
              computeServiceId: string;
              /** @enum {string} */
              status: "pending_dns" | "verifying" | "verified_routing_blocked" | "provisioning_tls" | "active" | "failed" | "removing";
              foundryStatus: string;
              failureReason: string | null;
              /** @enum {string|null} */
              failureCategory: "dns" | "acme" | "storage" | "unknown" | null;
              /** Format: date-time */
              certExpiresAt: string | null;
              /** Format: date-time */
              createdAt: string;
              /** Format: date-time */
              updatedAt: string;
              dnsRecords: {
                /** @constant */
                type: "CNAME";
                name: string;
                value: string;
                ttl: number | null;
              }[];
            };
          };
        };
      };
      /** @description Custom domain created. */
      201: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              id: string;
              /** @constant */
              type: "custom-domain";
              /** Format: uri */
              url: string;
              hostname: string;
              appId: string;
              /**
               * @deprecated
               * @description Deprecated: use `appId` instead.
               */
              computeServiceId: string;
              /** @enum {string} */
              status: "pending_dns" | "verifying" | "verified_routing_blocked" | "provisioning_tls" | "active" | "failed" | "removing";
              foundryStatus: string;
              failureReason: string | null;
              /** @enum {string|null} */
              failureCategory: "dns" | "acme" | "storage" | "unknown" | null;
              /** Format: date-time */
              certExpiresAt: string | null;
              /** Format: date-time */
              createdAt: string;
              /** Format: date-time */
              updatedAt: string;
              dnsRecords: {
                /** @constant */
                type: "CNAME";
                name: string;
                value: string;
                ttl: number | null;
              }[];
            };
          };
        };
      };
      /** @description Invalid hostname or DNS verification failed. */
      400: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Insufficient permissions. */
      403: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description App not found. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Hostname already registered. */
      409: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Request body exceeds this endpoint's size cap. */
      413: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description App has no promoted deployment. */
      422: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Domain quota exceeded or rate limit exceeded. */
      429: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  getV1AppsByAppIdDeployments: {
    parameters: {
      query?: {
        cursor?: string | null;
        limit?: number;
      };
      header?: never;
      path: {
        appId: string;
      };
      cookie?: never;
    };
    requestBody?: never;
    responses: {
      /** @description Returns the list of deployments. */
      200: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              id: string;
              /** @constant */
              type: "deployment";
              /** Format: uri */
              url: string;
              serviceId: string;
              foundryVersionId: string;
              /** Format: date-time */
              createdAt: string;
            }[];
            pagination: {
              /** @description Next cursor to continue pagination */
              nextCursor: string | null;
              /** @description Whether there are more items to paginate */
              hasMore: boolean;
            };
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Insufficient permissions to access this resource. */
      403: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description App not found. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Rate limit exceeded. */
      429: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  postV1AppsByAppIdDeployments: {
    parameters: {
      query?: never;
      header?: never;
      path: {
        appId: string;
      };
      cookie?: never;
    };
    requestBody?: {
      content: {
        "application/json": {
          portMapping?: {
            http?: number | null;
          };
          skipCodeUpload?: boolean;
        };
      };
    };
    responses: {
      /** @description Deployment created. */
      201: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              id: string;
              /** @constant */
              type: "deployment";
              /** Format: uri */
              url: string;
              foundryVersionId: string;
              uploadUrl: string | null;
            };
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Insufficient permissions to access this resource. */
      403: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description App not found, or the app's attached Branch has been deleted. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Request body exceeds this endpoint's size cap. */
      413: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Validation failed (e.g. `skipCodeUpload` without an active promoted deployment, or the app is not attached to a Branch — env-var resolution requires a Branch). */
      422: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Rate limit exceeded. */
      429: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Internal error while resolving the deploy-time env vars (e.g., a master-key rotation or storage corruption prevents the project's wrapped DEK or a per-value envelope from being decrypted). Not a client-fixable condition. */
      500: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  getV1Services: {
    parameters: {
      query?: {
        cursor?: string | null;
        limit?: number;
        projectId?: string;
        logicalId?: string;
        branchId?: "unassigned" | string;
        branchGitName?: string;
      };
      header?: never;
      path?: never;
      cookie?: never;
    };
    requestBody?: never;
    responses: {
      /** @description Returns the list of services. */
      200: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              id: string;
              /** @constant */
              type: "app";
              /** Format: uri */
              url: string;
              name: string;
              region: {
                id: string;
                name: string;
              };
              projectId: string;
              branchId: string | null;
              latestDeploymentId: string | null;
              appEndpointDomain: string;
              /** Format: date-time */
              createdAt: string;
              logicalId: string | null;
            }[];
            pagination: {
              /** @description Next cursor to continue pagination */
              nextCursor: string | null;
              /** @description Whether there are more items to paginate */
              hasMore: boolean;
            };
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Insufficient permissions to access this resource. */
      403: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Validation failed (e.g. malformed projectId filter). */
      422: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Rate limit exceeded. */
      429: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  postV1Services: {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    requestBody?: {
      content: {
        "application/json": {
          displayName: string;
          /**
           * @default us-east-1
           * @enum {string}
           */
          regionId?: "us-east-1" | "us-west-1" | "eu-west-3" | "eu-central-1" | "ap-northeast-1" | "ap-southeast-1";
          branchId?: string | null;
          branchGitName?: string | null;
          projectId: string;
          /** @description Declared identity of the resource, unique within its branch. Set by the tool that declares the resource. */
          logicalId?: string;
        };
      };
    };
    responses: {
      /** @description Service created. */
      201: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              id: string;
              /** @constant */
              type: "app";
              /** Format: uri */
              url: string;
              name: string;
              region: {
                id: string;
                name: string;
              };
              projectId: string;
              branchId: string | null;
              latestDeploymentId: string | null;
              appEndpointDomain: string;
              /** Format: date-time */
              createdAt: string;
              logicalId: string | null;
            };
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Insufficient permissions to access this resource. */
      403: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Project not found. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description A service already occupies the slot on the resolved branch, by `displayName` or by `logicalId`. The body includes the existing service's id, name, branch git name, and logical id; `conflict` says which attribute clashed. */
      409: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              /** @constant */
              code: "app:already_exists";
              message: string;
              existingAppId: string;
              name: string;
              branchGitName: string;
              /**
               * @description Which attribute of the existing app clashed.
               * @enum {string}
               */
              conflict?: "name" | "logicalId";
              /** @description The existing app's logical id. */
              logicalId?: string | null;
            };
          };
        };
      };
      /** @description Request body exceeds this endpoint's size cap. */
      413: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Validation failed (e.g. missing projectId, empty display name, or invalid region). */
      422: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Rate limit exceeded. */
      429: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  getV1ServicesByServiceId: {
    parameters: {
      query?: never;
      header?: never;
      path: {
        serviceId: string;
      };
      cookie?: never;
    };
    requestBody?: never;
    responses: {
      /** @description Service retrieved. */
      200: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              id: string;
              /** @constant */
              type: "app";
              /** Format: uri */
              url: string;
              name: string;
              region: {
                id: string;
                name: string;
              };
              projectId: string;
              branchId: string | null;
              latestDeploymentId: string | null;
              appEndpointDomain: string;
              /** Format: date-time */
              createdAt: string;
              logicalId: string | null;
            };
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Insufficient permissions to access this resource. */
      403: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Service not found. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Rate limit exceeded. */
      429: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  deleteV1ServicesByServiceId: {
    parameters: {
      query?: never;
      header?: never;
      path: {
        serviceId: string;
      };
      cookie?: never;
    };
    requestBody?: never;
    responses: {
      /** @description Service deleted. */
      204: {
        headers: {
          [name: string]: unknown;
        };
        content?: never;
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Insufficient permissions to access this resource. */
      403: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Service not found. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description A deployment could not be deleted, or a concurrent deployment was created while deleting the service. */
      409: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Rate limit exceeded. */
      429: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  patchV1ServicesByServiceId: {
    parameters: {
      query?: never;
      header?: never;
      path: {
        serviceId: string;
      };
      cookie?: never;
    };
    requestBody?: {
      content: {
        "application/json": {
          displayName?: string;
          /** @description Declared identity of the resource, unique within its branch. Set by the tool that declares the resource. */
          logicalId?: string;
          branchId?: string | null;
          branchGitName?: string | null;
        };
      };
    };
    responses: {
      /** @description Service updated. */
      200: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              id: string;
              /** @constant */
              type: "app";
              /** Format: uri */
              url: string;
              name: string;
              region: {
                id: string;
                name: string;
              };
              projectId: string;
              branchId: string | null;
              latestDeploymentId: string | null;
              appEndpointDomain: string;
              /** Format: date-time */
              createdAt: string;
              logicalId: string | null;
            };
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Insufficient permissions to access this resource. */
      403: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Service not found. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description A service with the same `logicalId` already exists on the branch. */
      409: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Request body exceeds this endpoint's size cap. */
      413: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Validation failed (e.g. empty display name). */
      422: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Rate limit exceeded. */
      429: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  postV1ServicesByServiceIdPromote: {
    parameters: {
      query?: never;
      header?: never;
      path: {
        serviceId: string;
      };
      cookie?: never;
    };
    requestBody?: {
      content: {
        "application/json": {
          deploymentId?: string;
          /**
           * @deprecated
           * @description Deprecated: use `deploymentId` instead. Ignored when `deploymentId` is also present.
           */
          versionId?: string;
        };
      };
    };
    responses: {
      /** @description Deployment promoted to service endpoint. The `reassignedDomains` field indicates how many custom domains were moved from the previously-promoted deployment to the new one. */
      200: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              appEndpointDomain: string;
              reassignedDomains: number;
            };
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Insufficient permissions to access this resource. */
      403: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Service or deployment not found. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description The deployment is not running. */
      409: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Request body exceeds this endpoint's size cap. */
      413: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Validation failed (e.g. malformed service ID or missing deployment ID). */
      422: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Rate limit or Compute resource limit exceeded. */
      429: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  postV1ServicesByServiceIdRollback: {
    parameters: {
      query?: never;
      header?: never;
      path: {
        serviceId: string;
      };
      cookie?: never;
    };
    requestBody?: {
      content: {
        "application/json": {
          deploymentId?: string;
          /**
           * @deprecated
           * @description Deprecated: use `deploymentId` instead. Ignored when `deploymentId` is also present.
           */
          versionId?: string;
        };
      };
    };
    responses: {
      /** @description Deployment made live behind the service endpoint. The `reassignedDomains` field indicates how many custom domains were moved from the previously-live deployment to the new one. */
      200: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              appEndpointDomain: string;
              reassignedDomains: number;
            };
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Insufficient permissions to access this resource. */
      403: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Service or deployment not found, or the deployment's Foundry artifact no longer exists. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description The deployment cannot be made live (e.g. it has no runnable artifact or is mid-teardown and cannot reach a running state). */
      409: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Request body exceeds this endpoint's size cap. */
      413: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Validation failed (e.g. malformed service ID or missing deployment ID). */
      422: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Rate limit or Compute resource limit exceeded. */
      429: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  getV1ServicesByServiceIdDomains: {
    parameters: {
      query?: never;
      header?: never;
      path: {
        serviceId: string;
      };
      cookie?: never;
    };
    requestBody?: never;
    responses: {
      /** @description List of custom domains. */
      200: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              id: string;
              /** @constant */
              type: "custom-domain";
              /** Format: uri */
              url: string;
              hostname: string;
              appId: string;
              /**
               * @deprecated
               * @description Deprecated: use `appId` instead.
               */
              computeServiceId: string;
              /** @enum {string} */
              status: "pending_dns" | "verifying" | "verified_routing_blocked" | "provisioning_tls" | "active" | "failed" | "removing";
              foundryStatus: string;
              failureReason: string | null;
              /** @enum {string|null} */
              failureCategory: "dns" | "acme" | "storage" | "unknown" | null;
              /** Format: date-time */
              certExpiresAt: string | null;
              /** Format: date-time */
              createdAt: string;
              /** Format: date-time */
              updatedAt: string;
              dnsRecords: {
                /** @constant */
                type: "CNAME";
                name: string;
                value: string;
                ttl: number | null;
              }[];
            }[];
            pagination: {
              /** @constant */
              hasMore: false;
              nextCursor: null;
            };
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Insufficient permissions. */
      403: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Service not found. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Rate limit exceeded. */
      429: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  postV1ServicesByServiceIdDomains: {
    parameters: {
      query?: never;
      header?: never;
      path: {
        serviceId: string;
      };
      cookie?: never;
    };
    requestBody?: {
      content: {
        "application/json": {
          hostname: string;
        };
      };
    };
    responses: {
      /** @description Custom domain already registered on this service. */
      200: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              id: string;
              /** @constant */
              type: "custom-domain";
              /** Format: uri */
              url: string;
              hostname: string;
              appId: string;
              /**
               * @deprecated
               * @description Deprecated: use `appId` instead.
               */
              computeServiceId: string;
              /** @enum {string} */
              status: "pending_dns" | "verifying" | "verified_routing_blocked" | "provisioning_tls" | "active" | "failed" | "removing";
              foundryStatus: string;
              failureReason: string | null;
              /** @enum {string|null} */
              failureCategory: "dns" | "acme" | "storage" | "unknown" | null;
              /** Format: date-time */
              certExpiresAt: string | null;
              /** Format: date-time */
              createdAt: string;
              /** Format: date-time */
              updatedAt: string;
              dnsRecords: {
                /** @constant */
                type: "CNAME";
                name: string;
                value: string;
                ttl: number | null;
              }[];
            };
          };
        };
      };
      /** @description Custom domain created. */
      201: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              id: string;
              /** @constant */
              type: "custom-domain";
              /** Format: uri */
              url: string;
              hostname: string;
              appId: string;
              /**
               * @deprecated
               * @description Deprecated: use `appId` instead.
               */
              computeServiceId: string;
              /** @enum {string} */
              status: "pending_dns" | "verifying" | "verified_routing_blocked" | "provisioning_tls" | "active" | "failed" | "removing";
              foundryStatus: string;
              failureReason: string | null;
              /** @enum {string|null} */
              failureCategory: "dns" | "acme" | "storage" | "unknown" | null;
              /** Format: date-time */
              certExpiresAt: string | null;
              /** Format: date-time */
              createdAt: string;
              /** Format: date-time */
              updatedAt: string;
              dnsRecords: {
                /** @constant */
                type: "CNAME";
                name: string;
                value: string;
                ttl: number | null;
              }[];
            };
          };
        };
      };
      /** @description Invalid hostname or DNS verification failed. */
      400: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Insufficient permissions. */
      403: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Service not found. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Hostname already registered. */
      409: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Request body exceeds this endpoint's size cap. */
      413: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Service has no promoted deployment. */
      422: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Domain quota exceeded or rate limit exceeded. */
      429: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  getV1ServicesByServiceIdDeployments: {
    parameters: {
      query?: {
        cursor?: string | null;
        limit?: number;
      };
      header?: never;
      path: {
        serviceId: string;
      };
      cookie?: never;
    };
    requestBody?: never;
    responses: {
      /** @description Returns the list of deployments. */
      200: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              id: string;
              /** @constant */
              type: "deployment";
              /** Format: uri */
              url: string;
              serviceId: string;
              foundryVersionId: string;
              /** Format: date-time */
              createdAt: string;
            }[];
            pagination: {
              /** @description Next cursor to continue pagination */
              nextCursor: string | null;
              /** @description Whether there are more items to paginate */
              hasMore: boolean;
            };
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Insufficient permissions to access this resource. */
      403: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Service not found. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Rate limit exceeded. */
      429: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  postV1ServicesByServiceIdDeployments: {
    parameters: {
      query?: never;
      header?: never;
      path: {
        serviceId: string;
      };
      cookie?: never;
    };
    requestBody?: {
      content: {
        "application/json": {
          portMapping?: {
            http?: number | null;
          };
          skipCodeUpload?: boolean;
        };
      };
    };
    responses: {
      /** @description Deployment created. */
      201: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              id: string;
              /** @constant */
              type: "deployment";
              /** Format: uri */
              url: string;
              foundryVersionId: string;
              uploadUrl: string | null;
            };
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Insufficient permissions to access this resource. */
      403: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Service not found, or the service's attached Branch has been deleted. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Request body exceeds this endpoint's size cap. */
      413: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Validation failed (e.g. `skipCodeUpload` without an active promoted deployment, or the service is not attached to a Branch — env-var resolution requires a Branch). */
      422: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Rate limit exceeded. */
      429: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Internal error while resolving the deploy-time env vars (e.g., a master-key rotation or storage corruption prevents the project's wrapped DEK or a per-value envelope from being decrypted). Not a client-fixable condition. */
      500: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  getV1ProjectsByProjectIdBranches: {
    parameters: {
      query?: {
        cursor?: string | null;
        limit?: number;
        gitName?: string;
        gitNameContains?: string;
      };
      header?: never;
      path: {
        projectId: string;
      };
      cookie?: never;
    };
    requestBody?: never;
    responses: {
      /** @description Returned the list of Branches. */
      200: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              id: string;
              /** @constant */
              type: "branch";
              /** Format: uri */
              url: string;
              gitName: string;
              isDefault: boolean;
              /** @enum {string} */
              role: "production" | "preview";
              /** Format: date-time */
              createdAt: string;
              /** Format: date-time */
              updatedAt: string;
              /** @description Thin reference to the parent Project. Member resources are intentionally NOT inlined — list /v1/databases?branchId=<br_xxx> or /v1/apps?branchId=<br_xxx> instead (see API design principles "Flat and Hierarchical Coexistence"). */
              project: {
                id: string;
                /** Format: uri */
                url: string;
                name: string;
              };
            }[];
            pagination: {
              nextCursor: string | null;
              hasMore: boolean;
            };
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Project not found. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Mutually exclusive filters specified together. */
      422: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  postV1ProjectsByProjectIdBranches: {
    parameters: {
      query?: never;
      header?: never;
      path: {
        projectId: string;
      };
      cookie?: never;
    };
    requestBody?: {
      content: {
        "application/json": {
          gitName: string;
          isDefault?: boolean;
        };
      };
    };
    responses: {
      /** @description Created the Branch. */
      201: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              id: string;
              /** @constant */
              type: "branch";
              /** Format: uri */
              url: string;
              gitName: string;
              isDefault: boolean;
              /** @enum {string} */
              role: "production" | "preview";
              /** Format: date-time */
              createdAt: string;
              /** Format: date-time */
              updatedAt: string;
              /** @description Thin reference to the parent Project. Member resources are intentionally NOT inlined — list /v1/databases?branchId=<br_xxx> or /v1/apps?branchId=<br_xxx> instead (see API design principles "Flat and Hierarchical Coexistence"). */
              project: {
                id: string;
                /** Format: uri */
                url: string;
                name: string;
              };
            };
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Project not found. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description A live Branch with the same gitName already exists. */
      409: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Invalid gitName. */
      422: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  getV1BranchesByBranchId: {
    parameters: {
      query?: never;
      header?: never;
      path: {
        branchId: string;
      };
      cookie?: never;
    };
    requestBody?: never;
    responses: {
      /** @description Returned the Branch. */
      200: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              id: string;
              /** @constant */
              type: "branch";
              /** Format: uri */
              url: string;
              gitName: string;
              isDefault: boolean;
              /** @enum {string} */
              role: "production" | "preview";
              /** Format: date-time */
              createdAt: string;
              /** Format: date-time */
              updatedAt: string;
              /** @description Thin reference to the parent Project. Member resources are intentionally NOT inlined — list /v1/databases?branchId=<br_xxx> or /v1/apps?branchId=<br_xxx> instead (see API design principles "Flat and Hierarchical Coexistence"). */
              project: {
                id: string;
                /** Format: uri */
                url: string;
                name: string;
              };
            };
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Branch not found. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  deleteV1BranchesByBranchId: {
    parameters: {
      query?: never;
      header?: never;
      path: {
        branchId: string;
      };
      cookie?: never;
    };
    requestBody?: never;
    responses: {
      /** @description Branch soft-deleted. */
      204: {
        headers: {
          [name: string]: unknown;
        };
        content?: never;
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Branch not found. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Branch still has live member resources. */
      409: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Branch is the Project's current default or production Branch. */
      422: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  patchV1BranchesByBranchId: {
    parameters: {
      query?: never;
      header?: never;
      path: {
        branchId: string;
      };
      cookie?: never;
    };
    requestBody?: {
      content: {
        "application/json": {
          isDefault?: boolean | null;
        };
      };
    };
    responses: {
      /** @description Branch updated. */
      200: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              id: string;
              /** @constant */
              type: "branch";
              /** Format: uri */
              url: string;
              gitName: string;
              isDefault: boolean;
              /** @enum {string} */
              role: "production" | "preview";
              /** Format: date-time */
              createdAt: string;
              /** Format: date-time */
              updatedAt: string;
              /** @description Thin reference to the parent Project. Member resources are intentionally NOT inlined — list /v1/databases?branchId=<br_xxx> or /v1/apps?branchId=<br_xxx> instead (see API design principles "Flat and Hierarchical Coexistence"). */
              project: {
                id: string;
                /** Format: uri */
                url: string;
                name: string;
              };
            };
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Branch not found. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description gitName rename, role change, demote-default, or unknown field rejected. */
      422: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  getV1Buckets: {
    parameters: {
      query?: {
        cursor?: string | null;
        limit?: number;
        projectId?: string;
        logicalId?: string;
        branchId?: "unassigned" | string;
        branchGitName?: string;
      };
      header?: never;
      path?: never;
      cookie?: never;
    };
    requestBody?: never;
    responses: {
      /** @description Returns the list of buckets. */
      200: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              id: string;
              /** @constant */
              type: "bucket";
              /** Format: uri */
              url: string;
              name: string;
              providerName: string;
              status: string;
              /** Format: date-time */
              createdAt: string;
              project: {
                id: string;
                /** Format: uri */
                url: string;
                name: string;
              };
              branchId: string | null;
              logicalId: string | null;
            }[];
            pagination: {
              /** @description Next cursor to continue pagination */
              nextCursor: string | null;
              /** @description Whether there are more items to paginate */
              hasMore: boolean;
            };
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Request body exceeds this endpoint's size cap. */
      413: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  postV1Buckets: {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    requestBody?: {
      content: {
        "application/json": {
          /** @description ID of the project to create the bucket in */
          projectId: string;
          /** @description Display name for the bucket. Generated if omitted. */
          name?: string;
          /** @description ID of the branch to associate the bucket with. Mutually exclusive with branchGitName. */
          branchId?: string;
          /** @description Git name of the branch to associate the bucket with. Mutually exclusive with branchId. */
          branchGitName?: string;
          /** @description Declared identity of the resource, unique within its branch. Set by the tool that declares the resource. */
          logicalId?: string;
        };
      };
    };
    responses: {
      /** @description Created a new bucket. */
      201: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              id: string;
              /** @constant */
              type: "bucket";
              /** Format: uri */
              url: string;
              name: string;
              providerName: string;
              status: string;
              /** Format: date-time */
              createdAt: string;
              project: {
                id: string;
                /** Format: uri */
                url: string;
                name: string;
              };
              branchId: string | null;
              logicalId: string | null;
            };
          };
        };
      };
      /** @description Invalid request parameters. */
      400: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Actor does not have access to the specified project. */
      403: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Project or branch not found. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description A bucket with the same `logicalId` already exists on the branch. */
      409: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Request body exceeds this endpoint's size cap. */
      413: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  getV1BucketsByBucketId: {
    parameters: {
      query?: never;
      header?: never;
      path: {
        bucketId: string;
      };
      cookie?: never;
    };
    requestBody?: never;
    responses: {
      /** @description Returned the bucket with the given ID. */
      200: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              id: string;
              /** @constant */
              type: "bucket";
              /** Format: uri */
              url: string;
              name: string;
              providerName: string;
              status: string;
              /** Format: date-time */
              createdAt: string;
              project: {
                id: string;
                /** Format: uri */
                url: string;
                name: string;
              };
              branchId: string | null;
              logicalId: string | null;
            };
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Bucket with the given ID was not found. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Request body exceeds this endpoint's size cap. */
      413: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  deleteV1BucketsByBucketId: {
    parameters: {
      query?: never;
      header?: never;
      path: {
        bucketId: string;
      };
      cookie?: never;
    };
    requestBody?: never;
    responses: {
      /** @description Deleted the bucket successfully. */
      204: {
        headers: {
          [name: string]: unknown;
        };
        content?: never;
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Bucket with the given ID was not found. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Request body exceeds this endpoint's size cap. */
      413: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  patchV1BucketsByBucketId: {
    parameters: {
      query?: never;
      header?: never;
      path: {
        bucketId: string;
      };
      cookie?: never;
    };
    requestBody?: {
      content: {
        "application/json": {
          /** @description New display name for the bucket. A label only: the provider bucket name does not change. */
          displayName?: string;
          /** @description ID of the branch to move the bucket to. Mutually exclusive with branchGitName. */
          branchId?: string;
          /** @description Git name of the branch to move the bucket to; the branch is created when it does not exist. Mutually exclusive with branchId. */
          branchGitName?: string;
          /** @description Declared identity of the resource, unique within its branch. Set by the tool that declares the resource. */
          logicalId?: string;
        };
      };
    };
    responses: {
      /** @description Updated the bucket. */
      200: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              id: string;
              /** @constant */
              type: "bucket";
              /** Format: uri */
              url: string;
              name: string;
              providerName: string;
              status: string;
              /** Format: date-time */
              createdAt: string;
              project: {
                id: string;
                /** Format: uri */
                url: string;
                name: string;
              };
              branchId: string | null;
              logicalId: string | null;
            };
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Bucket or branch not found. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description A bucket with the same `logicalId` already exists on the branch, the bucket's `logicalId` is already taken on the target branch of a move, or the target branch changed during the move. */
      409: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Request body exceeds this endpoint's size cap. */
      413: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Validation failed (e.g. no field given, an empty display name, or `logicalId` combined with a branch move). */
      422: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  getV1BucketsByBucketIdKeys: {
    parameters: {
      query?: {
        cursor?: string | null;
        limit?: number;
      };
      header?: never;
      path: {
        bucketId: string;
      };
      cookie?: never;
    };
    requestBody?: never;
    responses: {
      /** @description Returns the list of bucket keys. */
      200: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              id: string;
              /** @constant */
              type: "bucketKey";
              name: string;
              valueHint: string;
              /** @enum {string} */
              role: "read" | "read_write";
              /** Format: date-time */
              createdAt: string;
            }[];
            pagination: {
              /** @description Next cursor to continue pagination */
              nextCursor: string | null;
              /** @description Whether there are more items to paginate */
              hasMore: boolean;
            };
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Bucket with the given ID was not found. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Request body exceeds this endpoint's size cap. */
      413: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  postV1BucketsByBucketIdKeys: {
    parameters: {
      query?: never;
      header?: never;
      path: {
        bucketId: string;
      };
      cookie?: never;
    };
    requestBody?: {
      content: {
        "application/json": {
          /** @description Display name for the key. Generated if omitted. */
          name?: string;
          /**
           * @description Access role for the key: "read" or "read_write".
           * @enum {string}
           */
          role: "read" | "read_write";
        };
      };
    };
    responses: {
      /** @description Created a new bucket key. The secret is returned once in the response body. */
      201: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              id: string;
              /** @constant */
              type: "bucketKey";
              name: string;
              valueHint: string;
              /** @enum {string} */
              role: "read" | "read_write";
              /** Format: date-time */
              createdAt: string;
              secretAccessKey: string;
              accessKeyId: string;
              endpoint: string;
              bucketName: string;
            };
          };
        };
      };
      /** @description Invalid request parameters. */
      400: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Bucket with the given ID was not found. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Request body exceeds this endpoint's size cap. */
      413: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  deleteV1BucketsByBucketIdKeysByKeyId: {
    parameters: {
      query?: never;
      header?: never;
      path: {
        bucketId: string;
        keyId: string;
      };
      cookie?: never;
    };
    requestBody?: never;
    responses: {
      /** @description Deleted the bucket key successfully. */
      204: {
        headers: {
          [name: string]: unknown;
        };
        content?: never;
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Bucket key not found or does not belong to the given bucket. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Request body exceeds this endpoint's size cap. */
      413: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  getV1Builds: {
    parameters: {
      query?: {
        cursor?: string | null;
        limit?: number;
        projectId?: string;
        branchId?: string;
        state?: "pending" | "running" | "succeeded" | "failed" | "cancelled";
      };
      header?: never;
      path?: never;
      cookie?: never;
    };
    requestBody?: never;
    responses: {
      /** @description Builds, newest first. */
      200: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              id: string;
              /** @enum {string} */
              source: "webhook" | "setup" | "manual" | "ci" | "cli";
              /** @enum {string} */
              state: "pending" | "running" | "succeeded" | "failed" | "cancelled";
              /**
               * @description Null when nothing reported a phase; the platform never invents an observation it did not receive.
               * @enum {string|null}
               */
              phase: "queued" | "build" | "deploy" | null;
              commitSha: string;
              branchName: string;
              /** @description Repository the build ran against. Set only when the workspace has a live link to it; a reported repository the platform does not know stays null. */
              gitRepoId: string | null;
              projectId: string | null;
              branchId: string | null;
              externalLogUrl: string | null;
              deployedUrl: string | null;
              applicationTopologyContentHash: string | null;
              errorMessage: string | null;
              failingStep: string | null;
              createdAt: string;
              startedAt: string | null;
              finishedAt: string | null;
            }[];
            pagination: {
              /** @description Next cursor to continue pagination */
              nextCursor: string | null;
              /** @description Whether there are more items to paginate */
              hasMore: boolean;
            };
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Build not found, or the caller's workspace does not own it (indistinguishable). */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Rate limit exceeded. */
      429: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  postV1Builds: {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    requestBody?: {
      content: {
        "application/json": {
          /**
           * @description `ci` for a build reported from a CI run, `cli` for a deploy run directly by a human or agent.
           * @enum {string}
           */
          source: "ci" | "cli";
          /** @description Commit the build ran on. */
          commitSha: string;
          /** @description Git branch name. */
          branchName: string;
          /** @description Identifies the CI run. Supplying it makes creation idempotent — a repeat call for the same run returns the build that already exists. Omit it for builds with no run to name, such as a deploy from a laptop, where every call creates a new build. */
          runIdentity?: {
            /**
             * @description CI provider the run identity belongs to.
             * @constant
             */
            provider: "github";
            /** @description Provider's repository id (for GitHub, the numeric repo id). */
            repositoryId: string;
            /** @description Provider's workflow-run id. */
            runId: string;
            /** @description Attempt number of the run; a re-run is a separate build. */
            runAttempt: number;
          };
          /**
           * Format: uri
           * @description Link to the run's logs in the reporter's own system.
           */
          externalLogUrl?: string;
          /** @description Project the build targets, when it exists. A build may be reported before its project does. */
          projectId?: string;
          branchId?: string;
          /** @description Content hash of the application topology this run deploys, as submitted to the application-topology endpoint. A value match, never a reference: equal hashes identify the same graph. */
          applicationTopologyContentHash?: string;
        };
      };
    };
    responses: {
      /** @description The build. Returned whether this call created it or an earlier report of the same run did. */
      201: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              id: string;
              /** @enum {string} */
              source: "webhook" | "setup" | "manual" | "ci" | "cli";
              /** @enum {string} */
              state: "pending" | "running" | "succeeded" | "failed" | "cancelled";
              /**
               * @description Null when nothing reported a phase; the platform never invents an observation it did not receive.
               * @enum {string|null}
               */
              phase: "queued" | "build" | "deploy" | null;
              commitSha: string;
              branchName: string;
              /** @description Repository the build ran against. Set only when the workspace has a live link to it; a reported repository the platform does not know stays null. */
              gitRepoId: string | null;
              projectId: string | null;
              branchId: string | null;
              externalLogUrl: string | null;
              deployedUrl: string | null;
              applicationTopologyContentHash: string | null;
              errorMessage: string | null;
              failingStep: string | null;
              createdAt: string;
              startedAt: string | null;
              finishedAt: string | null;
            };
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Build not found, or the caller's workspace does not own it (indistinguishable). */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Request body exceeds this endpoint's size cap. */
      413: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Rate limit exceeded. */
      429: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  getV1BuildsByBuildId: {
    parameters: {
      query?: never;
      header?: never;
      path: {
        buildId: string;
      };
      cookie?: never;
    };
    requestBody?: never;
    responses: {
      /** @description The build, with its reported resources. */
      200: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              id: string;
              /** @enum {string} */
              source: "webhook" | "setup" | "manual" | "ci" | "cli";
              /** @enum {string} */
              state: "pending" | "running" | "succeeded" | "failed" | "cancelled";
              /**
               * @description Null when nothing reported a phase; the platform never invents an observation it did not receive.
               * @enum {string|null}
               */
              phase: "queued" | "build" | "deploy" | null;
              commitSha: string;
              branchName: string;
              /** @description Repository the build ran against. Set only when the workspace has a live link to it; a reported repository the platform does not know stays null. */
              gitRepoId: string | null;
              projectId: string | null;
              branchId: string | null;
              externalLogUrl: string | null;
              deployedUrl: string | null;
              applicationTopologyContentHash: string | null;
              errorMessage: string | null;
              failingStep: string | null;
              createdAt: string;
              startedAt: string | null;
              finishedAt: string | null;
              resources: {
                /** @enum {string} */
                resourceType: "project" | "branch" | "database" | "app" | "deployment" | "bucket" | "service_key" | "config_variable";
                /** @description Prefixed id of the reported resource. */
                resourceId: string;
                /** @enum {string} */
                action: "created" | "acted_on" | "deleted";
                createdAt: string;
              }[];
            };
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Build not found, or the caller's workspace does not own it (indistinguishable). */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Rate limit exceeded. */
      429: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  patchV1BuildsByBuildId: {
    parameters: {
      query?: never;
      header?: never;
      path: {
        buildId: string;
      };
      cookie?: never;
    };
    requestBody?: {
      content: {
        "application/json": {
          /**
           * @description How far the run has got.
           * @enum {string}
           */
          phase?: "queued" | "build" | "deploy";
          /** @enum {string} */
          state?: "pending" | "running" | "succeeded" | "failed" | "cancelled";
          /** @description Name of the step that failed, free text — step names come from build tooling the platform cannot validate. */
          failingStep?: string;
          errorMessage?: string;
          /** Format: uri */
          externalLogUrl?: string;
          /** @description Project the build targets. Can be set once and never changed: a reporter that learns the project partway through a deploy may set it, but a value already recorded cannot be changed. */
          projectId?: string;
          /** @description Branch the build targets. Can be set once and never changed, like `projectId`. */
          branchId?: string;
          /**
           * Format: uri
           * @description Where the deployed app can be reached. Can be set once and never changed, like `projectId`.
           */
          deployedUrl?: string;
          /** @description Content hash of the application topology this run deploys, as submitted to the application-topology endpoint. A value match, never a reference: equal hashes identify the same graph. Can be set once and never changed, like `projectId`. */
          applicationTopologyContentHash?: string;
        };
      };
    };
    responses: {
      /** @description The updated build. */
      200: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              id: string;
              /** @enum {string} */
              source: "webhook" | "setup" | "manual" | "ci" | "cli";
              /** @enum {string} */
              state: "pending" | "running" | "succeeded" | "failed" | "cancelled";
              /**
               * @description Null when nothing reported a phase; the platform never invents an observation it did not receive.
               * @enum {string|null}
               */
              phase: "queued" | "build" | "deploy" | null;
              commitSha: string;
              branchName: string;
              /** @description Repository the build ran against. Set only when the workspace has a live link to it; a reported repository the platform does not know stays null. */
              gitRepoId: string | null;
              projectId: string | null;
              branchId: string | null;
              externalLogUrl: string | null;
              deployedUrl: string | null;
              applicationTopologyContentHash: string | null;
              errorMessage: string | null;
              failingStep: string | null;
              createdAt: string;
              startedAt: string | null;
              finishedAt: string | null;
            };
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Build not found, or the caller's workspace does not own it (indistinguishable). */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description A field that can only be set once already holds a different value. */
      409: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Request body exceeds this endpoint's size cap. */
      413: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Rate limit exceeded. */
      429: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  putV1BuildsByBuildIdResourcesByResourceTypeByResourceId: {
    parameters: {
      query?: never;
      header?: never;
      path: {
        buildId: string;
        resourceType: "project" | "branch" | "database" | "app" | "deployment" | "bucket" | "service_key" | "config_variable";
        resourceId: string;
      };
      cookie?: never;
    };
    requestBody?: {
      content: {
        "application/json": {
          /**
           * @description The strongest effect the build had on the resource. Re-reporting is safe: a weaker action never overwrites a stronger one, so `created` survives a later `acted_on`.
           * @enum {string}
           */
          action: "created" | "acted_on" | "deleted";
        };
      };
    };
    responses: {
      /** @description Recorded. */
      204: {
        headers: {
          [name: string]: unknown;
        };
        content?: never;
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Build or resource not found, or the caller's workspace does not own it (indistinguishable). */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Request body exceeds this endpoint's size cap. */
      413: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Rate limit exceeded. */
      429: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  getV1BuildsByBuildIdLogs: {
    parameters: {
      query?: {
        follow?: "true" | "false";
        cursor?: string;
      };
      header?: never;
      path: {
        buildId: string;
      };
      cookie?: never;
    };
    requestBody?: never;
    responses: {
      /** @description Build log stream (newline-delimited JSON; one `BuildLogNdjsonLine` per line). */
      200: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/x-ndjson": {
            /** @constant */
            type: "log";
            text: string;
            /** @enum {string} */
            level: "info" | "error";
            /** @enum {string} */
            source: "runner" | "stdout" | "stderr";
            step?: string;
            cursor: string;
          } | {
            /** @constant */
            type: "terminal";
            /** @enum {string} */
            kind: "end" | "error";
            code: string;
            message: string;
            retryable: boolean;
            cursor: string | null;
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Build not found, or the caller's workspace does not own it (indistinguishable). */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Rate limit exceeded. */
      429: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  getV1DomainsByDomainId: {
    parameters: {
      query?: never;
      header?: never;
      path: {
        domainId: string;
      };
      cookie?: never;
    };
    requestBody?: never;
    responses: {
      /** @description Custom domain details. */
      200: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              id: string;
              /** @constant */
              type: "custom-domain";
              /** Format: uri */
              url: string;
              hostname: string;
              appId: string;
              /**
               * @deprecated
               * @description Deprecated: use `appId` instead.
               */
              computeServiceId: string;
              /** @enum {string} */
              status: "pending_dns" | "verifying" | "verified_routing_blocked" | "provisioning_tls" | "active" | "failed" | "removing";
              foundryStatus: string;
              failureReason: string | null;
              /** @enum {string|null} */
              failureCategory: "dns" | "acme" | "storage" | "unknown" | null;
              /** Format: date-time */
              certExpiresAt: string | null;
              /** Format: date-time */
              createdAt: string;
              /** Format: date-time */
              updatedAt: string;
              dnsRecords: {
                /** @constant */
                type: "CNAME";
                name: string;
                value: string;
                ttl: number | null;
              }[];
            };
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Insufficient permissions. */
      403: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Custom domain not found. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Rate limit exceeded. */
      429: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  deleteV1DomainsByDomainId: {
    parameters: {
      query?: never;
      header?: never;
      path: {
        domainId: string;
      };
      cookie?: never;
    };
    requestBody?: never;
    responses: {
      /** @description Custom domain deleted. */
      204: {
        headers: {
          [name: string]: unknown;
        };
        content?: never;
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Insufficient permissions. */
      403: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Custom domain not found. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Rate limit exceeded. */
      429: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  postV1DomainsByDomainIdRetry: {
    parameters: {
      query?: never;
      header?: never;
      path: {
        domainId: string;
      };
      cookie?: never;
    };
    requestBody?: never;
    responses: {
      /** @description Retry initiated, domain state returned. */
      200: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              id: string;
              /** @constant */
              type: "custom-domain";
              /** Format: uri */
              url: string;
              hostname: string;
              appId: string;
              /**
               * @deprecated
               * @description Deprecated: use `appId` instead.
               */
              computeServiceId: string;
              /** @enum {string} */
              status: "pending_dns" | "verifying" | "verified_routing_blocked" | "provisioning_tls" | "active" | "failed" | "removing";
              foundryStatus: string;
              failureReason: string | null;
              /** @enum {string|null} */
              failureCategory: "dns" | "acme" | "storage" | "unknown" | null;
              /** Format: date-time */
              certExpiresAt: string | null;
              /** Format: date-time */
              createdAt: string;
              /** Format: date-time */
              updatedAt: string;
              dnsRecords: {
                /** @constant */
                type: "CNAME";
                name: string;
                value: string;
                ttl: number | null;
              }[];
            };
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Insufficient permissions. */
      403: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Custom domain not found. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Domain is not yet eligible for retry (e.g. still provisioning). */
      409: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Rate limit exceeded. */
      429: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  getV1Connections: {
    parameters: {
      query?: {
        cursor?: string | null;
        limit?: number;
        databaseId?: string;
      };
      header?: never;
      path?: never;
      cookie?: never;
    };
    requestBody?: never;
    responses: {
      /** @description Returned list of connections. */
      200: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              id: string;
              /** @constant */
              type: "connection";
              /** Format: uri */
              url: string;
              name: string;
              /** Format: date-time */
              createdAt: string;
              /** @enum {string} */
              kind: "postgres" | "accelerate";
              endpoints: {
                direct?: {
                  host: string;
                  port: number;
                };
                pooled?: {
                  host: string;
                  port: number;
                };
                accelerate?: {
                  host: string;
                  port: number;
                };
              };
              /**
               * @deprecated
               * @description Deprecated: use `endpoints.direct` instead.
               */
              directConnection?: {
                host: string;
                pass: string;
                user: string;
              } | null;
              database: {
                id: string;
                /** Format: uri */
                url: string;
                name: string;
              };
            }[];
            pagination: {
              /** @description Next cursor to continue pagination */
              nextCursor: string | null;
              /** @description Whether there are more items to paginate */
              hasMore: boolean;
            };
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  postV1Connections: {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    requestBody?: {
      content: {
        "application/json": {
          databaseId: string;
          name: string;
        };
      };
    };
    responses: {
      /** @description Created a new connection. */
      201: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              id: string;
              /** @constant */
              type: "connection";
              /** Format: uri */
              url: string;
              name: string;
              /** Format: date-time */
              createdAt: string;
              /** @enum {string} */
              kind: "postgres" | "accelerate";
              endpoints: {
                direct?: {
                  host: string;
                  port: number;
                  connectionString: string;
                };
                pooled?: {
                  host: string;
                  port: number;
                  connectionString: string;
                };
                accelerate?: {
                  host: string;
                  port: number;
                  connectionString: string;
                };
              };
              /**
               * @deprecated
               * @description Deprecated: use `endpoints.direct.connectionString` or `endpoints.pooled.connectionString` instead.
               */
              connectionString: string;
              /**
               * @deprecated
               * @description Deprecated: use `endpoints.direct` instead.
               */
              directConnection?: {
                host: string;
                pass: string;
                user: string;
              } | null;
              database: {
                id: string;
                /** Format: uri */
                url: string;
                name: string;
              };
              /**
               * @deprecated
               * @description Deprecated: use `endpoints.direct` instead.
               */
              host: string | null;
              /**
               * @deprecated
               * @description Deprecated: use `endpoints.direct.connectionString` or `endpoints.pooled.connectionString` instead.
               */
              pass: string | null;
              /**
               * @deprecated
               * @description Deprecated: use `endpoints.direct.connectionString` or `endpoints.pooled.connectionString` instead.
               */
              user: string | null;
            };
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Database with the given ID was not found. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  getV1ConnectionsById: {
    parameters: {
      query?: never;
      header?: never;
      path: {
        id: string;
      };
      cookie?: never;
    };
    requestBody?: never;
    responses: {
      /** @description Returned the connection. */
      200: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              id: string;
              /** @constant */
              type: "connection";
              /** Format: uri */
              url: string;
              name: string;
              /** Format: date-time */
              createdAt: string;
              /** @enum {string} */
              kind: "postgres" | "accelerate";
              endpoints: {
                direct?: {
                  host: string;
                  port: number;
                };
                pooled?: {
                  host: string;
                  port: number;
                };
                accelerate?: {
                  host: string;
                  port: number;
                };
              };
              /**
               * @deprecated
               * @description Deprecated: use `endpoints.direct` instead.
               */
              directConnection?: {
                host: string;
                pass: string;
                user: string;
              } | null;
              database: {
                id: string;
                /** Format: uri */
                url: string;
                name: string;
              };
            };
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Connection with the given ID was not found. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  deleteV1ConnectionsById: {
    parameters: {
      query?: never;
      header?: never;
      path: {
        id: string;
      };
      cookie?: never;
    };
    requestBody?: never;
    responses: {
      /** @description Deleted the connection. */
      204: {
        headers: {
          [name: string]: unknown;
        };
        content?: never;
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Connection with the given ID was not found. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  postV1ConnectionsByIdRotate: {
    parameters: {
      query?: never;
      header?: never;
      path: {
        id: string;
      };
      cookie?: never;
    };
    requestBody?: never;
    responses: {
      /** @description Rotated connection credentials. */
      200: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              id: string;
              /** @constant */
              type: "connection";
              /** Format: uri */
              url: string;
              name: string;
              /** Format: date-time */
              createdAt: string;
              /** @enum {string} */
              kind: "postgres" | "accelerate";
              endpoints: {
                direct?: {
                  host: string;
                  port: number;
                  connectionString: string;
                };
                pooled?: {
                  host: string;
                  port: number;
                  connectionString: string;
                };
                accelerate?: {
                  host: string;
                  port: number;
                  connectionString: string;
                };
              };
              /**
               * @deprecated
               * @description Deprecated: use `endpoints.direct.connectionString` or `endpoints.pooled.connectionString` instead.
               */
              connectionString: string;
              /**
               * @deprecated
               * @description Deprecated: use `endpoints.direct` instead.
               */
              directConnection?: {
                host: string;
                pass: string;
                user: string;
              } | null;
              database: {
                id: string;
                /** Format: uri */
                url: string;
                name: string;
              };
              /**
               * @deprecated
               * @description Deprecated: use `endpoints.direct` instead.
               */
              host: string | null;
              /**
               * @deprecated
               * @description Deprecated: use `endpoints.direct.connectionString` or `endpoints.pooled.connectionString` instead.
               */
              pass: string | null;
              /**
               * @deprecated
               * @description Deprecated: use `endpoints.direct.connectionString` or `endpoints.pooled.connectionString` instead.
               */
              user: string | null;
            };
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Connection with the given ID was not found. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  getV1Databases: {
    parameters: {
      query?: {
        cursor?: string | null;
        limit?: number;
        projectId?: string;
        logicalId?: string;
        branchId?: "unassigned" | string;
        branchGitName?: string;
      };
      header?: never;
      path?: never;
      cookie?: never;
    };
    requestBody?: never;
    responses: {
      /** @description Returns the list of databases. */
      200: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              id: string;
              /** @constant */
              type: "database";
              /** Format: uri */
              url: string;
              name: string;
              /** @enum {string} */
              status: "failure" | "provisioning" | "ready" | "recovering";
              /** Format: date-time */
              createdAt: string;
              isDefault: boolean;
              defaultConnectionId: string | null;
              connections: {
                id: string;
                /** @constant */
                type: "connection";
                /** Format: uri */
                url: string;
                name: string;
                /** Format: date-time */
                createdAt: string;
                /** @enum {string} */
                kind: "postgres" | "accelerate";
                endpoints: {
                  direct?: {
                    host: string;
                    port: number;
                  };
                  pooled?: {
                    host: string;
                    port: number;
                  };
                  accelerate?: {
                    host: string;
                    port: number;
                  };
                };
                /**
                 * @deprecated
                 * @description Deprecated: use `endpoints.direct` instead.
                 */
                directConnection?: {
                  host: string;
                  pass: string;
                  user: string;
                } | null;
                database: {
                  id: string;
                  /** Format: uri */
                  url: string;
                  name: string;
                };
              }[];
              project: {
                id: string;
                /** Format: uri */
                url: string;
                name: string;
              };
              region: {
                id: string;
                name: string;
              } | null;
              source: {
                /** @constant */
                type: "empty";
              } | {
                /** @constant */
                type: "backup";
                databaseId: string;
                /** @description ID of the backup to restore from */
                backupId: string;
              } | {
                /** @constant */
                type: "database";
                databaseId: string;
              } | null;
              branchId: string | null;
              logicalId: string | null;
            }[];
            pagination: {
              /** @description Next cursor to continue pagination */
              nextCursor: string | null;
              /** @description Whether there are more items to paginate */
              hasMore: boolean;
            };
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Actor does not have access to the requested databases. */
      403: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  postV1Databases: {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    requestBody?: {
      content: {
        "application/json": {
          /** @description ID of the project to create the database in */
          projectId: string;
          /**
           * @description Use "inherit" to use the project's default region (falls back to the default database's region for projects without one).
           * @default us-east-1
           * @enum {string}
           */
          region?: "us-east-1" | "us-west-1" | "eu-west-3" | "eu-central-1" | "ap-northeast-1" | "ap-southeast-1" | "inherit";
          /** @description Display name for the database */
          name?: string;
          /**
           * @description Whether this is the default database
           * @default false
           */
          isDefault?: boolean;
          /** @description Source to create the database from. Omit to create an empty database. */
          source?: {
            /** @constant */
            type: "empty";
          } | {
            /** @constant */
            type: "backup";
            /** @description ID of the database the backup belongs to */
            databaseId: string;
            /** @description ID of the backup to restore from */
            backupId: string;
          } | {
            /** @constant */
            type: "database";
            /** @description ID of the database to clone from */
            databaseId: string;
          };
          /** @description ID of the Branch to attach the database to. Omit to attach the database to the project's default Branch. Every database belongs to a Branch, so null is rejected. */
          branchId?: string | null;
          /** @description Git name of the Branch to attach the database to; the Branch is created when it does not exist. Mutually exclusive with branchId. Omit to attach to the project's default Branch. Every database belongs to a Branch, so null is rejected. */
          branchGitName?: string | null;
          /** @description Declared identity of the resource, unique within its branch. Set by the tool that declares the resource. */
          logicalId?: string;
        };
      };
    };
    responses: {
      /** @description Created a new database. */
      201: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              id: string;
              /** @constant */
              type: "database";
              /** Format: uri */
              url: string;
              name: string;
              /** @enum {string} */
              status: "failure" | "provisioning" | "ready" | "recovering";
              /** Format: date-time */
              createdAt: string;
              isDefault: boolean;
              defaultConnectionId: string | null;
              connections: {
                id: string;
                /** @constant */
                type: "connection";
                /** Format: uri */
                url: string;
                name: string;
                /** Format: date-time */
                createdAt: string;
                /** @enum {string} */
                kind: "postgres" | "accelerate";
                endpoints: {
                  direct?: {
                    host: string;
                    port: number;
                    connectionString?: string;
                  };
                  pooled?: {
                    host: string;
                    port: number;
                    connectionString?: string;
                  };
                  accelerate?: {
                    host: string;
                    port: number;
                    connectionString?: string;
                  };
                };
                /**
                 * @deprecated
                 * @description Deprecated: use `endpoints.direct` instead.
                 */
                directConnection?: {
                  host: string;
                  pass: string;
                  user: string;
                } | null;
                database: {
                  id: string;
                  /** Format: uri */
                  url: string;
                  name: string;
                };
              }[];
              project: {
                id: string;
                /** Format: uri */
                url: string;
                name: string;
              };
              region: {
                id: string;
                name: string;
              } | null;
              source: {
                /** @constant */
                type: "empty";
              } | {
                /** @constant */
                type: "backup";
                databaseId: string;
                /** @description ID of the backup to restore from */
                backupId: string;
              } | {
                /** @constant */
                type: "database";
                databaseId: string;
              } | null;
              branchId: string | null;
              logicalId: string | null;
            };
          };
        };
      };
      /** @description Invalid request parameters. */
      400: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Actor does not have access to the specified project. */
      403: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Project not found. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description A database with the same `logicalId` already exists on the branch. */
      409: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Request body exceeds this endpoint's size cap. */
      413: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  getV1DatabasesByDatabaseId: {
    parameters: {
      query?: never;
      header?: never;
      path: {
        databaseId: string;
      };
      cookie?: never;
    };
    requestBody?: never;
    responses: {
      /** @description Returned the database with the given ID. */
      200: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              id: string;
              /** @constant */
              type: "database";
              /** Format: uri */
              url: string;
              name: string;
              /** @enum {string} */
              status: "failure" | "provisioning" | "ready" | "recovering";
              /** Format: date-time */
              createdAt: string;
              isDefault: boolean;
              defaultConnectionId: string | null;
              connections: {
                id: string;
                /** @constant */
                type: "connection";
                /** Format: uri */
                url: string;
                name: string;
                /** Format: date-time */
                createdAt: string;
                /** @enum {string} */
                kind: "postgres" | "accelerate";
                endpoints: {
                  direct?: {
                    host: string;
                    port: number;
                  };
                  pooled?: {
                    host: string;
                    port: number;
                  };
                  accelerate?: {
                    host: string;
                    port: number;
                  };
                };
                /**
                 * @deprecated
                 * @description Deprecated: use `endpoints.direct` instead.
                 */
                directConnection?: {
                  host: string;
                  pass: string;
                  user: string;
                } | null;
                database: {
                  id: string;
                  /** Format: uri */
                  url: string;
                  name: string;
                };
              }[];
              project: {
                id: string;
                /** Format: uri */
                url: string;
                name: string;
              };
              region: {
                id: string;
                name: string;
              } | null;
              source: {
                /** @constant */
                type: "empty";
              } | {
                /** @constant */
                type: "backup";
                databaseId: string;
                /** @description ID of the backup to restore from */
                backupId: string;
              } | {
                /** @constant */
                type: "database";
                databaseId: string;
              } | null;
              branchId: string | null;
              logicalId: string | null;
            };
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Actor does not have access to the database. */
      403: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Database with the given ID was not found. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  deleteV1DatabasesByDatabaseId: {
    parameters: {
      query?: never;
      header?: never;
      path: {
        databaseId: string;
      };
      cookie?: never;
    };
    requestBody?: never;
    responses: {
      /** @description Deleted the database successfully. */
      204: {
        headers: {
          [name: string]: unknown;
        };
        content?: never;
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Cannot delete the default environment. */
      403: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Database with the given ID was not found. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  patchV1DatabasesByDatabaseId: {
    parameters: {
      query?: never;
      header?: never;
      path: {
        databaseId: string;
      };
      cookie?: never;
    };
    requestBody?: {
      content: {
        "application/json": {
          /** @description New display name for the database */
          name?: string;
          /** @description ID of the Branch to move the database to. Every database belongs to a Branch, so null (detach) is rejected. */
          branchId?: string | null;
          /** @description Git name of the Branch to move the database to; the Branch is created when it does not exist. Mutually exclusive with branchId. Every database belongs to a Branch, so null (detach) is rejected. */
          branchGitName?: string | null;
          /** @description Declared identity of the resource, unique within its branch. Set by the tool that declares the resource. */
          logicalId?: string;
        };
      };
    };
    responses: {
      /** @description Updated the database. */
      200: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              id: string;
              /** @constant */
              type: "database";
              /** Format: uri */
              url: string;
              name: string;
              /** @enum {string} */
              status: "failure" | "provisioning" | "ready" | "recovering";
              /** Format: date-time */
              createdAt: string;
              isDefault: boolean;
              defaultConnectionId: string | null;
              connections: {
                id: string;
                /** @constant */
                type: "connection";
                /** Format: uri */
                url: string;
                name: string;
                /** Format: date-time */
                createdAt: string;
                /** @enum {string} */
                kind: "postgres" | "accelerate";
                endpoints: {
                  direct?: {
                    host: string;
                    port: number;
                  };
                  pooled?: {
                    host: string;
                    port: number;
                  };
                  accelerate?: {
                    host: string;
                    port: number;
                  };
                };
                /**
                 * @deprecated
                 * @description Deprecated: use `endpoints.direct` instead.
                 */
                directConnection?: {
                  host: string;
                  pass: string;
                  user: string;
                } | null;
                database: {
                  id: string;
                  /** Format: uri */
                  url: string;
                  name: string;
                };
              }[];
              project: {
                id: string;
                /** Format: uri */
                url: string;
                name: string;
              };
              region: {
                id: string;
                name: string;
              } | null;
              source: {
                /** @constant */
                type: "empty";
              } | {
                /** @constant */
                type: "backup";
                databaseId: string;
                /** @description ID of the backup to restore from */
                backupId: string;
              } | {
                /** @constant */
                type: "database";
                databaseId: string;
              } | null;
              branchId: string | null;
              logicalId: string | null;
            };
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Actor does not have access to the database. */
      403: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Database with the given ID was not found. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description A database with the same `logicalId` already exists on the branch. */
      409: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Request body exceeds this endpoint's size cap. */
      413: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  getV1DatabasesByDatabaseIdConnections: {
    parameters: {
      query?: {
        cursor?: string | null;
        limit?: number;
      };
      header?: never;
      path: {
        databaseId: string;
      };
      cookie?: never;
    };
    requestBody?: never;
    responses: {
      /** @description Returned all connections for the given database. */
      200: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              id: string;
              /** @constant */
              type: "connection";
              /** Format: uri */
              url: string;
              name: string;
              /** Format: date-time */
              createdAt: string;
              /** @enum {string} */
              kind: "postgres" | "accelerate";
              endpoints: {
                direct?: {
                  host: string;
                  port: number;
                };
                pooled?: {
                  host: string;
                  port: number;
                };
                accelerate?: {
                  host: string;
                  port: number;
                };
              };
              /**
               * @deprecated
               * @description Deprecated: use `endpoints.direct` instead.
               */
              directConnection?: {
                host: string;
                pass: string;
                user: string;
              } | null;
              database: {
                id: string;
                /** Format: uri */
                url: string;
                name: string;
              };
            }[];
            pagination: {
              /** @description Next cursor to continue pagination */
              nextCursor: string | null;
              /** @description Whether there are more items to paginate */
              hasMore: boolean;
            };
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  postV1DatabasesByDatabaseIdConnections: {
    parameters: {
      query?: never;
      header?: never;
      path: {
        databaseId: string;
      };
      cookie?: never;
    };
    requestBody?: {
      content: {
        "application/json": {
          name: string;
        };
      };
    };
    responses: {
      /** @description Created a new connection string for the database. */
      200: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              id: string;
              /** @constant */
              type: "connection";
              /** Format: uri */
              url: string;
              name: string;
              /** Format: date-time */
              createdAt: string;
              /** @enum {string} */
              kind: "postgres" | "accelerate";
              endpoints: {
                direct?: {
                  host: string;
                  port: number;
                  connectionString: string;
                };
                pooled?: {
                  host: string;
                  port: number;
                  connectionString: string;
                };
                accelerate?: {
                  host: string;
                  port: number;
                  connectionString: string;
                };
              };
              /**
               * @deprecated
               * @description Deprecated: use `endpoints.direct.connectionString` or `endpoints.pooled.connectionString` instead.
               */
              connectionString: string;
              /**
               * @deprecated
               * @description Deprecated: use `endpoints.direct` instead.
               */
              directConnection?: {
                host: string;
                pass: string;
                user: string;
              } | null;
              database: {
                id: string;
                /** Format: uri */
                url: string;
                name: string;
              };
              /**
               * @deprecated
               * @description Deprecated: use `endpoints.direct` instead.
               */
              host: string | null;
              /**
               * @deprecated
               * @description Deprecated: use `endpoints.direct.connectionString` or `endpoints.pooled.connectionString` instead.
               */
              pass: string | null;
              /**
               * @deprecated
               * @description Deprecated: use `endpoints.direct.connectionString` or `endpoints.pooled.connectionString` instead.
               */
              user: string | null;
            };
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Database with the given ID was not found. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  getV1DatabasesByDatabaseIdBackups: {
    parameters: {
      query?: {
        limit?: number;
      };
      header?: never;
      path: {
        databaseId: string;
      };
      cookie?: never;
    };
    requestBody?: never;
    responses: {
      /** @description Returned backups for the given database. */
      200: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              id: string;
              /** @enum {string} */
              backupType: "full" | "incremental" | "differential";
              createdAt: string;
              size?: number;
              /** @enum {string} */
              status: "running" | "completed" | "failed" | "unknown";
              /** @constant */
              type?: "backup";
            }[];
            meta: {
              backupRetentionDays: number;
            };
            pagination: {
              hasMore: boolean;
              limit: number | null;
            };
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Database with the given ID was not found. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Remote database backups are not supported */
      422: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  postV1DatabasesByTargetDatabaseIdRestore: {
    parameters: {
      query?: never;
      header?: never;
      path: {
        targetDatabaseId: string;
      };
      cookie?: never;
    };
    requestBody?: {
      content: {
        "application/json": {
          source: {
            /** @constant */
            type: "backup";
            /** @description ID of the database the backup belongs to */
            databaseId: string;
            /** @description ID of the backup to restore from */
            backupId: string;
          };
        };
      };
    };
    responses: {
      /** @description Database restore initiated. The database status will be "recovering" until the restore completes. */
      200: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              id: string;
              /** @constant */
              type: "database";
              /** Format: uri */
              url: string;
              name: string;
              /** @enum {string} */
              status: "failure" | "provisioning" | "ready" | "recovering";
              /** Format: date-time */
              createdAt: string;
              isDefault: boolean;
              defaultConnectionId: string | null;
              connections: {
                id: string;
                /** @constant */
                type: "connection";
                /** Format: uri */
                url: string;
                name: string;
                /** Format: date-time */
                createdAt: string;
                /** @enum {string} */
                kind: "postgres" | "accelerate";
                endpoints: {
                  direct?: {
                    host: string;
                    port: number;
                  };
                  pooled?: {
                    host: string;
                    port: number;
                  };
                  accelerate?: {
                    host: string;
                    port: number;
                  };
                };
                /**
                 * @deprecated
                 * @description Deprecated: use `endpoints.direct` instead.
                 */
                directConnection?: {
                  host: string;
                  pass: string;
                  user: string;
                } | null;
                database: {
                  id: string;
                  /** Format: uri */
                  url: string;
                  name: string;
                };
              }[];
              project: {
                id: string;
                /** Format: uri */
                url: string;
                name: string;
              };
              region: {
                id: string;
                name: string;
              } | null;
              source: {
                /** @constant */
                type: "backup";
                databaseId: string;
                backupId: string;
              };
              branchId: string | null;
              logicalId: string | null;
            };
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Target database, source database, or backup not found. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Target database is currently provisioning or recovering and cannot be restored. */
      409: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Invalid source type or backup not usable. */
      422: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  getV1DatabasesByDatabaseIdUsage: {
    parameters: {
      query?: {
        startDate?: string;
        endDate?: string;
      };
      header?: never;
      path: {
        databaseId: string;
      };
      cookie?: never;
    };
    requestBody?: never;
    responses: {
      /** @description Returned usage metrics for the given database. */
      200: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            period: {
              /** Format: date-time */
              start: string;
              /** Format: date-time */
              end: string;
            };
            metrics: {
              operations: {
                used: number;
                /** @constant */
                unit: "ops";
              };
              storage: {
                used: number;
                /** @constant */
                unit: "GiB";
              };
            };
            /** Format: date-time */
            generatedAt: string;
          };
        };
      };
      /** @description Invalid request parameters */
      400: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Database with the given ID was not found. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Error occurred while fetching metrics */
      500: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Usage metrics are temporarily unavailable */
      503: {
        headers: {
          /** @description Seconds to wait before retrying the request */
          "Retry-After"?: number;
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  getV1DeploymentsByDeploymentId: {
    parameters: {
      query?: never;
      header?: never;
      path: {
        deploymentId: string;
      };
      cookie?: never;
    };
    requestBody?: never;
    responses: {
      /** @description Deployment retrieved. */
      200: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              id: string;
              /** @constant */
              type: "deployment";
              /** Format: uri */
              url: string;
              serviceId: string;
              foundryVersionId: string;
              status: string;
              previewDomain: string | null;
              /** @description Environment variable names present on this compute version. Values are always redacted as "[redacted]" and must not be treated as deployed secret values. */
              envVars?: {
                [key: string]: string;
              };
              portMapping?: {
                http?: number;
              };
              /** Format: date-time */
              createdAt: string;
            };
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Insufficient permissions to access this resource. */
      403: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Deployment not found. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Rate limit exceeded. */
      429: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  deleteV1DeploymentsByDeploymentId: {
    parameters: {
      query?: never;
      header?: never;
      path: {
        deploymentId: string;
      };
      cookie?: never;
    };
    requestBody?: never;
    responses: {
      /** @description Deployment deleted. */
      204: {
        headers: {
          [name: string]: unknown;
        };
        content?: never;
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Insufficient permissions to access this resource. */
      403: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Deployment not found. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description The deployment must be stopped before it can be deleted. */
      409: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Rate limit exceeded. */
      429: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  postV1DeploymentsByDeploymentIdStart: {
    parameters: {
      query?: never;
      header?: never;
      path: {
        deploymentId: string;
      };
      cookie?: never;
    };
    requestBody?: never;
    responses: {
      /** @description Start request accepted. The preview domain is returned immediately. */
      200: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              previewDomain: string;
            };
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Insufficient permissions to access this resource. */
      403: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Deployment not found. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description The deployment is in a state that does not allow starting (e.g. artifact not uploaded, or already running). */
      409: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Rate limit or Compute resource limit exceeded. */
      429: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  postV1DeploymentsByDeploymentIdStop: {
    parameters: {
      query?: never;
      header?: never;
      path: {
        deploymentId: string;
      };
      cookie?: never;
    };
    requestBody?: never;
    responses: {
      /** @description Stop request accepted. */
      204: {
        headers: {
          [name: string]: unknown;
        };
        content?: never;
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Insufficient permissions to access this resource. */
      403: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Deployment not found. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description The deployment must be running or provisioning to be stopped. */
      409: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Rate limit exceeded. */
      429: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  getV1DeploymentsByDeploymentIdLogs: {
    parameters: {
      query?: {
        tail?: number;
        from_start?: "true" | "false";
        cursor?: string;
      };
      header?: never;
      path: {
        deploymentId: string;
      };
      cookie?: never;
    };
    requestBody?: never;
    responses: {
      /** @description WebSocket connection established (requests with an `Upgrade: websocket` header). Each message is a JSON object discriminated by `type`. */
      101: {
        headers: {
          [name: string]: unknown;
        };
        content?: never;
      };
      /** @description One page of deployment logs (newline-delimited JSON; one record per line, ending with a terminal record). */
      200: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/x-ndjson": {
            /** @constant */
            type: "log";
            text: string;
            byteStart: number;
            byteEnd: number;
          } | {
            /** @constant */
            type: "terminal";
            /** @enum {string} */
            kind: "end" | "error";
            code: string;
            message: string;
            retryable: boolean;
            cursor: string | null;
            details?: {
              [key: string]: unknown;
            };
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Insufficient permissions. */
      403: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Deployment not found. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Rate limit exceeded. */
      429: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  getV1Projects: {
    parameters: {
      query?: {
        cursor?: string | null;
        limit?: number;
        logicalId?: string;
      };
      header?: never;
      path?: never;
      cookie?: never;
    };
    requestBody?: never;
    responses: {
      /** @description Returns the list of projects. */
      200: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              id: string;
              /** @constant */
              type: "project";
              /** Format: uri */
              url: string;
              name: string;
              logicalId: string | null;
              /** Format: date-time */
              createdAt: string;
              defaultRegion: string | null;
              workspace: {
                id: string;
                /** Format: uri */
                url: string;
                name: string;
              };
            }[];
            pagination: {
              /** @description Next cursor to continue pagination */
              nextCursor: string | null;
              /** @description Whether there are more items to paginate */
              hasMore: boolean;
            };
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  postV1Projects: {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    requestBody?: {
      content: {
        "application/json": {
          /** @default true */
          createDatabase?: boolean;
          name?: string;
          /** @enum {string} */
          region?: "us-east-1" | "us-west-1" | "eu-west-3" | "eu-central-1" | "ap-northeast-1" | "ap-southeast-1";
          logicalId?: string;
          workspaceId?: string;
        };
      };
    };
    responses: {
      /** @description New project created. */
      201: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              id: string;
              /** @constant */
              type: "project";
              /** Format: uri */
              url: string;
              name: string;
              logicalId: string | null;
              /** Format: date-time */
              createdAt: string;
              defaultRegion: string | null;
              workspace: {
                id: string;
                /** Format: uri */
                url: string;
                name: string;
              };
              database: {
                id: string;
                /** @constant */
                type: "database";
                /** Format: uri */
                url: string;
                name: string;
                /** @enum {string} */
                status: "provisioning" | "ready";
                /** Format: date-time */
                createdAt: string;
                isDefault: boolean;
                defaultConnectionId: string | null;
                connections: {
                  id: string;
                  /** @constant */
                  type: "connection";
                  /** Format: uri */
                  url: string;
                  name: string;
                  /** Format: date-time */
                  createdAt: string;
                  /** @enum {string} */
                  kind: "postgres" | "accelerate";
                  endpoints: {
                    direct?: {
                      host: string;
                      port: number;
                      connectionString?: string;
                    };
                    pooled?: {
                      host: string;
                      port: number;
                      connectionString?: string;
                    };
                    accelerate?: {
                      host: string;
                      port: number;
                      connectionString?: string;
                    };
                  };
                  /**
                   * @deprecated
                   * @description Deprecated: use `endpoints.direct` instead.
                   */
                  directConnection?: {
                    host: string;
                    pass: string;
                    user: string;
                  } | null;
                  database: {
                    id: string;
                    /** Format: uri */
                    url: string;
                    name: string;
                  };
                }[];
                region: {
                  id: string;
                  name: string;
                };
                source: {
                  /** @constant */
                  type: "empty";
                } | {
                  /** @constant */
                  type: "backup";
                  databaseId: string;
                  /** @description ID of the backup to restore from */
                  backupId: string;
                } | {
                  /** @constant */
                  type: "database";
                  databaseId: string;
                } | null;
                branchId: string | null;
                logicalId: string | null;
                /**
                 * @deprecated
                 * @description Deprecated: use `connections[]` instead.
                 */
                apiKeys: {
                  id: string;
                  /** @constant */
                  type: "connection";
                  /** Format: uri */
                  url: string;
                  name: string;
                  /** Format: date-time */
                  createdAt: string;
                  /** @enum {string} */
                  kind: "postgres" | "accelerate";
                  endpoints: {
                    direct?: {
                      host: string;
                      port: number;
                    };
                    pooled?: {
                      host: string;
                      port: number;
                    };
                    accelerate?: {
                      host: string;
                      port: number;
                    };
                  };
                  /**
                   * @deprecated
                   * @description Deprecated: use `endpoints.direct.connectionString` or `endpoints.pooled.connectionString` instead.
                   */
                  connectionString: string;
                  /**
                   * @deprecated
                   * @description Deprecated: use `endpoints.direct` instead.
                   */
                  directConnection?: {
                    host: string;
                    pass: string;
                    user: string;
                  } | null;
                }[];
                /**
                 * @deprecated
                 * @description Deprecated: use `connections[].endpoints.direct.connectionString` or `connections[].endpoints.pooled.connectionString`.
                 */
                connectionString: string | null;
                /**
                 * @deprecated
                 * @description Deprecated: use `connections[].endpoints.direct` instead.
                 */
                directConnection: {
                  host: string;
                  pass: string;
                  user: string;
                } | null;
              } | null;
            };
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description A project with the same `logicalId` already exists in the workspace. */
      409: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Request body exceeds this endpoint's size cap. */
      413: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  getV1ProjectsById: {
    parameters: {
      query?: never;
      header?: never;
      path: {
        id: string;
      };
      cookie?: never;
    };
    requestBody?: never;
    responses: {
      /** @description Project retrieved. */
      200: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              id: string;
              /** @constant */
              type: "project";
              /** Format: uri */
              url: string;
              name: string;
              logicalId: string | null;
              /** Format: date-time */
              createdAt: string;
              defaultRegion: string | null;
              workspace: {
                id: string;
                /** Format: uri */
                url: string;
                name: string;
              };
            };
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Project with the specified ID was not found. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  deleteV1ProjectsById: {
    parameters: {
      query?: never;
      header?: never;
      path: {
        id: string;
      };
      cookie?: never;
    };
    requestBody?: never;
    responses: {
      /** @description Project deleted. */
      204: {
        headers: {
          [name: string]: unknown;
        };
        content?: never;
      };
      /** @description Project cannot be deleted due to existing dependencies. */
      400: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Unauthorized */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Project with the specified ID was not found */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  patchV1ProjectsById: {
    parameters: {
      query?: never;
      header?: never;
      path: {
        id: string;
      };
      cookie?: never;
    };
    requestBody?: {
      content: {
        "application/json": {
          name?: string;
          settings?: {
            [key: string]: unknown;
          };
        };
      };
    };
    responses: {
      /** @description Project updated. */
      200: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              id: string;
              /** @constant */
              type: "project";
              /** Format: uri */
              url: string;
              name: string;
              logicalId: string | null;
              /** Format: date-time */
              createdAt: string;
              defaultRegion: string | null;
              workspace: {
                id: string;
                /** Format: uri */
                url: string;
                name: string;
              };
            };
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Actor does not have access to the project. */
      403: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Project with the specified ID was not found. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Request body exceeds this endpoint's size cap. */
      413: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Validation failed. */
      422: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  postV1ProjectsByIdTransfer: {
    parameters: {
      query?: never;
      header?: never;
      path: {
        id: string;
      };
      cookie?: never;
    };
    requestBody?: {
      content: {
        "application/json": {
          recipientAccessToken: string;
        };
      };
    };
    responses: {
      /** @description Project transferred */
      204: {
        headers: {
          [name: string]: unknown;
        };
        content?: never;
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Project with the given ID was not found. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description The project cannot be transferred in its current state. */
      409: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Request body exceeds this endpoint's size cap. */
      413: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  "postV1ProjectsByProjectIdBranchesByBranchIdAlchemy-stateLease": {
    parameters: {
      query?: never;
      header?: never;
      path: {
        projectId: string;
        branchId: string;
      };
      cookie?: never;
    };
    requestBody?: {
      content: {
        "application/json": {
          /** @description Alchemy stack name (opaque wire value). */
          stack: string;
          /** @description Alchemy stage name (opaque wire value). */
          stage: string;
          /** @description Requested lease TTL in seconds. Default 60, clamped to [30, 300]. */
          ttlSeconds?: number;
          /** @description Free-form description of the acquiring deploy, echoed in the contention error so a blocked deploy can name who holds the lease. */
          holderDescription?: string;
        };
      };
    };
    responses: {
      /** @description Acquired the deploy lease. */
      201: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              /** @description Capability token for the deploy lease. Send it in the Alchemy-State-Lease-Id header with every state operation; do not log it. */
              leaseId: string;
              /** @description Lease expiry as an ISO-8601 timestamp. */
              expiresAt: string;
            };
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Project or branch not found. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description The deploy lease is held by another deploy. */
      409: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Request body exceeds this endpoint's size cap. */
      413: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  "deleteV1ProjectsByProjectIdBranchesByBranchIdAlchemy-stateLease": {
    parameters: {
      query?: never;
      header: {
        "alchemy-state-lease-id": string;
      };
      path: {
        projectId: string;
        branchId: string;
      };
      cookie?: never;
    };
    requestBody?: never;
    responses: {
      /** @description Released the deploy lease. */
      204: {
        headers: {
          [name: string]: unknown;
        };
        content?: never;
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Project, branch, or unexpired lease not found. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Request body exceeds this endpoint's size cap. */
      413: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  "patchV1ProjectsByProjectIdBranchesByBranchIdAlchemy-stateLease": {
    parameters: {
      query?: never;
      header: {
        "alchemy-state-lease-id": string;
      };
      path: {
        projectId: string;
        branchId: string;
      };
      cookie?: never;
    };
    requestBody?: {
      content: {
        "application/json": {
          /** @description Requested lease TTL in seconds. Default 60, clamped to [30, 300]. */
          ttlSeconds?: number;
        };
      };
    };
    responses: {
      /** @description Extended the deploy lease. */
      200: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              /** @description Capability token for the deploy lease. Send it in the Alchemy-State-Lease-Id header with every state operation; do not log it. */
              leaseId: string;
              /** @description Lease expiry as an ISO-8601 timestamp. */
              expiresAt: string;
            };
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Project, branch, or unexpired lease not found. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Request body exceeds this endpoint's size cap. */
      413: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  "getV1ProjectsByProjectIdBranchesByBranchIdAlchemy-stateVersion": {
    parameters: {
      query?: never;
      header?: never;
      path: {
        projectId: string;
        branchId: string;
      };
      cookie?: never;
    };
    requestBody?: never;
    responses: {
      /** @description The state-store contract version. */
      200: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            version: number;
          };
        };
      };
    };
  };
  "getV1ProjectsByProjectIdBranchesByBranchIdAlchemy-stateStateStacks": {
    parameters: {
      query?: never;
      header?: never;
      path: {
        projectId: string;
        branchId: string;
      };
      cookie?: never;
    };
    requestBody?: never;
    responses: {
      /** @description Stack names, sorted. */
      200: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": string[];
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Project or branch not found. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description No live deploy lease held for this stack and stage. */
      409: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Request body exceeds this endpoint's size cap. */
      413: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  "getV1ProjectsByProjectIdBranchesByBranchIdAlchemy-stateStateStacksByStackStages": {
    parameters: {
      query?: never;
      header: {
        "alchemy-state-lease-id": string;
      };
      path: {
        projectId: string;
        branchId: string;
        stack: string;
      };
      cookie?: never;
    };
    requestBody?: never;
    responses: {
      /** @description Stage names, sorted. */
      200: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": string[];
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Project or branch not found. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description No live deploy lease held for this stack and stage. */
      409: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Request body exceeds this endpoint's size cap. */
      413: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  "getV1ProjectsByProjectIdBranchesByBranchIdAlchemy-stateStateStacksByStackStagesByStageResources": {
    parameters: {
      query?: never;
      header: {
        "alchemy-state-lease-id": string;
      };
      path: {
        projectId: string;
        branchId: string;
        stack: string;
        stage: string;
      };
      cookie?: never;
    };
    requestBody?: never;
    responses: {
      /** @description Resource FQNs, ordered. */
      200: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": string[];
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Project or branch not found. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description No live deploy lease held for this stack and stage. */
      409: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Request body exceeds this endpoint's size cap. */
      413: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  "getV1ProjectsByProjectIdBranchesByBranchIdAlchemy-stateStateStacksByStackStagesByStageResourcesByFqn": {
    parameters: {
      query?: never;
      header: {
        "alchemy-state-lease-id": string;
      };
      path: {
        projectId: string;
        branchId: string;
        stack: string;
        stage: string;
        fqn: string;
      };
      cookie?: never;
    };
    requestBody?: never;
    responses: {
      /** @description The stored value, or null when absent. */
      200: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": unknown;
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Project or branch not found. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description No live deploy lease held for this stack and stage. */
      409: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Request body exceeds this endpoint's size cap. */
      413: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  "putV1ProjectsByProjectIdBranchesByBranchIdAlchemy-stateStateStacksByStackStagesByStageResourcesByFqn": {
    parameters: {
      query?: never;
      header: {
        "alchemy-state-lease-id": string;
      };
      path: {
        projectId: string;
        branchId: string;
        stack: string;
        stage: string;
        fqn: string;
      };
      cookie?: never;
    };
    requestBody?: {
      content: {
        "application/json": unknown;
      };
    };
    responses: {
      /** @description Echo of the stored value. */
      200: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": unknown;
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Project or branch not found. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description No live deploy lease held for this stack and stage. */
      409: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Request body exceeds this endpoint's size cap. */
      413: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  "deleteV1ProjectsByProjectIdBranchesByBranchIdAlchemy-stateStateStacksByStackStagesByStageResourcesByFqn": {
    parameters: {
      query?: never;
      header: {
        "alchemy-state-lease-id": string;
      };
      path: {
        projectId: string;
        branchId: string;
        stack: string;
        stage: string;
        fqn: string;
      };
      cookie?: never;
    };
    requestBody?: never;
    responses: {
      /** @description Deleted (or already absent). */
      204: {
        headers: {
          [name: string]: unknown;
        };
        content?: never;
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Project or branch not found. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description No live deploy lease held for this stack and stage. */
      409: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Request body exceeds this endpoint's size cap. */
      413: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  "getV1ProjectsByProjectIdBranchesByBranchIdAlchemy-stateStateStacksByStackStagesByStageReplaced-resources": {
    parameters: {
      query?: never;
      header: {
        "alchemy-state-lease-id": string;
      };
      path: {
        projectId: string;
        branchId: string;
        stack: string;
        stage: string;
      };
      cookie?: never;
    };
    requestBody?: never;
    responses: {
      /** @description Replaced resource states. */
      200: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": unknown[];
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Project or branch not found. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description No live deploy lease held for this stack and stage. */
      409: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Request body exceeds this endpoint's size cap. */
      413: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  "getV1ProjectsByProjectIdBranchesByBranchIdAlchemy-stateStateStacksByStackStagesByStageOutput": {
    parameters: {
      query?: never;
      header: {
        "alchemy-state-lease-id": string;
      };
      path: {
        projectId: string;
        branchId: string;
        stack: string;
        stage: string;
      };
      cookie?: never;
    };
    requestBody?: never;
    responses: {
      /** @description The stored output, or null when absent. */
      200: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": unknown;
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Project or branch not found. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description No live deploy lease held for this stack and stage. */
      409: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Request body exceeds this endpoint's size cap. */
      413: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  "putV1ProjectsByProjectIdBranchesByBranchIdAlchemy-stateStateStacksByStackStagesByStageOutput": {
    parameters: {
      query?: never;
      header: {
        "alchemy-state-lease-id": string;
      };
      path: {
        projectId: string;
        branchId: string;
        stack: string;
        stage: string;
      };
      cookie?: never;
    };
    requestBody?: {
      content: {
        "application/json": unknown;
      };
    };
    responses: {
      /** @description Echo of the stored value. */
      200: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": unknown;
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Project or branch not found. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description No live deploy lease held for this stack and stage. */
      409: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Request body exceeds this endpoint's size cap. */
      413: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  "deleteV1ProjectsByProjectIdBranchesByBranchIdAlchemy-stateStateStacksByStack": {
    parameters: {
      query?: {
        stage?: string;
      };
      header: {
        "alchemy-state-lease-id": string;
      };
      path: {
        projectId: string;
        branchId: string;
        stack: string;
      };
      cookie?: never;
    };
    requestBody?: never;
    responses: {
      /** @description Deleted (or already absent). */
      204: {
        headers: {
          [name: string]: unknown;
        };
        content?: never;
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Project or branch not found. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description No live deploy lease held for this stack and stage. */
      409: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Request body exceeds this endpoint's size cap. */
      413: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  "getV1ProjectsByProjectIdBranchesByBranchIdApplication-topology": {
    parameters: {
      query?: never;
      header?: never;
      path: {
        projectId: string;
        branchId: string;
      };
      cookie?: never;
    };
    requestBody?: never;
    responses: {
      /** @description The branch topology. */
      200: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              nodes: {
                logicalId: string;
                parentLogicalId: string | null;
                /** @enum {string} */
                kind: "module" | "service" | "resource";
                type?: string;
              }[];
              ports: {
                logicalId: string;
                /** @enum {string} */
                direction: "in" | "out";
                name: string;
                contractKind?: string;
                contractHash?: string;
              }[];
              edges: {
                from: {
                  logicalId: string;
                  /** @enum {string} */
                  direction: "in" | "out";
                  name: string;
                };
                to: {
                  logicalId: string;
                  /** @enum {string} */
                  direction: "in" | "out";
                  name: string;
                };
                /** @enum {string} */
                family: "communication" | "data";
                style?: string;
              }[];
              contentHash?: string;
              /** Format: date-time */
              writtenAt?: string;
            };
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Project or branch not found. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  "putV1ProjectsByProjectIdBranchesByBranchIdApplication-topology": {
    parameters: {
      query?: never;
      header?: never;
      path: {
        projectId: string;
        branchId: string;
      };
      cookie?: never;
    };
    requestBody?: {
      content: {
        "application/json": {
          contentHash?: string;
          nodes: {
            logicalId: string;
            parentLogicalId: string | null;
            /** @enum {string} */
            kind: "module" | "service" | "resource";
            type?: string;
          }[];
          ports: {
            logicalId: string;
            /** @enum {string} */
            direction: "in" | "out";
            name: string;
            contractKind?: string;
            contractHash?: string;
          }[];
          edges: {
            from: {
              logicalId: string;
              /** @enum {string} */
              direction: "in" | "out";
              name: string;
            };
            to: {
              logicalId: string;
              /** @enum {string} */
              direction: "in" | "out";
              name: string;
            };
            /** @enum {string} */
            family: "communication" | "data";
            style?: string;
          }[];
        };
      };
    };
    responses: {
      /** @description ApplicationTopology replaced. */
      200: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              nodes: {
                logicalId: string;
                parentLogicalId: string | null;
                /** @enum {string} */
                kind: "module" | "service" | "resource";
                type?: string;
              }[];
              ports: {
                logicalId: string;
                /** @enum {string} */
                direction: "in" | "out";
                name: string;
                contractKind?: string;
                contractHash?: string;
              }[];
              edges: {
                from: {
                  logicalId: string;
                  /** @enum {string} */
                  direction: "in" | "out";
                  name: string;
                };
                to: {
                  logicalId: string;
                  /** @enum {string} */
                  direction: "in" | "out";
                  name: string;
                };
                /** @enum {string} */
                family: "communication" | "data";
                style?: string;
              }[];
              contentHash?: string;
              /** Format: date-time */
              writtenAt?: string;
            };
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Project or branch not found. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Request body exceeds this endpoint's size cap. */
      413: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Invalid topology shape. */
      422: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  getV1ProjectsByProjectIdDatabases: {
    parameters: {
      query?: {
        cursor?: string | null;
        limit?: number;
      };
      header?: never;
      path: {
        projectId: string;
      };
      cookie?: never;
    };
    requestBody?: never;
    responses: {
      /** @description Returned the databases for the given project ID. */
      200: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              id: string;
              /** @constant */
              type: "database";
              /** Format: uri */
              url: string;
              name: string;
              /** @enum {string} */
              status: "failure" | "provisioning" | "ready" | "recovering";
              /** Format: date-time */
              createdAt: string;
              isDefault: boolean;
              defaultConnectionId: string | null;
              connections: {
                id: string;
                /** @constant */
                type: "connection";
                /** Format: uri */
                url: string;
                name: string;
                /** Format: date-time */
                createdAt: string;
                /** @enum {string} */
                kind: "postgres" | "accelerate";
                endpoints: {
                  direct?: {
                    host: string;
                    port: number;
                  };
                  pooled?: {
                    host: string;
                    port: number;
                  };
                  accelerate?: {
                    host: string;
                    port: number;
                  };
                };
                /**
                 * @deprecated
                 * @description Deprecated: use `endpoints.direct` instead.
                 */
                directConnection?: {
                  host: string;
                  pass: string;
                  user: string;
                } | null;
                database: {
                  id: string;
                  /** Format: uri */
                  url: string;
                  name: string;
                };
              }[];
              project: {
                id: string;
                /** Format: uri */
                url: string;
                name: string;
              };
              region: {
                id: string;
                name: string;
              } | null;
              source: {
                /** @constant */
                type: "empty";
              } | {
                /** @constant */
                type: "backup";
                databaseId: string;
                /** @description ID of the backup to restore from */
                backupId: string;
              } | {
                /** @constant */
                type: "database";
                databaseId: string;
              } | null;
              branchId: string | null;
              logicalId: string | null;
            }[];
            pagination: {
              /** @description Next cursor to continue pagination */
              nextCursor: string | null;
              /** @description Whether there are more items to paginate */
              hasMore: boolean;
            };
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Project with the given ID was not found. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  postV1ProjectsByProjectIdDatabases: {
    parameters: {
      query?: never;
      header?: never;
      path: {
        projectId: string;
      };
      cookie?: never;
    };
    requestBody?: {
      content: {
        "application/json": {
          /**
           * @description Use "inherit" to use the project's default region (falls back to the default database's region for projects without one).
           * @default us-east-1
           * @enum {string}
           */
          region?: "us-east-1" | "us-west-1" | "eu-west-3" | "eu-central-1" | "ap-northeast-1" | "ap-southeast-1" | "inherit";
          name?: string;
          /** @default false */
          isDefault?: boolean;
          /**
           * @deprecated
           * @description Deprecated: use `source` instead.
           */
          fromDatabase?: {
            id: string;
            backupId?: string;
          };
          source?: {
            /** @constant */
            type: "empty";
          } | {
            /** @constant */
            type: "backup";
            /** @description ID of the database the backup belongs to */
            databaseId: string;
            /** @description ID of the backup to restore from */
            backupId: string;
          } | {
            /** @constant */
            type: "database";
            /** @description ID of the database to clone from */
            databaseId: string;
          };
        };
      };
    };
    responses: {
      /** @description Created a new database for the project. */
      201: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              id: string;
              /** @constant */
              type: "database";
              /** Format: uri */
              url: string;
              name: string;
              /** @enum {string} */
              status: "provisioning" | "ready";
              /** Format: date-time */
              createdAt: string;
              isDefault: boolean;
              defaultConnectionId: string | null;
              connections: {
                id: string;
                /** @constant */
                type: "connection";
                /** Format: uri */
                url: string;
                name: string;
                /** Format: date-time */
                createdAt: string;
                /** @enum {string} */
                kind: "postgres" | "accelerate";
                endpoints: {
                  direct?: {
                    host: string;
                    port: number;
                    connectionString?: string;
                  };
                  pooled?: {
                    host: string;
                    port: number;
                    connectionString?: string;
                  };
                  accelerate?: {
                    host: string;
                    port: number;
                    connectionString?: string;
                  };
                };
                /**
                 * @deprecated
                 * @description Deprecated: use `endpoints.direct` instead.
                 */
                directConnection?: {
                  host: string;
                  pass: string;
                  user: string;
                } | null;
                database: {
                  id: string;
                  /** Format: uri */
                  url: string;
                  name: string;
                };
              }[];
              project: {
                id: string;
                /** Format: uri */
                url: string;
                name: string;
              };
              region: {
                id: string;
                name: string;
              };
              source: {
                /** @constant */
                type: "empty";
              } | {
                /** @constant */
                type: "backup";
                databaseId: string;
                /** @description ID of the backup to restore from */
                backupId: string;
              } | {
                /** @constant */
                type: "database";
                databaseId: string;
              } | null;
              branchId: string | null;
              logicalId: string | null;
              /**
               * @deprecated
               * @description Deprecated: use `connections[]` instead.
               */
              apiKeys: {
                id: string;
                /** @constant */
                type: "connection";
                /** Format: uri */
                url: string;
                name: string;
                /** Format: date-time */
                createdAt: string;
                /** @enum {string} */
                kind: "postgres" | "accelerate";
                endpoints: {
                  direct?: {
                    host: string;
                    port: number;
                  };
                  pooled?: {
                    host: string;
                    port: number;
                  };
                  accelerate?: {
                    host: string;
                    port: number;
                  };
                };
                /**
                 * @deprecated
                 * @description Deprecated: use `endpoints.direct.connectionString` or `endpoints.pooled.connectionString` instead.
                 */
                connectionString: string;
                /**
                 * @deprecated
                 * @description Deprecated: use `endpoints.direct` instead.
                 */
                directConnection?: {
                  host: string;
                  pass: string;
                  user: string;
                } | null;
              }[];
              /**
               * @deprecated
               * @description Deprecated: use `connections[].endpoints.direct.connectionString` or `connections[].endpoints.pooled.connectionString`.
               */
              connectionString: string | null;
              /**
               * @deprecated
               * @description Deprecated: use `connections[].endpoints.direct` instead.
               */
              directConnection: {
                host: string;
                pass: string;
                user: string;
              } | null;
            };
          };
        };
      };
      /** @description The request is invalid due to missing or invalid parameters. */
      400: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description The actor or agent permission policy does not allow database creation. */
      403: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Project with the given ID was not found. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Request body exceeds this endpoint's size cap. */
      413: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  "getV1Environment-variables": {
    parameters: {
      query?: {
        cursor?: string | null;
        limit?: number;
        projectId?: string;
        class?: "production" | "preview";
        key?: string;
        branchId?: string;
      };
      header?: never;
      path?: never;
      cookie?: never;
    };
    requestBody?: never;
    responses: {
      /** @description Returned the page of environment variables. */
      200: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              id: string;
              /** @constant */
              type: "environment-variable";
              /** Format: uri */
              url: string;
              projectId: string;
              branchId: string | null;
              /** @enum {string} */
              class: "production" | "preview";
              key: string;
              valueKid: string;
              isManagedBySystem: boolean;
              /** Format: date-time */
              createdAt: string;
              /** Format: date-time */
              updatedAt: string;
            }[];
            pagination: {
              /** @description Next cursor to continue pagination */
              nextCursor: string | null;
              /** @description Whether there are more items to paginate */
              hasMore: boolean;
            };
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Invalid request. */
      422: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  "postV1Environment-variables": {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    requestBody?: {
      content: {
        "application/json": {
          projectId: string;
          branchId?: string;
          /** @enum {string} */
          class: "production" | "preview";
          key: string;
          value: string;
        };
      };
    };
    responses: {
      /** @description Variable created. */
      201: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              id: string;
              /** @constant */
              type: "environment-variable";
              /** Format: uri */
              url: string;
              projectId: string;
              branchId: string | null;
              /** @enum {string} */
              class: "production" | "preview";
              key: string;
              valueKid: string;
              isManagedBySystem: boolean;
              /** Format: date-time */
              createdAt: string;
              /** Format: date-time */
              updatedAt: string;
            };
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Project not found, or token does not have access to it. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description A variable with this key already exists in this environment. */
      409: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Invalid request. */
      422: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Internal error while processing the encrypted variable (e.g., a master-key rotation or deploy issue prevents the project's wrapped DEK from being decrypted). Not a client-fixable condition. */
      500: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  "getV1Environment-variablesByEnvVarId": {
    parameters: {
      query?: never;
      header?: never;
      path: {
        envVarId: string;
      };
      cookie?: never;
    };
    requestBody?: never;
    responses: {
      /** @description Returned the environment variable. */
      200: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              id: string;
              /** @constant */
              type: "environment-variable";
              /** Format: uri */
              url: string;
              projectId: string;
              branchId: string | null;
              /** @enum {string} */
              class: "production" | "preview";
              key: string;
              valueKid: string;
              isManagedBySystem: boolean;
              /** Format: date-time */
              createdAt: string;
              /** Format: date-time */
              updatedAt: string;
            };
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Variable not found, or token does not have access to it. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Invalid request. */
      422: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  "deleteV1Environment-variablesByEnvVarId": {
    parameters: {
      query?: never;
      header?: never;
      path: {
        envVarId: string;
      };
      cookie?: never;
    };
    requestBody?: never;
    responses: {
      /** @description Variable deleted. */
      204: {
        headers: {
          [name: string]: unknown;
        };
        content?: never;
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Variable not found, or token does not have access to it. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Invalid request. */
      422: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  "patchV1Environment-variablesByEnvVarId": {
    parameters: {
      query?: never;
      header?: never;
      path: {
        envVarId: string;
      };
      cookie?: never;
    };
    requestBody?: {
      content: {
        "application/json": {
          value: string;
        };
      };
    };
    responses: {
      /** @description Variable updated. */
      200: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              id: string;
              /** @constant */
              type: "environment-variable";
              /** Format: uri */
              url: string;
              projectId: string;
              branchId: string | null;
              /** @enum {string} */
              class: "production" | "preview";
              key: string;
              valueKid: string;
              isManagedBySystem: boolean;
              /** Format: date-time */
              createdAt: string;
              /** Format: date-time */
              updatedAt: string;
            };
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Variable not found, or token does not have access to it. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Invalid request. */
      422: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Internal error while processing the encrypted variable (e.g., a master-key rotation or deploy issue prevents the project's wrapped DEK from being decrypted). Not a client-fixable condition. */
      500: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  getV1Integrations: {
    parameters: {
      query: {
        cursor?: string | null;
        limit?: number;
        workspaceId: string;
      };
      header?: never;
      path?: never;
      cookie?: never;
    };
    requestBody?: never;
    responses: {
      /** @description Returned the integrations for the given workspace. */
      200: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              id: string;
              /** Format: uri */
              url: string;
              /** Format: date-time */
              createdAt: string;
              scopes: string[];
              client: {
                id: string;
                name: string;
                /** Format: date-time */
                createdAt: string;
              };
              createdByUser: {
                id: string;
                email: string;
                displayName: string | null;
              };
            }[];
            pagination: {
              /** @description Next cursor to continue pagination */
              nextCursor: string | null;
              /** @description Whether there are more items to paginate */
              hasMore: boolean;
            };
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  getV1IntegrationsById: {
    parameters: {
      query?: never;
      header?: never;
      path: {
        id: string;
      };
      cookie?: never;
    };
    requestBody?: never;
    responses: {
      /** @description Returned the integration. */
      200: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              id: string;
              /** Format: uri */
              url: string;
              /** Format: date-time */
              createdAt: string;
              scopes: string[];
              client: {
                id: string;
                name: string;
                /** Format: date-time */
                createdAt: string;
              };
              createdByUser: {
                id: string;
                email: string;
                displayName: string | null;
              };
            };
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Integration with the given ID was not found. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  deleteV1IntegrationsById: {
    parameters: {
      query?: never;
      header?: never;
      path: {
        id: string;
      };
      cookie?: never;
    };
    requestBody?: never;
    responses: {
      /** @description Revoked the integration tokens. */
      204: {
        headers: {
          [name: string]: unknown;
        };
        content?: never;
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Integration with the given ID was not found. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  getV1Me: {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    requestBody?: never;
    responses: {
      /** @description Current authenticated principal retrieved. */
      200: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              user: {
                id: string;
                /** Format: email */
                email: string;
                name: string | null;
              } | null;
              workspace: {
                id: string;
                name: string;
              } | null;
              credential: {
                /** @enum {string} */
                type: "oauth" | "service_token" | "management_token" | "agent_token";
                id: string | null;
                name: string | null;
              };
            };
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  getV1WorkspacesByWorkspaceIdIntegrations: {
    parameters: {
      query?: {
        cursor?: string | null;
        limit?: number;
      };
      header?: never;
      path: {
        workspaceId: string;
      };
      cookie?: never;
    };
    requestBody?: never;
    responses: {
      /** @description Returned the integrations for the given workspace ID. */
      200: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              id: string;
              /** Format: uri */
              url: string;
              /** Format: date-time */
              createdAt: string;
              scopes: string[];
              client: {
                id: string;
                name: string;
                /** Format: date-time */
                createdAt: string;
              };
              createdByUser: {
                id: string;
                email: string;
                displayName: string | null;
              };
            }[];
            pagination: {
              /** @description Next cursor to continue pagination */
              nextCursor: string | null;
              /** @description Whether there are more items to paginate */
              hasMore: boolean;
            };
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Workspace with the given ID was not found. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  deleteV1WorkspacesByWorkspaceIdIntegrationsByClientId: {
    parameters: {
      query?: never;
      header?: never;
      path: {
        clientId: string;
        workspaceId: string;
      };
      cookie?: never;
    };
    requestBody?: never;
    responses: {
      /** @description Revoked the integration tokens. */
      204: {
        headers: {
          [name: string]: unknown;
        };
        content?: never;
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Integration with the given client ID was not found. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  "getV1WorkspacesByWorkspaceIdService-tokens": {
    parameters: {
      query?: {
        cursor?: string | null;
        limit?: number;
      };
      header?: never;
      path: {
        workspaceId: string;
      };
      cookie?: never;
    };
    requestBody?: never;
    responses: {
      /** @description Returns the list of service tokens. Empty when the workspace does not exist or the caller is not a member of it. */
      200: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              id: string;
              /** @constant */
              type: "serviceToken";
              name: string;
              valueHint: string;
              /** Format: date-time */
              createdAt: string;
              /** Format: date-time */
              expiresAt?: string | null;
            }[];
            pagination: {
              /** @description Next cursor to continue pagination */
              nextCursor: string | null;
              /** @description Whether there are more items to paginate */
              hasMore: boolean;
            };
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  "postV1WorkspacesByWorkspaceIdService-tokens": {
    parameters: {
      query?: never;
      header?: never;
      path: {
        workspaceId: string;
      };
      cookie?: never;
    };
    requestBody?: {
      content: {
        "application/json": {
          /** @description Display name for the service token. */
          name: string;
        };
      };
    };
    responses: {
      /** @description Created a new service token. The token value is returned once in the response body. */
      201: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              id: string;
              /** @constant */
              type: "serviceToken";
              name: string;
              valueHint: string;
              /** Format: date-time */
              createdAt: string;
              /** Format: date-time */
              expiresAt?: string | null;
              value: string;
            };
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Workspace with the given ID was not found. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Invalid request parameters. */
      422: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  "deleteV1WorkspacesByWorkspaceIdService-tokensByServiceTokenId": {
    parameters: {
      query?: never;
      header?: never;
      path: {
        workspaceId: string;
        serviceTokenId: string;
      };
      cookie?: never;
    };
    requestBody?: never;
    responses: {
      /** @description Deleted the service token successfully. */
      204: {
        headers: {
          [name: string]: unknown;
        };
        content?: never;
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Workspace not found, or the service token does not exist in it. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  "postV1AuthGithub-actionsToken": {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    requestBody?: {
      content: {
        "application/json": {
          /** @description The GitHub Actions OIDC token with audience `prisma-cloud`. */
          token: string;
          /**
           * @description Requested token lifetime in seconds. Defaults to 1800 (30 min); capped at 3600 (60 min).
           * @default 1800
           */
          expiresInSeconds?: number;
        };
      };
    };
    responses: {
      /** @description Minted a short-lived workspace service token. */
      201: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              /** @description Prefixed integration token ID (`itgr_` prefix). */
              id: string;
              /** @constant */
              type: "serviceToken";
              /** @description The minted integration token. Returned once — copy it immediately. */
              value: string;
              /**
               * Format: date-time
               * @description ISO 8601 instant after which the token is invalid.
               */
              expiresAt: string;
              /** @description Prefixed workspace ID the token is scoped to. */
              workspaceId: string;
            };
          };
        };
      };
      /** @description Missing, expired, or invalid OIDC token, or no active repository link. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            /** @constant */
            error: "unauthorized";
            errorDescription: string;
          };
        };
      };
      /** @description Rate limit exceeded. */
      429: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  getV1Regions: {
    parameters: {
      query?: {
        product?: "postgres" | "accelerate";
      };
      header?: never;
      path?: never;
      cookie?: never;
    };
    requestBody?: never;
    responses: {
      /** @description Returns all available regions. */
      200: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              id: string;
              /** @constant */
              type: "region";
              name: string;
              /** @enum {string} */
              product: "postgres" | "accelerate";
              /** @enum {string} */
              status?: "available" | "unavailable";
            }[];
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  getV1RegionsPostgres: {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    requestBody?: never;
    responses: {
      /** @description Returns all available regions for Prisma Postgres. */
      200: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              id: string;
              /** @constant */
              type: "region";
              name: string;
              /** @enum {string} */
              status: "available" | "unavailable";
            }[];
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  getV1RegionsAccelerate: {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    requestBody?: never;
    responses: {
      /** @description Returns all available regions for Prisma Accelerate. */
      200: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              id: string;
              /** @constant */
              type: "region";
              name: string;
            }[];
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  "getV1Scm-installations": {
    parameters: {
      query: {
        cursor?: string | null;
        limit?: number;
        workspaceId: string;
        repository?: string;
      };
      header?: never;
      path?: never;
      cookie?: never;
    };
    requestBody?: never;
    responses: {
      /** @description SCM installations the caller can access in the workspace. May be empty. */
      200: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              id: string;
              /** @constant */
              type: "scm-installation";
              /** Format: uri */
              url: string;
              /** @enum {string} */
              provider: "github";
              /** @description Numeric installation ID assigned by the SCM provider */
              installationId: number;
              /** @description Numeric account ID assigned by the SCM provider */
              accountId: number;
              accountLogin: string;
              /** @enum {string} */
              accountType: "user" | "organization";
              suspended: boolean;
              /** Format: date-time */
              createdAt: string;
              /** Format: date-time */
              updatedAt: string;
            }[];
            pagination: {
              /** @description Next cursor to continue pagination */
              nextCursor: string | null;
              /** @description Whether there are more items to paginate */
              hasMore: boolean;
            };
            hint?: string;
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  "postV1Scm-installationsInstall-intents": {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    requestBody?: {
      content: {
        "application/json": {
          /** @enum {string} */
          provider: "github";
          workspaceId: string;
          repository?: string;
        };
      };
    };
    responses: {
      /** @description Installation intent created. The `installUrl` is single-use and time-limited. */
      201: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              /** @constant */
              type: "install-intent";
              /** @enum {string} */
              provider: "github";
              workspaceId: string;
              /** Format: uri */
              installUrl: string;
              alreadyLinked?: boolean;
              accountLogin?: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Workspace integration tokens cannot create install intents; a user-authenticated request is required. */
      403: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Workspace not found or not accessible. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Validation failed (e.g. malformed workspaceId or unsupported provider). */
      422: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Rate limit exceeded. */
      429: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  "getV1Scm-installationsByInstallationIdRepositories": {
    parameters: {
      query?: {
        cursor?: string | null;
        limit?: number;
      };
      header?: never;
      path: {
        installationId: string;
      };
      cookie?: never;
    };
    requestBody?: never;
    responses: {
      /** @description Repositories accessible to the installation. */
      200: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              /** @description Numeric repository ID assigned by the SCM provider */
              id: number;
              /** @constant */
              type: "scm-repository";
              /** @description Full repository name, e.g. "octocat/hello" */
              fullName: string;
              defaultBranch: string;
              isPrivate: boolean;
            }[];
            pagination: {
              nextCursor: string | null;
              hasMore: boolean;
            };
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Installation not found or not accessible. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description The SCM provider rejected the repository listing request. */
      422: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  "getV1Source-repositories": {
    parameters: {
      query: {
        cursor?: string | null;
        limit?: number;
        projectId: string;
      };
      header?: never;
      path?: never;
      cookie?: never;
    };
    requestBody?: never;
    responses: {
      /** @description Returned the list of source repositories. */
      200: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              id: string;
              /** @constant */
              type: "source-repository";
              /** Format: uri */
              url: string;
              repoId: number;
              /** @enum {string} */
              provider: "github";
              repoFullName: string;
              defaultBranch: string;
              isPrivate: boolean;
              /** @enum {string} */
              status: "active" | "archived";
              projectId: string;
              installationId: string;
              /** Format: date-time */
              createdAt: string;
              /** Format: date-time */
              updatedAt: string;
            }[];
            pagination: {
              nextCursor: string | null;
              hasMore: boolean;
            };
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Project not found. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  "postV1Source-repositories": {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    requestBody?: {
      content: {
        "application/json": {
          projectId: string;
          /** @constant */
          provider: "github";
          providerRepositoryId: number;
          /** @description Optional SCM installation ID to use for linking. When omitted, the API auto-picks the workspace's installation. */
          installationId?: string;
        };
      };
    };
    responses: {
      /** @description Source repository linked. */
      201: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              id: string;
              /** @constant */
              type: "source-repository";
              /** Format: uri */
              url: string;
              repoId: number;
              /** @enum {string} */
              provider: "github";
              repoFullName: string;
              defaultBranch: string;
              isPrivate: boolean;
              /** @enum {string} */
              status: "active" | "archived";
              projectId: string;
              installationId: string;
              /** Format: date-time */
              createdAt: string;
              /** Format: date-time */
              updatedAt: string;
            };
            hint?: string;
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description SCM installation is suspended, uninstalled, or actor lacks access. */
      403: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Project or SCM installation not found. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Repository or project already linked. */
      409: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Repository not accessible to the installation. */
      422: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  "getV1Source-repositoriesById": {
    parameters: {
      query?: never;
      header?: never;
      path: {
        id: string;
      };
      cookie?: never;
    };
    requestBody?: never;
    responses: {
      /** @description Returned the source repository. */
      200: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              id: string;
              /** @constant */
              type: "source-repository";
              /** Format: uri */
              url: string;
              repoId: number;
              /** @enum {string} */
              provider: "github";
              repoFullName: string;
              defaultBranch: string;
              isPrivate: boolean;
              /** @enum {string} */
              status: "active" | "archived";
              projectId: string;
              installationId: string;
              /** Format: date-time */
              createdAt: string;
              /** Format: date-time */
              updatedAt: string;
            };
            hint?: string;
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Source repository not found. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  "deleteV1Source-repositoriesById": {
    parameters: {
      query?: never;
      header?: never;
      path: {
        id: string;
      };
      cookie?: never;
    };
    requestBody?: never;
    responses: {
      /** @description Source repository disconnected. */
      204: {
        headers: {
          [name: string]: unknown;
        };
        content?: never;
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Source repository not found. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  getV1Workspaces: {
    parameters: {
      query?: {
        cursor?: string | null;
        limit?: number;
      };
      header?: never;
      path?: never;
      cookie?: never;
    };
    requestBody?: never;
    responses: {
      /** @description Returns the list of workspaces the current token can access. */
      200: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              id: string;
              /** @constant */
              type: "workspace";
              /** Format: uri */
              url: string;
              name: string;
              /** Format: date-time */
              createdAt: string;
            }[];
            pagination: {
              /** @description Next cursor to continue pagination */
              nextCursor: string | null;
              /** @description Whether there are more items to paginate */
              hasMore: boolean;
            };
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  postV1Workspaces: {
    parameters: {
      query?: never;
      header?: never;
      path?: never;
      cookie?: never;
    };
    requestBody?: {
      content: {
        "application/json": {
          displayName?: string;
        };
      };
    };
    responses: {
      /** @description The created workspace. */
      201: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              id: string;
              /** @constant */
              type: "workspace";
              /** Format: uri */
              url: string;
              name: string;
              /** Format: date-time */
              createdAt: string;
            };
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Workspace integration tokens cannot create workspaces; a user-attributable actor is required. */
      403: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Request body exceeds this endpoint's size cap. */
      413: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  getV1WorkspacesById: {
    parameters: {
      query?: never;
      header?: never;
      path: {
        id: string;
      };
      cookie?: never;
    };
    requestBody?: never;
    responses: {
      /** @description Workspace retrieved. */
      200: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              id: string;
              /** @constant */
              type: "workspace";
              /** Format: uri */
              url: string;
              name: string;
              /** Format: date-time */
              createdAt: string;
            };
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Workspace with the specified ID was not found. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
  getV1WorkspacesByIdSubscription: {
    parameters: {
      query?: never;
      header?: never;
      path: {
        id: string;
      };
      cookie?: never;
    };
    requestBody?: never;
    responses: {
      /** @description Workspace subscription retrieved. */
      200: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            data: {
              planName: string;
              usageBlocked: boolean;
              /** Format: uri */
              upgradeUrl: string;
            };
          };
        };
      };
      /** @description Missing or invalid authorization token. */
      401: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
      /** @description Workspace with the specified ID was not found. */
      404: {
        headers: {
          [name: string]: unknown;
        };
        content: {
          "application/json": {
            error: {
              code: string;
              message: string;
              hint?: string;
            };
          };
        };
      };
    };
  };
}
//#endregion
//#region src/errors.d.ts
/**
 * Error thrown when a network request fails.
 */
declare class FetchError extends Error {
  /** The underlying error that caused the fetch to fail. */
  readonly cause?: unknown | undefined;
  constructor(message: string, /** The underlying error that caused the fetch to fail. */
  cause?: unknown | undefined);
}
/**
 * Error thrown when authentication fails.
 */
declare class AuthError extends Error {
  /** Whether the refresh token is invalid/expired and the user needs to re-authenticate. */
  readonly refreshTokenInvalid: boolean;
  constructor(message: string, /** Whether the refresh token is invalid/expired and the user needs to re-authenticate. */
  refreshTokenInvalid?: boolean);
}
//#endregion
//#region src/index.d.ts
type Tokens = {
  workspaceId: string;
  accessToken: string;
  refreshToken?: string;
};
/**
 * Implement this interface to store and retrieve tokens from your environment.
 */
interface TokenStorage {
  getTokens(): Promise<Tokens | null>;
  setTokens(tokens: Tokens): Promise<void>;
  clearTokens(): Promise<void>;
  withRefreshLock?<T>(fn: () => Promise<T>): Promise<T>;
  clearTokensIfCurrent?(tokens: Tokens): Promise<void>;
}
/**
 * Configuration options for creating a Management API instance.
 */
type ManagementApiClientConfig = {
  /** The OAuth client ID for authentication. */
  clientId: string;
  /** The URI to redirect to after OAuth authentication. */
  redirectUri: string;
  /** Implementation for storing and retrieving tokens. */
  tokenStorage: TokenStorage;
  /** Base URL for API requests. Defaults to 'https://api.prisma.io'. */
  apiBaseUrl?: string;
  /** Base URL for authentication requests. Defaults to 'https://auth.prisma.io'. */
  authBaseUrl?: string;
};
/**
 * Options for generating an OAuth login URL.
 */
type LoginUrlOptions = {
  /** The OAuth scopes to request (e.g., 'workspace:admin offline_access'). */
  scope: string;
  /** Additional query parameters to include in the authorization URL (e.g. UTM parameters). */
  additionalParams?: Record<string, string>;
};
type AsyncCallOptions = {
  signal?: AbortSignal;
};
/**
 * A typed API client for making requests to the Management API.
 */
type ManagementApiClient = ReturnType<typeof createOpenAPIClient<paths>>;
/**
 * Result from generating an OAuth login URL.
 */
type LoginResult = {
  /** The authorization URL to redirect the user to. */
  url: string;
  /** The state parameter for CSRF protection. Must be stored and verified in the callback. */
  state: string;
  /** The PKCE code verifier. Must be stored and provided when handling the callback. */
  verifier: string;
};
/**
 * Options for handling the OAuth callback after user authentication.
 */
type HandleCallbackOptions = {
  /** The full callback URL including query parameters. */
  callbackUrl: string | URL;
  /** The PKCE code verifier that was generated with the login URL. */
  verifier: string;
  /** The state parameter that was generated with the login URL, used for CSRF protection. */
  expectedState: string;
};
/**
 * The Management API SDK instance with authentication handling.
 */
type ManagementApiSdk = {
  /** The typed API client for making requests. */
  client: ManagementApiClient;
  /** Generate an OAuth login URL with PKCE. */
  getLoginUrl(options: LoginUrlOptions, asyncOptions?: AsyncCallOptions): Promise<LoginResult>;
  /** Handle the OAuth callback, exchange the code for tokens, and store them. */
  handleCallback(options: HandleCallbackOptions, asyncOptions?: AsyncCallOptions): Promise<void>;
  /** Clear stored tokens and log out. */
  logout(asyncOptions?: AsyncCallOptions): Promise<void>;
};
/**
 * Creates a raw API client without authentication handling.
 * Useful if you want to manage authentication yourself.
 */
declare function createManagementApiClient(options: ClientOptions & {
  token?: string;
}): ManagementApiClient;
/**
 * Creates a Management API instance with OAuth authentication and automatic token refresh.
 */
declare function createManagementApiSdk(config: ManagementApiClientConfig): ManagementApiSdk;
//#endregion
export { $defs, AsyncCallOptions, AuthError, FetchError, HandleCallbackOptions, LoginResult, LoginUrlOptions, ManagementApiClient, ManagementApiClientConfig, ManagementApiSdk, TokenStorage, Tokens, components, createManagementApiClient, createManagementApiSdk, operations, paths, webhooks };
//# sourceMappingURL=index.d.ts.map