@faable/deploy-sdk 2.15.0 → 2.16.0

package/dist/api/generated-client.d.ts

@@ -22,6 +22,14 @@ export declare abstract class GeneratedFaableDeployApi extends FaableApi {
      * `GET /app/checkname` — operationId: `app/checkname`
      *
      * Check if an app name is availiable
+     *
+     * @throws {FaableApiError} `validation_error` (400) — The body, query or path failed schema validation. `details.issues` lists each failing field.
+     * @throws {FaableApiError} `unauthorized` (401) — The request carries no valid credentials.
+     * @throws {FaableApiError} `invalid_token` (401) — The bearer token is missing, malformed or expired.
+     * @throws {FaableApiError} `forbidden` (403) — The credentials are valid but do not allow this operation.
+     * @throws {FaableApiError} `user_suspended` (403) — The account is suspended. Contact support@faable.com.
+     * @throws {FaableApiError} `too_many_requests` (429) — Rate limit exceeded. Honour the `Retry-After` header.
+     * @throws {FaableApiError} `internal_error` (500) — Unexpected server error. Retry later; the request id is logged.
      */
     appCheckname(params?: OpQuery<"app/checkname">): Promise<{
         name: string;
@@ -34,6 +42,17 @@ export declare abstract class GeneratedFaableDeployApi extends FaableApi {
      * `POST /app` — operationId: `app/create`
      *
      * Create App
+     *
+     * @throws {FaableApiError} `already_exists` (400) — A resource with the same unique field already exists. `details.fields` names the field.
+     * @throws {FaableApiError} `validation_error` (400) — The body, query or path failed schema validation. `details.issues` lists each failing field.
+     * @throws {FaableApiError} `team_required` (400) — The operation needs a project: send it in the `x-faable-team` header.
+     * @throws {FaableApiError} `unauthorized` (401) — The request carries no valid credentials.
+     * @throws {FaableApiError} `invalid_token` (401) — The bearer token is missing, malformed or expired.
+     * @throws {FaableApiError} `user_suspended` (403) — The account is suspended. Contact support@faable.com.
+     * @throws {FaableApiError} `forbidden` (403) — The credentials are valid but do not allow this operation.
+     * @throws {FaableApiError} `app_rate_limited` (429) — A new account may only create a few apps in its first 24 hours.
+     * @throws {FaableApiError} `too_many_requests` (429) — Rate limit exceeded. Honour the `Retry-After` header.
+     * @throws {FaableApiError} `internal_error` (500) — Unexpected server error. Retry later; the request id is logged.
      */
     appCreate(data: OpBody<"app/create">): Promise<{
         id: string;
@@ -83,6 +102,18 @@ export declare abstract class GeneratedFaableDeployApi extends FaableApi {
      * `DELETE /app/{id}` — operationId: `app/delete`
      *
      * Delete App
+     *
+     * @throws {FaableApiError} `invalid_id` (400) — The id in the path is not a valid id for this resource.
+     * @throws {FaableApiError} `validation_error` (400) — The body, query or path failed schema validation. `details.issues` lists each failing field.
+     * @throws {FaableApiError} `access_denied` (401) — The row exists but does not belong to the caller.
+     * @throws {FaableApiError} `unauthorized` (401) — The request carries no valid credentials.
+     * @throws {FaableApiError} `invalid_token` (401) — The bearer token is missing, malformed or expired.
+     * @throws {FaableApiError} `moderation_hold` (403) — The project contains an app disabled by moderation and cannot be deleted. Contact support@faable.com.
+     * @throws {FaableApiError} `user_suspended` (403) — The account is suspended. Contact support@faable.com.
+     * @throws {FaableApiError} `forbidden` (403) — The credentials are valid but do not allow this operation.
+     * @throws {FaableApiError} `not_found` (404) — The resource does not exist, or not in the caller’s project.
+     * @throws {FaableApiError} `too_many_requests` (429) — Rate limit exceeded. Honour the `Retry-After` header.
+     * @throws {FaableApiError} `internal_error` (500) — Unexpected server error. Retry later; the request id is logged.
      */
     appDelete(id: string): Promise<{
         id: string;
@@ -134,6 +165,23 @@ export declare abstract class GeneratedFaableDeployApi extends FaableApi {
      * Deploy the latest commit now
      *
      * Build and deploy the current head of the deploy branch, without waiting for a push. Same path as a push webhook, including the same-commit dedupe.
+     *
+     * @throws {FaableApiError} `branch_missing` (400) — The deploy branch does not exist on the repository. `message` lists the branches that do.
+     * @throws {FaableApiError} `deploy_mode_conflict` (400) — The app deploys from its own workflow, so the platform will not create a deployment for it.
+     * @throws {FaableApiError} `repository_empty` (400) — The repository has no commits on the deploy branch yet.
+     * @throws {FaableApiError} `repository_not_linked` (400) — The app has no linked repository.
+     * @throws {FaableApiError} `validation_error` (400) — The body, query or path failed schema validation. `details.issues` lists each failing field.
+     * @throws {FaableApiError} `github_token_invalid` (401) — The stored GitHub token was rejected; the user must reconnect.
+     * @throws {FaableApiError} `user_token_required` (401) — The endpoint acts on behalf of a person and the credential carries no user (an API key or a service account).
+     * @throws {FaableApiError} `unauthorized` (401) — The request carries no valid credentials.
+     * @throws {FaableApiError} `invalid_token` (401) — The bearer token is missing, malformed or expired.
+     * @throws {FaableApiError} `forbidden` (403) — The credentials are valid but do not allow this operation.
+     * @throws {FaableApiError} `user_suspended` (403) — The account is suspended. Contact support@faable.com.
+     * @throws {FaableApiError} `deploy_refused` (409) — The deploy was refused by quota, plan or an in-flight deployment. `message` says which.
+     * @throws {FaableApiError} `github_identity_missing` (412) — The user has not connected GitHub. Send them through `connect_github`.
+     * @throws {FaableApiError} `too_many_requests` (429) — Rate limit exceeded. Honour the `Retry-After` header.
+     * @throws {FaableApiError} `internal_error` (500) — Unexpected server error. Retry later; the request id is logged.
+     * @throws {FaableApiError} `github_error` (502) — GitHub failed upstream. `message` carries what it said.
      */
     appDeployNow(id: string): Promise<{
         status: "created";
@@ -144,6 +192,18 @@ export declare abstract class GeneratedFaableDeployApi extends FaableApi {
      * `GET /app/{id}` — operationId: `app/get`
      *
      * Get App
+     *
+     * @throws {FaableApiError} `invalid_id` (400) — The id in the path is not a valid id for this resource.
+     * @throws {FaableApiError} `invalid_expand` (400) — An `?expand=` path is not allowed on this resource.
+     * @throws {FaableApiError} `validation_error` (400) — The body, query or path failed schema validation. `details.issues` lists each failing field.
+     * @throws {FaableApiError} `access_denied` (401) — The row exists but does not belong to the caller.
+     * @throws {FaableApiError} `unauthorized` (401) — The request carries no valid credentials.
+     * @throws {FaableApiError} `invalid_token` (401) — The bearer token is missing, malformed or expired.
+     * @throws {FaableApiError} `forbidden` (403) — The credentials are valid but do not allow this operation.
+     * @throws {FaableApiError} `user_suspended` (403) — The account is suspended. Contact support@faable.com.
+     * @throws {FaableApiError} `not_found` (404) — The resource does not exist, or not in the caller’s project.
+     * @throws {FaableApiError} `too_many_requests` (429) — Rate limit exceeded. Honour the `Retry-After` header.
+     * @throws {FaableApiError} `internal_error` (500) — Unexpected server error. Retry later; the request id is logged.
      */
     appGet(id: string, params?: OpQuery<"app/get">): Promise<{
         id: string;
@@ -193,6 +253,16 @@ export declare abstract class GeneratedFaableDeployApi extends FaableApi {
      * `GET /app/{app_id}/registry` — operationId: `app/get_registry`
      *
      * Get app registry
+     *
+     * @throws {FaableApiError} `validation_error` (400) — The body, query or path failed schema validation. `details.issues` lists each failing field.
+     * @throws {FaableApiError} `unauthorized` (401) — The request carries no valid credentials.
+     * @throws {FaableApiError} `invalid_token` (401) — The bearer token is missing, malformed or expired.
+     * @throws {FaableApiError} `forbidden` (403) — The credentials are valid but do not allow this operation.
+     * @throws {FaableApiError} `user_suspended` (403) — The account is suspended. Contact support@faable.com.
+     * @throws {FaableApiError} `app_disabled` (409) — The app is disabled, so it cannot be deployed or provisioned. `message` says why when the reason is public.
+     * @throws {FaableApiError} `too_many_requests` (429) — Rate limit exceeded. Honour the `Retry-After` header.
+     * @throws {FaableApiError} `internal_error` (500) — Unexpected server error. Retry later; the request id is logged.
+     * @throws {FaableApiError} `bad_gateway` (502) — An upstream the API depends on failed.
      */
     appGetRegistry(app_id: string): Promise<{
         id: string;
@@ -208,6 +278,24 @@ export declare abstract class GeneratedFaableDeployApi extends FaableApi {
      * Link a GitHub repository to an app
      *
      * Link a GitHub repository to an app after verifying the user has a connected GitHub identity with access to the repository.
+     *
+     * @throws {FaableApiError} `validation_error` (400) — The body, query or path failed schema validation. `details.issues` lists each failing field.
+     * @throws {FaableApiError} `github_token_invalid` (401) — The stored GitHub token was rejected; the user must reconnect.
+     * @throws {FaableApiError} `user_token_required` (401) — The endpoint acts on behalf of a person and the credential carries no user (an API key or a service account).
+     * @throws {FaableApiError} `unauthorized` (401) — The request carries no valid credentials.
+     * @throws {FaableApiError} `invalid_token` (401) — The bearer token is missing, malformed or expired.
+     * @throws {FaableApiError} `github_installation_suspended` (403) — The GitHub App installation is suspended.
+     * @throws {FaableApiError} `github_permission_denied` (403) — The installation lacks a permission this operation needs.
+     * @throws {FaableApiError} `github_repository_blocked` (403) — GitHub refuses to serve the source of that repository (403 or 451).
+     * @throws {FaableApiError} `forbidden` (403) — The credentials are valid but do not allow this operation.
+     * @throws {FaableApiError} `user_suspended` (403) — The account is suspended. Contact support@faable.com.
+     * @throws {FaableApiError} `github_repository_not_found` (404) — The repository does not exist or the installation cannot see it.
+     * @throws {FaableApiError} `repository_already_linked` (409) — The repository is already linked to another app. `details.app_id` / `details.app_name` name it.
+     * @throws {FaableApiError} `github_identity_missing` (412) — The user has not connected GitHub. Send them through `connect_github`.
+     * @throws {FaableApiError} `github_installation_missing` (412) — The Faable GitHub App is not installed on any repository of theirs.
+     * @throws {FaableApiError} `too_many_requests` (429) — Rate limit exceeded. Honour the `Retry-After` header.
+     * @throws {FaableApiError} `internal_error` (500) — Unexpected server error. Retry later; the request id is logged.
+     * @throws {FaableApiError} `github_error` (502) — GitHub failed upstream. `message` carries what it said.
      */
     appLinkRepository(id: string, data: OpBody<"app/link_repository">): Promise<{
         id: string;
@@ -257,6 +345,18 @@ export declare abstract class GeneratedFaableDeployApi extends FaableApi {
      * `GET /app` — operationId: `app/list`
      *
      * List Apps
+     *
+     * @throws {FaableApiError} `invalid_query` (400) — The `?query=` FaableQL expression could not be parsed.
+     * @throws {FaableApiError} `invalid_expand` (400) — An `?expand=` path is not allowed on this resource.
+     * @throws {FaableApiError} `search_not_supported` (400) — This resource does not support `?q=`.
+     * @throws {FaableApiError} `validation_error` (400) — The body, query or path failed schema validation. `details.issues` lists each failing field.
+     * @throws {FaableApiError} `team_or_scope_required` (401) — Listing needs either a project in `x-faable-team` or a global scope on the token.
+     * @throws {FaableApiError} `unauthorized` (401) — The request carries no valid credentials.
+     * @throws {FaableApiError} `invalid_token` (401) — The bearer token is missing, malformed or expired.
+     * @throws {FaableApiError} `forbidden` (403) — The credentials are valid but do not allow this operation.
+     * @throws {FaableApiError} `user_suspended` (403) — The account is suspended. Contact support@faable.com.
+     * @throws {FaableApiError} `too_many_requests` (429) — Rate limit exceeded. Honour the `Retry-After` header.
+     * @throws {FaableApiError} `internal_error` (500) — Unexpected server error. Retry later; the request id is logged.
      */
     appList(params?: Omit<OpQuery<"app/list">, "cursor" | "next">): {
         all: () => Promise<{
@@ -399,6 +499,14 @@ export declare abstract class GeneratedFaableDeployApi extends FaableApi {
      * `GET /app/{app_id}/logs` — operationId: `app/logs`
      *
      * Get app logs
+     *
+     * @throws {FaableApiError} `validation_error` (400) — The body, query or path failed schema validation. `details.issues` lists each failing field.
+     * @throws {FaableApiError} `unauthorized` (401) — The request carries no valid credentials.
+     * @throws {FaableApiError} `invalid_token` (401) — The bearer token is missing, malformed or expired.
+     * @throws {FaableApiError} `forbidden` (403) — The credentials are valid but do not allow this operation.
+     * @throws {FaableApiError} `user_suspended` (403) — The account is suspended. Contact support@faable.com.
+     * @throws {FaableApiError} `too_many_requests` (429) — Rate limit exceeded. Honour the `Retry-After` header.
+     * @throws {FaableApiError} `internal_error` (500) — Unexpected server error. Retry later; the request id is logged.
      */
     appLogs(app_id: string, params?: OpQuery<"app/logs">): Promise<void>;
     /**
@@ -407,6 +515,17 @@ export declare abstract class GeneratedFaableDeployApi extends FaableApi {
      * List repository branches
      *
      * Branch names of the linked repository.
+     *
+     * @throws {FaableApiError} `validation_error` (400) — The body, query or path failed schema validation. `details.issues` lists each failing field.
+     * @throws {FaableApiError} `github_token_invalid` (401) — The stored GitHub token was rejected; the user must reconnect.
+     * @throws {FaableApiError} `unauthorized` (401) — The request carries no valid credentials.
+     * @throws {FaableApiError} `invalid_token` (401) — The bearer token is missing, malformed or expired.
+     * @throws {FaableApiError} `forbidden` (403) — The credentials are valid but do not allow this operation.
+     * @throws {FaableApiError} `user_suspended` (403) — The account is suspended. Contact support@faable.com.
+     * @throws {FaableApiError} `github_repository_not_found` (404) — The repository does not exist or the installation cannot see it.
+     * @throws {FaableApiError} `too_many_requests` (429) — Rate limit exceeded. Honour the `Retry-After` header.
+     * @throws {FaableApiError} `internal_error` (500) — Unexpected server error. Retry later; the request id is logged.
+     * @throws {FaableApiError} `github_error` (502) — GitHub failed upstream. `message` carries what it said.
      */
     appRepoBranches(id: string): Promise<{
         branches: string[];
@@ -417,6 +536,17 @@ export declare abstract class GeneratedFaableDeployApi extends FaableApi {
      * Get effective repository build config
      *
      * Effective build configuration read from the repository: the monorepo Root Directory and its source (platform override or the repo's faable.json).
+     *
+     * @throws {FaableApiError} `validation_error` (400) — The body, query or path failed schema validation. `details.issues` lists each failing field.
+     * @throws {FaableApiError} `github_token_invalid` (401) — The stored GitHub token was rejected; the user must reconnect.
+     * @throws {FaableApiError} `unauthorized` (401) — The request carries no valid credentials.
+     * @throws {FaableApiError} `invalid_token` (401) — The bearer token is missing, malformed or expired.
+     * @throws {FaableApiError} `forbidden` (403) — The credentials are valid but do not allow this operation.
+     * @throws {FaableApiError} `user_suspended` (403) — The account is suspended. Contact support@faable.com.
+     * @throws {FaableApiError} `github_repository_not_found` (404) — The repository does not exist or the installation cannot see it.
+     * @throws {FaableApiError} `too_many_requests` (429) — Rate limit exceeded. Honour the `Retry-After` header.
+     * @throws {FaableApiError} `internal_error` (500) — Unexpected server error. Retry later; the request id is logged.
+     * @throws {FaableApiError} `github_error` (502) — GitHub failed upstream. `message` carries what it said.
      */
     appRepoConfig(id: string): Promise<{
         root_dir: string | null;
@@ -428,6 +558,14 @@ export declare abstract class GeneratedFaableDeployApi extends FaableApi {
      * List repository directories
      *
      * Directories of the linked repository on the deploy branch, flagged with whether each one holds a buildable manifest. Feeds the Root Directory picker so a monorepo is configured from what the repository actually contains. Limited to three levels deep; dotted directories and node_modules are excluded.
+     *
+     * @throws {FaableApiError} `validation_error` (400) — The body, query or path failed schema validation. `details.issues` lists each failing field.
+     * @throws {FaableApiError} `unauthorized` (401) — The request carries no valid credentials.
+     * @throws {FaableApiError} `invalid_token` (401) — The bearer token is missing, malformed or expired.
+     * @throws {FaableApiError} `forbidden` (403) — The credentials are valid but do not allow this operation.
+     * @throws {FaableApiError} `user_suspended` (403) — The account is suspended. Contact support@faable.com.
+     * @throws {FaableApiError} `too_many_requests` (429) — Rate limit exceeded. Honour the `Retry-After` header.
+     * @throws {FaableApiError} `internal_error` (500) — Unexpected server error. Retry later; the request id is logged.
      */
     appRepoDirectories(id: string): Promise<{
         directories: {
@@ -442,6 +580,18 @@ export declare abstract class GeneratedFaableDeployApi extends FaableApi {
      * Check whether a repository can be linked to a new app
      *
      * Runs the free-plan "one repository, one app" guard before the app exists. Always 200: `linkable:false` names the app that already has the repository (and its project when it is another one of yours), with the same message the link would refuse with.
+     *
+     * @throws {FaableApiError} `validation_error` (400) — The body, query or path failed schema validation. `details.issues` lists each failing field.
+     * @throws {FaableApiError} `user_token_required` (401) — The endpoint acts on behalf of a person and the credential carries no user (an API key or a service account).
+     * @throws {FaableApiError} `unauthorized` (401) — The request carries no valid credentials.
+     * @throws {FaableApiError} `invalid_token` (401) — The bearer token is missing, malformed or expired.
+     * @throws {FaableApiError} `forbidden` (403) — The credentials are valid but do not allow this operation.
+     * @throws {FaableApiError} `user_suspended` (403) — The account is suspended. Contact support@faable.com.
+     * @throws {FaableApiError} `github_identity_missing` (412) — The user has not connected GitHub. Send them through `connect_github`.
+     * @throws {FaableApiError} `github_installation_missing` (412) — The Faable GitHub App is not installed on any repository of theirs.
+     * @throws {FaableApiError} `too_many_requests` (429) — Rate limit exceeded. Honour the `Retry-After` header.
+     * @throws {FaableApiError} `internal_error` (500) — Unexpected server error. Retry later; the request id is logged.
+     * @throws {FaableApiError} `github_error` (502) — GitHub failed upstream. `message` carries what it said.
      */
     appRepoLinkable(params?: OpQuery<"app/repo_linkable">): Promise<{
         linkable: boolean;
@@ -459,6 +609,14 @@ export declare abstract class GeneratedFaableDeployApi extends FaableApi {
      * List repository workflow files
      *
      * GitHub Actions workflow files present on the linked repository (deploy branch).
+     *
+     * @throws {FaableApiError} `validation_error` (400) — The body, query or path failed schema validation. `details.issues` lists each failing field.
+     * @throws {FaableApiError} `unauthorized` (401) — The request carries no valid credentials.
+     * @throws {FaableApiError} `invalid_token` (401) — The bearer token is missing, malformed or expired.
+     * @throws {FaableApiError} `forbidden` (403) — The credentials are valid but do not allow this operation.
+     * @throws {FaableApiError} `user_suspended` (403) — The account is suspended. Contact support@faable.com.
+     * @throws {FaableApiError} `too_many_requests` (429) — Rate limit exceeded. Honour the `Retry-After` header.
+     * @throws {FaableApiError} `internal_error` (500) — Unexpected server error. Retry later; the request id is logged.
      */
     appRepoWorkflows(id: string): Promise<{
         workflows: {
@@ -473,6 +631,17 @@ export declare abstract class GeneratedFaableDeployApi extends FaableApi {
      * Change the deploy branch
      *
      * Change the branch the app deploys from. Apps deploying from their own GitHub Actions workflow must update the branch trigger in the workflow file themselves.
+     *
+     * @throws {FaableApiError} `branch_missing` (400) — The deploy branch does not exist on the repository. `message` lists the branches that do.
+     * @throws {FaableApiError} `repository_not_linked` (400) — The app has no linked repository.
+     * @throws {FaableApiError} `validation_error` (400) — The body, query or path failed schema validation. `details.issues` lists each failing field.
+     * @throws {FaableApiError} `user_token_required` (401) — The endpoint acts on behalf of a person and the credential carries no user (an API key or a service account).
+     * @throws {FaableApiError} `unauthorized` (401) — The request carries no valid credentials.
+     * @throws {FaableApiError} `invalid_token` (401) — The bearer token is missing, malformed or expired.
+     * @throws {FaableApiError} `forbidden` (403) — The credentials are valid but do not allow this operation.
+     * @throws {FaableApiError} `user_suspended` (403) — The account is suspended. Contact support@faable.com.
+     * @throws {FaableApiError} `too_many_requests` (429) — Rate limit exceeded. Honour the `Retry-After` header.
+     * @throws {FaableApiError} `internal_error` (500) — Unexpected server error. Retry later; the request id is logged.
      */
     appSetDeployBranch(id: string, data: OpBody<"app/set_deploy_branch">): Promise<{
         github_branch: string;
@@ -484,6 +653,17 @@ export declare abstract class GeneratedFaableDeployApi extends FaableApi {
      * Set the deploy mode
      *
      * Choose how pushes deploy: 'push' = every push deploys directly; 'ci' = deploy once the commit's CI checks pass. Both are platform-managed (webhook) triggers.
+     *
+     * @throws {FaableApiError} `no_deploy_workflow` (400) — No workflow in the repository runs `faable deploy`.
+     * @throws {FaableApiError} `no_workflows` (400) — The repository has no GitHub Actions workflows, so a CI gate would never open.
+     * @throws {FaableApiError} `root_dir_mismatch` (400) — The workflow deploys from one directory and platform builds would run from another. Declare `rootDir` in faable.json.
+     * @throws {FaableApiError} `validation_error` (400) — The body, query or path failed schema validation. `details.issues` lists each failing field.
+     * @throws {FaableApiError} `unauthorized` (401) — The request carries no valid credentials.
+     * @throws {FaableApiError} `invalid_token` (401) — The bearer token is missing, malformed or expired.
+     * @throws {FaableApiError} `forbidden` (403) — The credentials are valid but do not allow this operation.
+     * @throws {FaableApiError} `user_suspended` (403) — The account is suspended. Contact support@faable.com.
+     * @throws {FaableApiError} `too_many_requests` (429) — Rate limit exceeded. Honour the `Retry-After` header.
+     * @throws {FaableApiError} `internal_error` (500) — Unexpected server error. Retry later; the request id is logged.
      */
     appSetDeployMode(id: string, data: OpBody<"app/set_deploy_mode">): Promise<{
         id: string;
@@ -535,6 +715,16 @@ export declare abstract class GeneratedFaableDeployApi extends FaableApi {
      * Set the Root Directory
      *
      * Set the platform Root Directory: the subdirectory of the repository the build runs from. Takes precedence over the repo's faable.json `rootDir`; `null` clears it and hands precedence back. The path must exist on the deploy branch.
+     *
+     * @throws {FaableApiError} `invalid_root_dir` (400) — The Root Directory must be a path inside the repository — no leading `/` and no `..`.
+     * @throws {FaableApiError} `root_dir_not_found` (400) — The Root Directory does not exist on that ref of the repository.
+     * @throws {FaableApiError} `validation_error` (400) — The body, query or path failed schema validation. `details.issues` lists each failing field.
+     * @throws {FaableApiError} `unauthorized` (401) — The request carries no valid credentials.
+     * @throws {FaableApiError} `invalid_token` (401) — The bearer token is missing, malformed or expired.
+     * @throws {FaableApiError} `forbidden` (403) — The credentials are valid but do not allow this operation.
+     * @throws {FaableApiError} `user_suspended` (403) — The account is suspended. Contact support@faable.com.
+     * @throws {FaableApiError} `too_many_requests` (429) — Rate limit exceeded. Honour the `Retry-After` header.
+     * @throws {FaableApiError} `internal_error` (500) — Unexpected server error. Retry later; the request id is logged.
      */
     appSetRootDir(id: string, data: OpBody<"app/set_root_dir">): Promise<{
         id: string;
@@ -584,6 +774,15 @@ export declare abstract class GeneratedFaableDeployApi extends FaableApi {
      * `GET /app/slug/{slug}` — operationId: `app/slug`
      *
      * Get App by unique slug
+     *
+     * @throws {FaableApiError} `validation_error` (400) — The body, query or path failed schema validation. `details.issues` lists each failing field.
+     * @throws {FaableApiError} `unauthorized` (401) — The request carries no valid credentials.
+     * @throws {FaableApiError} `invalid_token` (401) — The bearer token is missing, malformed or expired.
+     * @throws {FaableApiError} `forbidden` (403) — The credentials are valid but do not allow this operation.
+     * @throws {FaableApiError} `user_suspended` (403) — The account is suspended. Contact support@faable.com.
+     * @throws {FaableApiError} `app_not_found` (404) — No app with that id or slug in this project.
+     * @throws {FaableApiError} `too_many_requests` (429) — Rate limit exceeded. Honour the `Retry-After` header.
+     * @throws {FaableApiError} `internal_error` (500) — Unexpected server error. Retry later; the request id is logged.
      */
     appSlug(slug: string): Promise<{
         id: string;
@@ -633,6 +832,15 @@ export declare abstract class GeneratedFaableDeployApi extends FaableApi {
      * `GET /app/{app_id}/traffic` — operationId: `app/traffic`
      *
      * Get App Traffic
+     *
+     * @throws {FaableApiError} `validation_error` (400) — The body, query or path failed schema validation. `details.issues` lists each failing field.
+     * @throws {FaableApiError} `unauthorized` (401) — The request carries no valid credentials.
+     * @throws {FaableApiError} `invalid_token` (401) — The bearer token is missing, malformed or expired.
+     * @throws {FaableApiError} `forbidden` (403) — The credentials are valid but do not allow this operation.
+     * @throws {FaableApiError} `user_suspended` (403) — The account is suspended. Contact support@faable.com.
+     * @throws {FaableApiError} `too_many_requests` (429) — Rate limit exceeded. Honour the `Retry-After` header.
+     * @throws {FaableApiError} `internal_error` (500) — Unexpected server error. Retry later; the request id is logged.
+     * @throws {FaableApiError} `metrics_unavailable` (503) — Traffic metrics are temporarily unavailable — this is not an app with no traffic.
      */
     appTraffic(app_id: string, params?: OpQuery<"app/traffic">): Promise<{
         range: {
@@ -694,6 +902,15 @@ export declare abstract class GeneratedFaableDeployApi extends FaableApi {
      * Unlink the GitHub repository from an app
      *
      * Unlink the GitHub repository from an app.
+     *
+     * @throws {FaableApiError} `validation_error` (400) — The body, query or path failed schema validation. `details.issues` lists each failing field.
+     * @throws {FaableApiError} `user_token_required` (401) — The endpoint acts on behalf of a person and the credential carries no user (an API key or a service account).
+     * @throws {FaableApiError} `unauthorized` (401) — The request carries no valid credentials.
+     * @throws {FaableApiError} `invalid_token` (401) — The bearer token is missing, malformed or expired.
+     * @throws {FaableApiError} `forbidden` (403) — The credentials are valid but do not allow this operation.
+     * @throws {FaableApiError} `user_suspended` (403) — The account is suspended. Contact support@faable.com.
+     * @throws {FaableApiError} `too_many_requests` (429) — Rate limit exceeded. Honour the `Retry-After` header.
+     * @throws {FaableApiError} `internal_error` (500) — Unexpected server error. Retry later; the request id is logged.
      */
     appUnlinkRepository(id: string): Promise<{
         id: string;
@@ -743,6 +960,18 @@ export declare abstract class GeneratedFaableDeployApi extends FaableApi {
      * `POST /app/{id}` — operationId: `app/update`
      *
      * Update App
+     *
+     * @throws {FaableApiError} `invalid_id` (400) — The id in the path is not a valid id for this resource.
+     * @throws {FaableApiError} `already_exists` (400) — A resource with the same unique field already exists. `details.fields` names the field.
+     * @throws {FaableApiError} `validation_error` (400) — The body, query or path failed schema validation. `details.issues` lists each failing field.
+     * @throws {FaableApiError} `access_denied` (401) — The row exists but does not belong to the caller.
+     * @throws {FaableApiError} `unauthorized` (401) — The request carries no valid credentials.
+     * @throws {FaableApiError} `invalid_token` (401) — The bearer token is missing, malformed or expired.
+     * @throws {FaableApiError} `forbidden` (403) — The credentials are valid but do not allow this operation.
+     * @throws {FaableApiError} `user_suspended` (403) — The account is suspended. Contact support@faable.com.
+     * @throws {FaableApiError} `not_found` (404) — The resource does not exist, or not in the caller’s project.
+     * @throws {FaableApiError} `too_many_requests` (429) — Rate limit exceeded. Honour the `Retry-After` header.
+     * @throws {FaableApiError} `internal_error` (500) — Unexpected server error. Retry later; the request id is logged.
      */
     appUpdate(id: string, data: OpBody<"app/update">): Promise<{
         id: string;
@@ -794,6 +1023,14 @@ export declare abstract class GeneratedFaableDeployApi extends FaableApi {
      * Get App WAF
      *
      * Get the WAF rules in effect for an App
+     *
+     * @throws {FaableApiError} `validation_error` (400) — The body, query or path failed schema validation. `details.issues` lists each failing field.
+     * @throws {FaableApiError} `unauthorized` (401) — The request carries no valid credentials.
+     * @throws {FaableApiError} `invalid_token` (401) — The bearer token is missing, malformed or expired.
+     * @throws {FaableApiError} `forbidden` (403) — The credentials are valid but do not allow this operation.
+     * @throws {FaableApiError} `user_suspended` (403) — The account is suspended. Contact support@faable.com.
+     * @throws {FaableApiError} `too_many_requests` (429) — Rate limit exceeded. Honour the `Retry-After` header.
+     * @throws {FaableApiError} `internal_error` (500) — Unexpected server error. Retry later; the request id is logged.
      */
     appWaf(app_id: string): Promise<{
         enabled: boolean;
@@ -824,6 +1061,16 @@ export declare abstract class GeneratedFaableDeployApi extends FaableApi {
      * Add App WAF Rule
      *
      * Add a WAF rule to an App
+     *
+     * @throws {FaableApiError} `bad_request` (400) — The request is malformed. `message` says what is wrong.
+     * @throws {FaableApiError} `validation_error` (400) — The body, query or path failed schema validation. `details.issues` lists each failing field.
+     * @throws {FaableApiError} `unauthorized` (401) — The request carries no valid credentials.
+     * @throws {FaableApiError} `invalid_token` (401) — The bearer token is missing, malformed or expired.
+     * @throws {FaableApiError} `forbidden` (403) — The credentials are valid but do not allow this operation.
+     * @throws {FaableApiError} `user_suspended` (403) — The account is suspended. Contact support@faable.com.
+     * @throws {FaableApiError} `conflict` (409) — The request conflicts with the current state of the resource.
+     * @throws {FaableApiError} `too_many_requests` (429) — Rate limit exceeded. Honour the `Retry-After` header.
+     * @throws {FaableApiError} `internal_error` (500) — Unexpected server error. Retry later; the request id is logged.
      */
     appWafAddRule(app_id: string, data: OpBody<"app/waf/addRule">): Promise<{
         enabled: boolean;
@@ -854,6 +1101,17 @@ export declare abstract class GeneratedFaableDeployApi extends FaableApi {
      * Remove App WAF Rule
      *
      * Remove a WAF rule from an App
+     *
+     * @throws {FaableApiError} `bad_request` (400) — The request is malformed. `message` says what is wrong.
+     * @throws {FaableApiError} `validation_error` (400) — The body, query or path failed schema validation. `details.issues` lists each failing field.
+     * @throws {FaableApiError} `unauthorized` (401) — The request carries no valid credentials.
+     * @throws {FaableApiError} `invalid_token` (401) — The bearer token is missing, malformed or expired.
+     * @throws {FaableApiError} `forbidden` (403) — The credentials are valid but do not allow this operation.
+     * @throws {FaableApiError} `user_suspended` (403) — The account is suspended. Contact support@faable.com.
+     * @throws {FaableApiError} `waf_rule_not_found` (404) — No WAF rule with that pattern on this app.
+     * @throws {FaableApiError} `conflict` (409) — The request conflicts with the current state of the resource.
+     * @throws {FaableApiError} `too_many_requests` (429) — Rate limit exceeded. Honour the `Retry-After` header.
+     * @throws {FaableApiError} `internal_error` (500) — Unexpected server error. Retry later; the request id is logged.
      */
     appWafRemoveRule(app_id: string, data: OpBody<"app/waf/removeRule">): Promise<{
         enabled: boolean;
@@ -884,6 +1142,17 @@ export declare abstract class GeneratedFaableDeployApi extends FaableApi {
      * Get the team's daily deploy quota status
      *
      * Daily deploy allowance of the current team: how much was used today, when it resets, and how many builds are held waiting for it.
+     *
+     * @throws {FaableApiError} `invalid_id` (400) — The id in the path is not a valid id for this resource.
+     * @throws {FaableApiError} `invalid_expand` (400) — An `?expand=` path is not allowed on this resource.
+     * @throws {FaableApiError} `access_denied` (401) — The row exists but does not belong to the caller.
+     * @throws {FaableApiError} `unauthorized` (401) — The request carries no valid credentials.
+     * @throws {FaableApiError} `invalid_token` (401) — The bearer token is missing, malformed or expired.
+     * @throws {FaableApiError} `forbidden` (403) — The credentials are valid but do not allow this operation.
+     * @throws {FaableApiError} `user_suspended` (403) — The account is suspended. Contact support@faable.com.
+     * @throws {FaableApiError} `not_found` (404) — The resource does not exist, or not in the caller’s project.
+     * @throws {FaableApiError} `too_many_requests` (429) — Rate limit exceeded. Honour the `Retry-After` header.
+     * @throws {FaableApiError} `internal_error` (500) — Unexpected server error. Retry later; the request id is logged.
      */
     deployQuotaGet(): Promise<{
         limited: boolean;
@@ -899,6 +1168,13 @@ export declare abstract class GeneratedFaableDeployApi extends FaableApi {
      * Roll out the builds held by the daily deploy quota
      *
      * Releases the team's held deployments if its current plan allows it (per app, only the newest held build rolls out; older ones are canceled). Safe to call at any time — it does nothing while the quota is still spent.
+     *
+     * @throws {FaableApiError} `unauthorized` (401) — The request carries no valid credentials.
+     * @throws {FaableApiError} `invalid_token` (401) — The bearer token is missing, malformed or expired.
+     * @throws {FaableApiError} `forbidden` (403) — The credentials are valid but do not allow this operation.
+     * @throws {FaableApiError} `user_suspended` (403) — The account is suspended. Contact support@faable.com.
+     * @throws {FaableApiError} `too_many_requests` (429) — Rate limit exceeded. Honour the `Retry-After` header.
+     * @throws {FaableApiError} `internal_error` (500) — Unexpected server error. Retry later; the request id is logged.
      */
     deployQuotaRelease(): Promise<{
         released: string[];
@@ -910,6 +1186,14 @@ export declare abstract class GeneratedFaableDeployApi extends FaableApi {
      * Cancel a queued or building deployment
      *
      * Cancel a deployment that has not been handed over to the controller yet (QUEUED or BUILDING)
+     *
+     * @throws {FaableApiError} `validation_error` (400) — The body, query or path failed schema validation. `details.issues` lists each failing field.
+     * @throws {FaableApiError} `unauthorized` (401) — The request carries no valid credentials.
+     * @throws {FaableApiError} `invalid_token` (401) — The bearer token is missing, malformed or expired.
+     * @throws {FaableApiError} `forbidden` (403) — The credentials are valid but do not allow this operation.
+     * @throws {FaableApiError} `user_suspended` (403) — The account is suspended. Contact support@faable.com.
+     * @throws {FaableApiError} `too_many_requests` (429) — Rate limit exceeded. Honour the `Retry-After` header.
+     * @throws {FaableApiError} `internal_error` (500) — Unexpected server error. Retry later; the request id is logged.
      */
     deploymentCancel(deployment_id: string): Promise<{
         id: string;
@@ -940,6 +1224,20 @@ export declare abstract class GeneratedFaableDeployApi extends FaableApi {
      * `POST /deployment` — operationId: `deployment/create`
      *
      * Create Deployment
+     *
+     * @throws {FaableApiError} `already_exists` (400) — A resource with the same unique field already exists. `details.fields` names the field.
+     * @throws {FaableApiError} `validation_error` (400) — The body, query or path failed schema validation. `details.issues` lists each failing field.
+     * @throws {FaableApiError} `team_required` (400) — The operation needs a project: send it in the `x-faable-team` header.
+     * @throws {FaableApiError} `unauthorized` (401) — The request carries no valid credentials.
+     * @throws {FaableApiError} `invalid_token` (401) — The bearer token is missing, malformed or expired.
+     * @throws {FaableApiError} `plan_required` (403) — The build or feature needs a higher plan. `message` says which.
+     * @throws {FaableApiError} `forbidden` (403) — The credentials are valid but do not allow this operation.
+     * @throws {FaableApiError} `user_suspended` (403) — The account is suspended. Contact support@faable.com.
+     * @throws {FaableApiError} `app_disabled` (409) — The app is disabled, so it cannot be deployed or provisioned. `message` says why when the reason is public.
+     * @throws {FaableApiError} `remote_build_disabled` (409) — Remote builds are off for this environment or this app. Deploy with a local build instead.
+     * @throws {FaableApiError} `deploy_refused` (409) — The deploy was refused by quota, plan or an in-flight deployment. `message` says which.
+     * @throws {FaableApiError} `too_many_requests` (429) — Rate limit exceeded. Honour the `Retry-After` header.
+     * @throws {FaableApiError} `internal_error` (500) — Unexpected server error. Retry later; the request id is logged.
      */
     deploymentCreate(data: OpBody<"deployment/create">): Promise<{
         id: string;
@@ -970,6 +1268,17 @@ export declare abstract class GeneratedFaableDeployApi extends FaableApi {
      * `DELETE /deployment/{id}` — operationId: `deployment/delete`
      *
      * Delete Deployment
+     *
+     * @throws {FaableApiError} `invalid_id` (400) — The id in the path is not a valid id for this resource.
+     * @throws {FaableApiError} `validation_error` (400) — The body, query or path failed schema validation. `details.issues` lists each failing field.
+     * @throws {FaableApiError} `access_denied` (401) — The row exists but does not belong to the caller.
+     * @throws {FaableApiError} `unauthorized` (401) — The request carries no valid credentials.
+     * @throws {FaableApiError} `invalid_token` (401) — The bearer token is missing, malformed or expired.
+     * @throws {FaableApiError} `forbidden` (403) — The credentials are valid but do not allow this operation.
+     * @throws {FaableApiError} `user_suspended` (403) — The account is suspended. Contact support@faable.com.
+     * @throws {FaableApiError} `not_found` (404) — The resource does not exist, or not in the caller’s project.
+     * @throws {FaableApiError} `too_many_requests` (429) — Rate limit exceeded. Honour the `Retry-After` header.
+     * @throws {FaableApiError} `internal_error` (500) — Unexpected server error. Retry later; the request id is logged.
      */
     deploymentDelete(id: string): Promise<{
         id: string;
@@ -1000,6 +1309,18 @@ export declare abstract class GeneratedFaableDeployApi extends FaableApi {
      * `GET /deployment/{id}` — operationId: `deployment/get`
      *
      * Get Deployment
+     *
+     * @throws {FaableApiError} `invalid_id` (400) — The id in the path is not a valid id for this resource.
+     * @throws {FaableApiError} `invalid_expand` (400) — An `?expand=` path is not allowed on this resource.
+     * @throws {FaableApiError} `validation_error` (400) — The body, query or path failed schema validation. `details.issues` lists each failing field.
+     * @throws {FaableApiError} `access_denied` (401) — The row exists but does not belong to the caller.
+     * @throws {FaableApiError} `unauthorized` (401) — The request carries no valid credentials.
+     * @throws {FaableApiError} `invalid_token` (401) — The bearer token is missing, malformed or expired.
+     * @throws {FaableApiError} `forbidden` (403) — The credentials are valid but do not allow this operation.
+     * @throws {FaableApiError} `user_suspended` (403) — The account is suspended. Contact support@faable.com.
+     * @throws {FaableApiError} `not_found` (404) — The resource does not exist, or not in the caller’s project.
+     * @throws {FaableApiError} `too_many_requests` (429) — Rate limit exceeded. Honour the `Retry-After` header.
+     * @throws {FaableApiError} `internal_error` (500) — Unexpected server error. Retry later; the request id is logged.
      */
     deploymentGet(id: string): Promise<{
         id: string;
@@ -1032,6 +1353,15 @@ export declare abstract class GeneratedFaableDeployApi extends FaableApi {
      * Get deployment build logs
      *
      * Get the CLI build/deploy output attached to a deployment
+     *
+     * @throws {FaableApiError} `validation_error` (400) — The body, query or path failed schema validation. `details.issues` lists each failing field.
+     * @throws {FaableApiError} `unauthorized` (401) — The request carries no valid credentials.
+     * @throws {FaableApiError} `invalid_token` (401) — The bearer token is missing, malformed or expired.
+     * @throws {FaableApiError} `forbidden` (403) — The credentials are valid but do not allow this operation.
+     * @throws {FaableApiError} `user_suspended` (403) — The account is suspended. Contact support@faable.com.
+     * @throws {FaableApiError} `not_found` (404) — The resource does not exist, or not in the caller’s project.
+     * @throws {FaableApiError} `too_many_requests` (429) — Rate limit exceeded. Honour the `Retry-After` header.
+     * @throws {FaableApiError} `internal_error` (500) — Unexpected server error. Retry later; the request id is logged.
      */
     deploymentGetLogs(deployment_id: string): Promise<{
         id: string;
@@ -1051,6 +1381,18 @@ export declare abstract class GeneratedFaableDeployApi extends FaableApi {
      * `GET /deployment` — operationId: `deployment/list`
      *
      * List Deployments
+     *
+     * @throws {FaableApiError} `invalid_query` (400) — The `?query=` FaableQL expression could not be parsed.
+     * @throws {FaableApiError} `invalid_expand` (400) — An `?expand=` path is not allowed on this resource.
+     * @throws {FaableApiError} `search_not_supported` (400) — This resource does not support `?q=`.
+     * @throws {FaableApiError} `validation_error` (400) — The body, query or path failed schema validation. `details.issues` lists each failing field.
+     * @throws {FaableApiError} `team_or_scope_required` (401) — Listing needs either a project in `x-faable-team` or a global scope on the token.
+     * @throws {FaableApiError} `unauthorized` (401) — The request carries no valid credentials.
+     * @throws {FaableApiError} `invalid_token` (401) — The bearer token is missing, malformed or expired.
+     * @throws {FaableApiError} `forbidden` (403) — The credentials are valid but do not allow this operation.
+     * @throws {FaableApiError} `user_suspended` (403) — The account is suspended. Contact support@faable.com.
+     * @throws {FaableApiError} `too_many_requests` (429) — Rate limit exceeded. Honour the `Retry-After` header.
+     * @throws {FaableApiError} `internal_error` (500) — Unexpected server error. Retry later; the request id is logged.
      */
     deploymentList(params?: Omit<OpQuery<"deployment/list">, "cursor" | "next">): {
         all: () => Promise<{
@@ -1136,6 +1478,18 @@ export declare abstract class GeneratedFaableDeployApi extends FaableApi {
      * `POST /deployment/{id}` — operationId: `deployment/update`
      *
      * Update Deployment
+     *
+     * @throws {FaableApiError} `invalid_id` (400) — The id in the path is not a valid id for this resource.
+     * @throws {FaableApiError} `already_exists` (400) — A resource with the same unique field already exists. `details.fields` names the field.
+     * @throws {FaableApiError} `validation_error` (400) — The body, query or path failed schema validation. `details.issues` lists each failing field.
+     * @throws {FaableApiError} `access_denied` (401) — The row exists but does not belong to the caller.
+     * @throws {FaableApiError} `unauthorized` (401) — The request carries no valid credentials.
+     * @throws {FaableApiError} `invalid_token` (401) — The bearer token is missing, malformed or expired.
+     * @throws {FaableApiError} `forbidden` (403) — The credentials are valid but do not allow this operation.
+     * @throws {FaableApiError} `user_suspended` (403) — The account is suspended. Contact support@faable.com.
+     * @throws {FaableApiError} `not_found` (404) — The resource does not exist, or not in the caller’s project.
+     * @throws {FaableApiError} `too_many_requests` (429) — Rate limit exceeded. Honour the `Retry-After` header.
+     * @throws {FaableApiError} `internal_error` (500) — Unexpected server error. Retry later; the request id is logged.
      */
     deploymentUpdate(id: string, data: OpBody<"deployment/update">): Promise<{
         id: string;
@@ -1166,6 +1520,19 @@ export declare abstract class GeneratedFaableDeployApi extends FaableApi {
      * `POST /domain` — operationId: `domain/create`
      *
      * Create Domain
+     *
+     * @throws {FaableApiError} `already_exists` (400) — A resource with the same unique field already exists. `details.fields` names the field.
+     * @throws {FaableApiError} `validation_error` (400) — The body, query or path failed schema validation. `details.issues` lists each failing field.
+     * @throws {FaableApiError} `team_required` (400) — The operation needs a project: send it in the `x-faable-team` header.
+     * @throws {FaableApiError} `domain_invalid` (400) — Not a valid hostname. No protocol, port or path.
+     * @throws {FaableApiError} `unauthorized` (401) — The request carries no valid credentials.
+     * @throws {FaableApiError} `invalid_token` (401) — The bearer token is missing, malformed or expired.
+     * @throws {FaableApiError} `domain_reserved` (403) — Hostnames under that domain are assigned by Faable.
+     * @throws {FaableApiError} `forbidden` (403) — The credentials are valid but do not allow this operation.
+     * @throws {FaableApiError} `user_suspended` (403) — The account is suspended. Contact support@faable.com.
+     * @throws {FaableApiError} `domain_taken` (409) — That hostname is already registered on Faable.
+     * @throws {FaableApiError} `too_many_requests` (429) — Rate limit exceeded. Honour the `Retry-After` header.
+     * @throws {FaableApiError} `internal_error` (500) — Unexpected server error. Retry later; the request id is logged.
      */
     domainCreate(data: OpBody<"domain/create">): Promise<{
         id: string;
@@ -1187,6 +1554,17 @@ export declare abstract class GeneratedFaableDeployApi extends FaableApi {
      * `DELETE /domain/{id}` — operationId: `domain/delete`
      *
      * Delete Domain
+     *
+     * @throws {FaableApiError} `invalid_id` (400) — The id in the path is not a valid id for this resource.
+     * @throws {FaableApiError} `validation_error` (400) — The body, query or path failed schema validation. `details.issues` lists each failing field.
+     * @throws {FaableApiError} `access_denied` (401) — The row exists but does not belong to the caller.
+     * @throws {FaableApiError} `unauthorized` (401) — The request carries no valid credentials.
+     * @throws {FaableApiError} `invalid_token` (401) — The bearer token is missing, malformed or expired.
+     * @throws {FaableApiError} `forbidden` (403) — The credentials are valid but do not allow this operation.
+     * @throws {FaableApiError} `user_suspended` (403) — The account is suspended. Contact support@faable.com.
+     * @throws {FaableApiError} `not_found` (404) — The resource does not exist, or not in the caller’s project.
+     * @throws {FaableApiError} `too_many_requests` (429) — Rate limit exceeded. Honour the `Retry-After` header.
+     * @throws {FaableApiError} `internal_error` (500) — Unexpected server error. Retry later; the request id is logged.
      */
     domainDelete(id: string): Promise<{
         id: string;
@@ -1208,6 +1586,14 @@ export declare abstract class GeneratedFaableDeployApi extends FaableApi {
      * `GET /domain/fqdn/{fqdn}` — operationId: `domain/fqdn`
      *
      * Get domain by FQDN
+     *
+     * @throws {FaableApiError} `validation_error` (400) — The body, query or path failed schema validation. `details.issues` lists each failing field.
+     * @throws {FaableApiError} `unauthorized` (401) — The request carries no valid credentials.
+     * @throws {FaableApiError} `invalid_token` (401) — The bearer token is missing, malformed or expired.
+     * @throws {FaableApiError} `forbidden` (403) — The credentials are valid but do not allow this operation.
+     * @throws {FaableApiError} `user_suspended` (403) — The account is suspended. Contact support@faable.com.
+     * @throws {FaableApiError} `too_many_requests` (429) — Rate limit exceeded. Honour the `Retry-After` header.
+     * @throws {FaableApiError} `internal_error` (500) — Unexpected server error. Retry later; the request id is logged.
      */
     domainFqdn(fqdn: string): Promise<{
         id: string;
@@ -1229,6 +1615,18 @@ export declare abstract class GeneratedFaableDeployApi extends FaableApi {
      * `GET /domain/{id}` — operationId: `domain/get`
      *
      * Get Domain
+     *
+     * @throws {FaableApiError} `invalid_id` (400) — The id in the path is not a valid id for this resource.
+     * @throws {FaableApiError} `invalid_expand` (400) — An `?expand=` path is not allowed on this resource.
+     * @throws {FaableApiError} `validation_error` (400) — The body, query or path failed schema validation. `details.issues` lists each failing field.
+     * @throws {FaableApiError} `access_denied` (401) — The row exists but does not belong to the caller.
+     * @throws {FaableApiError} `unauthorized` (401) — The request carries no valid credentials.
+     * @throws {FaableApiError} `invalid_token` (401) — The bearer token is missing, malformed or expired.
+     * @throws {FaableApiError} `forbidden` (403) — The credentials are valid but do not allow this operation.
+     * @throws {FaableApiError} `user_suspended` (403) — The account is suspended. Contact support@faable.com.
+     * @throws {FaableApiError} `not_found` (404) — The resource does not exist, or not in the caller’s project.
+     * @throws {FaableApiError} `too_many_requests` (429) — Rate limit exceeded. Honour the `Retry-After` header.
+     * @throws {FaableApiError} `internal_error` (500) — Unexpected server error. Retry later; the request id is logged.
      */
     domainGet(id: string): Promise<{
         id: string;
@@ -1250,6 +1648,18 @@ export declare abstract class GeneratedFaableDeployApi extends FaableApi {
      * `GET /domain` — operationId: `domain/list`
      *
      * List Domains
+     *
+     * @throws {FaableApiError} `invalid_query` (400) — The `?query=` FaableQL expression could not be parsed.
+     * @throws {FaableApiError} `invalid_expand` (400) — An `?expand=` path is not allowed on this resource.
+     * @throws {FaableApiError} `search_not_supported` (400) — This resource does not support `?q=`.
+     * @throws {FaableApiError} `validation_error` (400) — The body, query or path failed schema validation. `details.issues` lists each failing field.
+     * @throws {FaableApiError} `team_or_scope_required` (401) — Listing needs either a project in `x-faable-team` or a global scope on the token.
+     * @throws {FaableApiError} `unauthorized` (401) — The request carries no valid credentials.
+     * @throws {FaableApiError} `invalid_token` (401) — The bearer token is missing, malformed or expired.
+     * @throws {FaableApiError} `forbidden` (403) — The credentials are valid but do not allow this operation.
+     * @throws {FaableApiError} `user_suspended` (403) — The account is suspended. Contact support@faable.com.
+     * @throws {FaableApiError} `too_many_requests` (429) — Rate limit exceeded. Honour the `Retry-After` header.
+     * @throws {FaableApiError} `internal_error` (500) — Unexpected server error. Retry later; the request id is logged.
      */
     domainList(params?: Omit<OpQuery<"domain/list">, "cursor" | "next">): {
         all: () => Promise<{
@@ -1308,6 +1718,18 @@ export declare abstract class GeneratedFaableDeployApi extends FaableApi {
      * `POST /domain/{id}` — operationId: `domain/update`
      *
      * Update Domain
+     *
+     * @throws {FaableApiError} `invalid_id` (400) — The id in the path is not a valid id for this resource.
+     * @throws {FaableApiError} `already_exists` (400) — A resource with the same unique field already exists. `details.fields` names the field.
+     * @throws {FaableApiError} `validation_error` (400) — The body, query or path failed schema validation. `details.issues` lists each failing field.
+     * @throws {FaableApiError} `access_denied` (401) — The row exists but does not belong to the caller.
+     * @throws {FaableApiError} `unauthorized` (401) — The request carries no valid credentials.
+     * @throws {FaableApiError} `invalid_token` (401) — The bearer token is missing, malformed or expired.
+     * @throws {FaableApiError} `forbidden` (403) — The credentials are valid but do not allow this operation.
+     * @throws {FaableApiError} `user_suspended` (403) — The account is suspended. Contact support@faable.com.
+     * @throws {FaableApiError} `not_found` (404) — The resource does not exist, or not in the caller’s project.
+     * @throws {FaableApiError} `too_many_requests` (429) — Rate limit exceeded. Honour the `Retry-After` header.
+     * @throws {FaableApiError} `internal_error` (500) — Unexpected server error. Retry later; the request id is logged.
      */
     domainUpdate(id: string, data: OpBody<"domain/update">): Promise<{
         id: string;
@@ -1329,6 +1751,18 @@ export declare abstract class GeneratedFaableDeployApi extends FaableApi {
      * `POST /project` — operationId: `project/create`
      *
      * Create Project
+     *
+     * @throws {FaableApiError} `already_exists` (400) — A resource with the same unique field already exists. `details.fields` names the field.
+     * @throws {FaableApiError} `validation_error` (400) — The body, query or path failed schema validation. `details.issues` lists each failing field.
+     * @throws {FaableApiError} `team_required` (400) — The operation needs a project: send it in the `x-faable-team` header.
+     * @throws {FaableApiError} `unauthorized` (401) — The request carries no valid credentials.
+     * @throws {FaableApiError} `invalid_token` (401) — The bearer token is missing, malformed or expired.
+     * @throws {FaableApiError} `project_plan_limited` (402) — The Free plan project cap is reached. Upgrade to create more.
+     * @throws {FaableApiError} `user_suspended` (403) — The account is suspended. Contact support@faable.com.
+     * @throws {FaableApiError} `forbidden` (403) — The credentials are valid but do not allow this operation.
+     * @throws {FaableApiError} `project_rate_limited` (429) — A new account may only create a few projects in its first hours. It opens with time, or with a plan.
+     * @throws {FaableApiError} `too_many_requests` (429) — Rate limit exceeded. Honour the `Retry-After` header.
+     * @throws {FaableApiError} `internal_error` (500) — Unexpected server error. Retry later; the request id is logged.
      */
     projectCreate(data: OpBody<"project/create">): Promise<{
         id: string;
@@ -1348,6 +1782,18 @@ export declare abstract class GeneratedFaableDeployApi extends FaableApi {
      * `DELETE /project/{id}` — operationId: `project/delete`
      *
      * Delete Project
+     *
+     * @throws {FaableApiError} `invalid_id` (400) — The id in the path is not a valid id for this resource.
+     * @throws {FaableApiError} `validation_error` (400) — The body, query or path failed schema validation. `details.issues` lists each failing field.
+     * @throws {FaableApiError} `access_denied` (401) — The row exists but does not belong to the caller.
+     * @throws {FaableApiError} `unauthorized` (401) — The request carries no valid credentials.
+     * @throws {FaableApiError} `invalid_token` (401) — The bearer token is missing, malformed or expired.
+     * @throws {FaableApiError} `moderation_hold` (403) — The project contains an app disabled by moderation and cannot be deleted. Contact support@faable.com.
+     * @throws {FaableApiError} `user_suspended` (403) — The account is suspended. Contact support@faable.com.
+     * @throws {FaableApiError} `forbidden` (403) — The credentials are valid but do not allow this operation.
+     * @throws {FaableApiError} `not_found` (404) — The resource does not exist, or not in the caller’s project.
+     * @throws {FaableApiError} `too_many_requests` (429) — Rate limit exceeded. Honour the `Retry-After` header.
+     * @throws {FaableApiError} `internal_error` (500) — Unexpected server error. Retry later; the request id is logged.
      */
     projectDelete(id: string): Promise<{
         id: string;
@@ -1367,6 +1813,18 @@ export declare abstract class GeneratedFaableDeployApi extends FaableApi {
      * `GET /project/{id}` — operationId: `project/get`
      *
      * Get Project
+     *
+     * @throws {FaableApiError} `invalid_id` (400) — The id in the path is not a valid id for this resource.
+     * @throws {FaableApiError} `invalid_expand` (400) — An `?expand=` path is not allowed on this resource.
+     * @throws {FaableApiError} `validation_error` (400) — The body, query or path failed schema validation. `details.issues` lists each failing field.
+     * @throws {FaableApiError} `access_denied` (401) — The row exists but does not belong to the caller.
+     * @throws {FaableApiError} `unauthorized` (401) — The request carries no valid credentials.
+     * @throws {FaableApiError} `invalid_token` (401) — The bearer token is missing, malformed or expired.
+     * @throws {FaableApiError} `forbidden` (403) — The credentials are valid but do not allow this operation.
+     * @throws {FaableApiError} `user_suspended` (403) — The account is suspended. Contact support@faable.com.
+     * @throws {FaableApiError} `not_found` (404) — The resource does not exist, or not in the caller’s project.
+     * @throws {FaableApiError} `too_many_requests` (429) — Rate limit exceeded. Honour the `Retry-After` header.
+     * @throws {FaableApiError} `internal_error` (500) — Unexpected server error. Retry later; the request id is logged.
      */
     projectGet(id: string): Promise<{
         id: string;
@@ -1386,6 +1844,15 @@ export declare abstract class GeneratedFaableDeployApi extends FaableApi {
      * `POST /project/{id}/invite` — operationId: `project/invite`
      *
      * Invite collaborators to project
+     *
+     * @throws {FaableApiError} `validation_error` (400) — The body, query or path failed schema validation. `details.issues` lists each failing field.
+     * @throws {FaableApiError} `unauthorized` (401) — The request carries no valid credentials.
+     * @throws {FaableApiError} `invalid_token` (401) — The bearer token is missing, malformed or expired.
+     * @throws {FaableApiError} `forbidden` (403) — The credentials are valid but do not allow this operation.
+     * @throws {FaableApiError} `user_suspended` (403) — The account is suspended. Contact support@faable.com.
+     * @throws {FaableApiError} `project_not_found` (404) — No project with that id for this caller.
+     * @throws {FaableApiError} `too_many_requests` (429) — Rate limit exceeded. Honour the `Retry-After` header.
+     * @throws {FaableApiError} `internal_error` (500) — Unexpected server error. Retry later; the request id is logged.
      */
     projectInvite(id: string, data: OpBody<"project/invite">): Promise<{
         project: import("./types.js").components["schemas"]["Project"];
@@ -1401,6 +1868,14 @@ export declare abstract class GeneratedFaableDeployApi extends FaableApi {
      * Project creation limits for the caller
      *
      * Whether the caller can create another project, and why not
+     *
+     * @throws {FaableApiError} `unauthorized` (401) — The request carries no valid credentials.
+     * @throws {FaableApiError} `invalid_token` (401) — The bearer token is missing, malformed or expired.
+     * @throws {FaableApiError} `owner_only` (403) — Only the project owner can manage collaborators.
+     * @throws {FaableApiError} `forbidden` (403) — The credentials are valid but do not allow this operation.
+     * @throws {FaableApiError} `user_suspended` (403) — The account is suspended. Contact support@faable.com.
+     * @throws {FaableApiError} `too_many_requests` (429) — Rate limit exceeded. Honour the `Retry-After` header.
+     * @throws {FaableApiError} `internal_error` (500) — Unexpected server error. Retry later; the request id is logged.
      */
     projectLimits(): Promise<{
         can_create: boolean;
@@ -1419,6 +1894,18 @@ export declare abstract class GeneratedFaableDeployApi extends FaableApi {
      * `GET /project` — operationId: `project/list`
      *
      * List Projects
+     *
+     * @throws {FaableApiError} `invalid_query` (400) — The `?query=` FaableQL expression could not be parsed.
+     * @throws {FaableApiError} `invalid_expand` (400) — An `?expand=` path is not allowed on this resource.
+     * @throws {FaableApiError} `search_not_supported` (400) — This resource does not support `?q=`.
+     * @throws {FaableApiError} `validation_error` (400) — The body, query or path failed schema validation. `details.issues` lists each failing field.
+     * @throws {FaableApiError} `team_or_scope_required` (401) — Listing needs either a project in `x-faable-team` or a global scope on the token.
+     * @throws {FaableApiError} `unauthorized` (401) — The request carries no valid credentials.
+     * @throws {FaableApiError} `invalid_token` (401) — The bearer token is missing, malformed or expired.
+     * @throws {FaableApiError} `forbidden` (403) — The credentials are valid but do not allow this operation.
+     * @throws {FaableApiError} `user_suspended` (403) — The account is suspended. Contact support@faable.com.
+     * @throws {FaableApiError} `too_many_requests` (429) — Rate limit exceeded. Honour the `Retry-After` header.
+     * @throws {FaableApiError} `internal_error` (500) — Unexpected server error. Retry later; the request id is logged.
      */
     projectList(params?: Omit<OpQuery<"project/list">, "cursor" | "next">): {
         all: () => Promise<{
@@ -1471,6 +1958,18 @@ export declare abstract class GeneratedFaableDeployApi extends FaableApi {
      * `DELETE /project/{id}/collaborator/{user_id}` — operationId: `project/removeCollaborator`
      *
      * Remove a collaborator from a project
+     *
+     * @throws {FaableApiError} `owner_not_removable` (400) — The project owner cannot be removed. Delete the project instead.
+     * @throws {FaableApiError} `validation_error` (400) — The body, query or path failed schema validation. `details.issues` lists each failing field.
+     * @throws {FaableApiError} `unauthorized` (401) — The request carries no valid credentials.
+     * @throws {FaableApiError} `invalid_token` (401) — The bearer token is missing, malformed or expired.
+     * @throws {FaableApiError} `superadmin_only` (403) — The operation is restricted to platform staff.
+     * @throws {FaableApiError} `forbidden` (403) — The credentials are valid but do not allow this operation.
+     * @throws {FaableApiError} `user_suspended` (403) — The account is suspended. Contact support@faable.com.
+     * @throws {FaableApiError} `collaborator_not_found` (404) — That user is not a collaborator on the project.
+     * @throws {FaableApiError} `project_not_found` (404) — No project with that id for this caller.
+     * @throws {FaableApiError} `too_many_requests` (429) — Rate limit exceeded. Honour the `Retry-After` header.
+     * @throws {FaableApiError} `internal_error` (500) — Unexpected server error. Retry later; the request id is logged.
      */
     projectRemoveCollaborator(id: string, user_id: string): Promise<{
         id: string;
@@ -1490,6 +1989,18 @@ export declare abstract class GeneratedFaableDeployApi extends FaableApi {
      * `POST /project/{id}` — operationId: `project/update`
      *
      * Update Project
+     *
+     * @throws {FaableApiError} `invalid_id` (400) — The id in the path is not a valid id for this resource.
+     * @throws {FaableApiError} `already_exists` (400) — A resource with the same unique field already exists. `details.fields` names the field.
+     * @throws {FaableApiError} `validation_error` (400) — The body, query or path failed schema validation. `details.issues` lists each failing field.
+     * @throws {FaableApiError} `access_denied` (401) — The row exists but does not belong to the caller.
+     * @throws {FaableApiError} `unauthorized` (401) — The request carries no valid credentials.
+     * @throws {FaableApiError} `invalid_token` (401) — The bearer token is missing, malformed or expired.
+     * @throws {FaableApiError} `forbidden` (403) — The credentials are valid but do not allow this operation.
+     * @throws {FaableApiError} `user_suspended` (403) — The account is suspended. Contact support@faable.com.
+     * @throws {FaableApiError} `not_found` (404) — The resource does not exist, or not in the caller’s project.
+     * @throws {FaableApiError} `too_many_requests` (429) — Rate limit exceeded. Honour the `Retry-After` header.
+     * @throws {FaableApiError} `internal_error` (500) — Unexpected server error. Retry later; the request id is logged.
      */
     projectUpdate(id: string, data: OpBody<"project/update">): Promise<{
         id: string;
@@ -1511,6 +2022,14 @@ export declare abstract class GeneratedFaableDeployApi extends FaableApi {
      * Create secrets in batch
      *
      * Create a secrets in batch
+     *
+     * @throws {FaableApiError} `validation_error` (400) — The body, query or path failed schema validation. `details.issues` lists each failing field.
+     * @throws {FaableApiError} `unauthorized` (401) — The request carries no valid credentials.
+     * @throws {FaableApiError} `invalid_token` (401) — The bearer token is missing, malformed or expired.
+     * @throws {FaableApiError} `forbidden` (403) — The credentials are valid but do not allow this operation.
+     * @throws {FaableApiError} `user_suspended` (403) — The account is suspended. Contact support@faable.com.
+     * @throws {FaableApiError} `too_many_requests` (429) — Rate limit exceeded. Honour the `Retry-After` header.
+     * @throws {FaableApiError} `internal_error` (500) — Unexpected server error. Retry later; the request id is logged.
      */
     secretsCreateBatch(data: OpBody<"secrets/create_batch">): Promise<{
         id: string;
@@ -1531,6 +2050,17 @@ export declare abstract class GeneratedFaableDeployApi extends FaableApi {
      * `DELETE /secret/{secret_id}` — operationId: `secrets/delete`
      *
      * Delete a secret
+     *
+     * @throws {FaableApiError} `invalid_id` (400) — The id in the path is not a valid id for this resource.
+     * @throws {FaableApiError} `validation_error` (400) — The body, query or path failed schema validation. `details.issues` lists each failing field.
+     * @throws {FaableApiError} `access_denied` (401) — The row exists but does not belong to the caller.
+     * @throws {FaableApiError} `unauthorized` (401) — The request carries no valid credentials.
+     * @throws {FaableApiError} `invalid_token` (401) — The bearer token is missing, malformed or expired.
+     * @throws {FaableApiError} `forbidden` (403) — The credentials are valid but do not allow this operation.
+     * @throws {FaableApiError} `user_suspended` (403) — The account is suspended. Contact support@faable.com.
+     * @throws {FaableApiError} `not_found` (404) — The resource does not exist, or not in the caller’s project.
+     * @throws {FaableApiError} `too_many_requests` (429) — Rate limit exceeded. Honour the `Retry-After` header.
+     * @throws {FaableApiError} `internal_error` (500) — Unexpected server error. Retry later; the request id is logged.
      */
     secretsDelete(secret_id: string): Promise<void>;
     /**
@@ -1539,6 +2069,14 @@ export declare abstract class GeneratedFaableDeployApi extends FaableApi {
      * List all secrets assigned to an App or Profile contexts
      *
      * List all app secrets assigned to an App or Profile contexts
+     *
+     * @throws {FaableApiError} `validation_error` (400) — The body, query or path failed schema validation. `details.issues` lists each failing field.
+     * @throws {FaableApiError} `unauthorized` (401) — The request carries no valid credentials.
+     * @throws {FaableApiError} `invalid_token` (401) — The bearer token is missing, malformed or expired.
+     * @throws {FaableApiError} `forbidden` (403) — The credentials are valid but do not allow this operation.
+     * @throws {FaableApiError} `user_suspended` (403) — The account is suspended. Contact support@faable.com.
+     * @throws {FaableApiError} `too_many_requests` (429) — Rate limit exceeded. Honour the `Retry-After` header.
+     * @throws {FaableApiError} `internal_error` (500) — Unexpected server error. Retry later; the request id is logged.
      */
     secretsListApp(context_id: string, params?: OpQuery<"secrets/list_app">): Promise<{
         next: string | null;
@@ -1548,6 +2086,14 @@ export declare abstract class GeneratedFaableDeployApi extends FaableApi {
      * `POST /secret` — operationId: `secrets/upsert`
      *
      * Upsert a secret
+     *
+     * @throws {FaableApiError} `validation_error` (400) — The body, query or path failed schema validation. `details.issues` lists each failing field.
+     * @throws {FaableApiError} `unauthorized` (401) — The request carries no valid credentials.
+     * @throws {FaableApiError} `invalid_token` (401) — The bearer token is missing, malformed or expired.
+     * @throws {FaableApiError} `forbidden` (403) — The credentials are valid but do not allow this operation.
+     * @throws {FaableApiError} `user_suspended` (403) — The account is suspended. Contact support@faable.com.
+     * @throws {FaableApiError} `too_many_requests` (429) — Rate limit exceeded. Honour the `Retry-After` header.
+     * @throws {FaableApiError} `internal_error` (500) — Unexpected server error. Retry later; the request id is logged.
      */
     secretsUpsert(data: OpBody<"secrets/upsert">): Promise<{
         id: string;
@@ -1568,6 +2114,14 @@ export declare abstract class GeneratedFaableDeployApi extends FaableApi {
      * `GET /usage/summary` — operationId: `usage/summary`
      *
      * Get team usage summary for the current billing period
+     *
+     * @throws {FaableApiError} `validation_error` (400) — The body, query or path failed schema validation. `details.issues` lists each failing field.
+     * @throws {FaableApiError} `unauthorized` (401) — The request carries no valid credentials.
+     * @throws {FaableApiError} `invalid_token` (401) — The bearer token is missing, malformed or expired.
+     * @throws {FaableApiError} `forbidden` (403) — The credentials are valid but do not allow this operation.
+     * @throws {FaableApiError} `user_suspended` (403) — The account is suspended. Contact support@faable.com.
+     * @throws {FaableApiError} `too_many_requests` (429) — Rate limit exceeded. Honour the `Retry-After` header.
+     * @throws {FaableApiError} `internal_error` (500) — Unexpected server error. Retry later; the request id is logged.
      */
     usageSummary(params?: OpQuery<"usage/summary">): Promise<{
         resources: {
@@ -1607,6 +2161,13 @@ export declare abstract class GeneratedFaableDeployApi extends FaableApi {
      * `GET /usage/traffic` — operationId: `usage/traffic`
      *
      * Get metered traffic usage per team for the current period
+     *
+     * @throws {FaableApiError} `unauthorized` (401) — The request carries no valid credentials.
+     * @throws {FaableApiError} `invalid_token` (401) — The bearer token is missing, malformed or expired.
+     * @throws {FaableApiError} `forbidden` (403) — The credentials are valid but do not allow this operation.
+     * @throws {FaableApiError} `user_suspended` (403) — The account is suspended. Contact support@faable.com.
+     * @throws {FaableApiError} `too_many_requests` (429) — Rate limit exceeded. Honour the `Retry-After` header.
+     * @throws {FaableApiError} `internal_error` (500) — Unexpected server error. Retry later; the request id is logged.
      */
     usageTraffic(): Promise<{
         traffic: {