OpenVibe.Host API
Generated at from
openvibe-contracts v0.53.0 and
openvibe-sdk v0.11.0.
Server https://openvibe.host. 27 routes performing 3 capabilities. OpenAPI 3.1 document.
GET /api/v1/deploys/{id}
Upload an immutable static deploy (tar/tar.gz or multipart files; validated for path traversal, links, special and hidden files, server-side code, file types and quotas; never executed), list deploys
- Capabilities
- host.deploy.create
- Visibility
- first-party
- Parameters
id(path, required)
- Input
- host.deploy-create-request@1
- Response
application/jsonhost.deploy-create-result@1- Errors
- errors.problem@1 (application/problem+json)
Description
<p><strong>host.deploy.create</strong> (first-party): Upload an immutable static deploy (tar/tar.gz or multipart files; validated for path traversal, links, special and hidden files, server-side code, file types and quotas; never executed), list deploys and their upload logs, activate a deploy and roll a site back to any earlier ready deploy (one atomic pointer switch). Also judged by the acting principal's project role (deployer or above); an app principal added to a project as deployer can deploy from CI.</p>DELETE /api/v1/deploys/{id}
Manage OpenVibe.Host tenant projects and static sites: create a project (owned by the person named with X-OV-Subject; apps cannot own projects), read projects, quotas and usage, manage members (owner
- Capabilities
- host.site.manage
- Visibility
- first-party
- Parameters
id(path, required)
- Input
- host.site-manage-request@1
- Response
application/jsonhost.site-manage-result@1- Errors
- errors.problem@1 (application/problem+json)
Description
<p><strong>host.site.manage</strong> (first-party): Manage OpenVibe.Host tenant projects and static sites: create a project (owned by the person named with X-OV-Subject; apps cannot own projects), read projects, quotas and usage, manage members (owner role), create and delete sites, delete a deploy that is not active. Also judged by the acting principal's project role; a sandbox token (env=sandbox) is refused on production projects. Quota changes and takedowns (stop serving a site or a whole project while keeping its content for review; lift) additionally need a Network staff user.</p>POST /api/v1/deploys/{id}/activate
Upload an immutable static deploy (tar/tar.gz or multipart files; validated for path traversal, links, special and hidden files, server-side code, file types and quotas; never executed), list deploys
- Capabilities
- host.deploy.create
- Visibility
- first-party
- Parameters
id(path, required)
- Request body
application/jsonhost.deploy-create-request@1- Response
application/jsonhost.deploy-create-result@1- Errors
- errors.problem@1 (application/problem+json)
Description
<p><strong>host.deploy.create</strong> (first-party): Upload an immutable static deploy (tar/tar.gz or multipart files; validated for path traversal, links, special and hidden files, server-side code, file types and quotas; never executed), list deploys and their upload logs, activate a deploy and roll a site back to any earlier ready deploy (one atomic pointer switch). Also judged by the acting principal's project role (deployer or above); an app principal added to a project as deployer can deploy from CI.</p>GET /api/v1/deploys/{id}/log
Upload an immutable static deploy (tar/tar.gz or multipart files; validated for path traversal, links, special and hidden files, server-side code, file types and quotas; never executed), list deploys
- Capabilities
- host.deploy.create
- Visibility
- first-party
- Parameters
id(path, required)
- Input
- host.deploy-create-request@1
- Response
application/jsonhost.deploy-create-result@1- Errors
- errors.problem@1 (application/problem+json)
Description
<p><strong>host.deploy.create</strong> (first-party): Upload an immutable static deploy (tar/tar.gz or multipart files; validated for path traversal, links, special and hidden files, server-side code, file types and quotas; never executed), list deploys and their upload logs, activate a deploy and roll a site back to any earlier ready deploy (one atomic pointer switch). Also judged by the acting principal's project role (deployer or above); an app principal added to a project as deployer can deploy from CI.</p>DELETE /api/v1/domains/{id}
Add a custom domain to a static site (never an OpenVibe domain; not in sandbox projects), read its DNS TXT verification and routing records, trigger a verification check, and remove it.
- Capabilities
- host.domain.manage
- Visibility
- first-party
- Parameters
id(path, required)
- Input
- host.domain-manage-request@1
- Response
application/jsonhost.domain-manage-result@1- Errors
- errors.problem@1 (application/problem+json)
Description
<p><strong>host.domain.manage</strong> (first-party): Add a custom domain to a static site (never an OpenVibe domain; not in sandbox projects), read its DNS TXT verification and routing records, trigger a verification check, and remove it. A custom domain is served only after its TXT record is verified; TLS certificates are issued by an operator and never pass through this capability.</p>POST /api/v1/domains/{id}/verify
Add a custom domain to a static site (never an OpenVibe domain; not in sandbox projects), read its DNS TXT verification and routing records, trigger a verification check, and remove it.
- Capabilities
- host.domain.manage
- Visibility
- first-party
- Parameters
id(path, required)
- Request body
application/jsonhost.domain-manage-request@1- Response
application/jsonhost.domain-manage-result@1- Errors
- errors.problem@1 (application/problem+json)
Description
<p><strong>host.domain.manage</strong> (first-party): Add a custom domain to a static site (never an OpenVibe domain; not in sandbox projects), read its DNS TXT verification and routing records, trigger a verification check, and remove it. A custom domain is served only after its TXT record is verified; TLS certificates are issued by an operator and never pass through this capability.</p>GET /api/v1/projects
Manage OpenVibe.Host tenant projects and static sites: create a project (owned by the person named with X-OV-Subject; apps cannot own projects), read projects, quotas and usage, manage members (owner
- Capabilities
- host.site.manage
- Visibility
- first-party
- Input
- host.site-manage-request@1
- Response
application/jsonhost.site-manage-result@1- Errors
- errors.problem@1 (application/problem+json)
Description
<p><strong>host.site.manage</strong> (first-party): Manage OpenVibe.Host tenant projects and static sites: create a project (owned by the person named with X-OV-Subject; apps cannot own projects), read projects, quotas and usage, manage members (owner role), create and delete sites, delete a deploy that is not active. Also judged by the acting principal's project role; a sandbox token (env=sandbox) is refused on production projects. Quota changes and takedowns (stop serving a site or a whole project while keeping its content for review; lift) additionally need a Network staff user.</p>POST /api/v1/projects
Manage OpenVibe.Host tenant projects and static sites: create a project (owned by the person named with X-OV-Subject; apps cannot own projects), read projects, quotas and usage, manage members (owner
- Capabilities
- host.site.manage
- Visibility
- first-party
- Request body
application/jsonhost.site-manage-request@1- Response
application/jsonhost.site-manage-result@1- Errors
- errors.problem@1 (application/problem+json)
Description
<p><strong>host.site.manage</strong> (first-party): Manage OpenVibe.Host tenant projects and static sites: create a project (owned by the person named with X-OV-Subject; apps cannot own projects), read projects, quotas and usage, manage members (owner role), create and delete sites, delete a deploy that is not active. Also judged by the acting principal's project role; a sandbox token (env=sandbox) is refused on production projects. Quota changes and takedowns (stop serving a site or a whole project while keeping its content for review; lift) additionally need a Network staff user.</p>GET /api/v1/projects/{id}
Manage OpenVibe.Host tenant projects and static sites: create a project (owned by the person named with X-OV-Subject; apps cannot own projects), read projects, quotas and usage, manage members (owner
- Capabilities
- host.site.manage
- Visibility
- first-party
- Parameters
id(path, required)
- Input
- host.site-manage-request@1
- Response
application/jsonhost.site-manage-result@1- Errors
- errors.problem@1 (application/problem+json)
Description
<p><strong>host.site.manage</strong> (first-party): Manage OpenVibe.Host tenant projects and static sites: create a project (owned by the person named with X-OV-Subject; apps cannot own projects), read projects, quotas and usage, manage members (owner role), create and delete sites, delete a deploy that is not active. Also judged by the acting principal's project role; a sandbox token (env=sandbox) is refused on production projects. Quota changes and takedowns (stop serving a site or a whole project while keeping its content for review; lift) additionally need a Network staff user.</p>DELETE /api/v1/projects/{id}
Manage OpenVibe.Host tenant projects and static sites: create a project (owned by the person named with X-OV-Subject; apps cannot own projects), read projects, quotas and usage, manage members (owner
- Capabilities
- host.site.manage
- Visibility
- first-party
- Parameters
id(path, required)
- Input
- host.site-manage-request@1
- Response
application/jsonhost.site-manage-result@1- Errors
- errors.problem@1 (application/problem+json)
Description
<p><strong>host.site.manage</strong> (first-party): Manage OpenVibe.Host tenant projects and static sites: create a project (owned by the person named with X-OV-Subject; apps cannot own projects), read projects, quotas and usage, manage members (owner role), create and delete sites, delete a deploy that is not active. Also judged by the acting principal's project role; a sandbox token (env=sandbox) is refused on production projects. Quota changes and takedowns (stop serving a site or a whole project while keeping its content for review; lift) additionally need a Network staff user.</p>PUT /api/v1/projects/{id}/members/{principal}
Manage OpenVibe.Host tenant projects and static sites: create a project (owned by the person named with X-OV-Subject; apps cannot own projects), read projects, quotas and usage, manage members (owner
- Capabilities
- host.site.manage
- Visibility
- first-party
- Parameters
id(path, required)principal(path, required)
- Request body
application/jsonhost.site-manage-request@1- Response
application/jsonhost.site-manage-result@1- Errors
- errors.problem@1 (application/problem+json)
Description
<p><strong>host.site.manage</strong> (first-party): Manage OpenVibe.Host tenant projects and static sites: create a project (owned by the person named with X-OV-Subject; apps cannot own projects), read projects, quotas and usage, manage members (owner role), create and delete sites, delete a deploy that is not active. Also judged by the acting principal's project role; a sandbox token (env=sandbox) is refused on production projects. Quota changes and takedowns (stop serving a site or a whole project while keeping its content for review; lift) additionally need a Network staff user.</p>DELETE /api/v1/projects/{id}/members/{principal}
Manage OpenVibe.Host tenant projects and static sites: create a project (owned by the person named with X-OV-Subject; apps cannot own projects), read projects, quotas and usage, manage members (owner
- Capabilities
- host.site.manage
- Visibility
- first-party
- Parameters
id(path, required)principal(path, required)
- Input
- host.site-manage-request@1
- Response
application/jsonhost.site-manage-result@1- Errors
- errors.problem@1 (application/problem+json)
Description
<p><strong>host.site.manage</strong> (first-party): Manage OpenVibe.Host tenant projects and static sites: create a project (owned by the person named with X-OV-Subject; apps cannot own projects), read projects, quotas and usage, manage members (owner role), create and delete sites, delete a deploy that is not active. Also judged by the acting principal's project role; a sandbox token (env=sandbox) is refused on production projects. Quota changes and takedowns (stop serving a site or a whole project while keeping its content for review; lift) additionally need a Network staff user.</p>GET /api/v1/projects/{id}/quota
Manage OpenVibe.Host tenant projects and static sites: create a project (owned by the person named with X-OV-Subject; apps cannot own projects), read projects, quotas and usage, manage members (owner
- Capabilities
- host.site.manage
- Visibility
- first-party
- Parameters
id(path, required)
- Input
- host.site-manage-request@1
- Response
application/jsonhost.site-manage-result@1- Errors
- errors.problem@1 (application/problem+json)
Description
<p><strong>host.site.manage</strong> (first-party): Manage OpenVibe.Host tenant projects and static sites: create a project (owned by the person named with X-OV-Subject; apps cannot own projects), read projects, quotas and usage, manage members (owner role), create and delete sites, delete a deploy that is not active. Also judged by the acting principal's project role; a sandbox token (env=sandbox) is refused on production projects. Quota changes and takedowns (stop serving a site or a whole project while keeping its content for review; lift) additionally need a Network staff user.</p>PUT /api/v1/projects/{id}/quota
Manage OpenVibe.Host tenant projects and static sites: create a project (owned by the person named with X-OV-Subject; apps cannot own projects), read projects, quotas and usage, manage members (owner
- Capabilities
- host.site.manage
- Visibility
- first-party
- Parameters
id(path, required)
- Request body
application/jsonhost.site-manage-request@1- Response
application/jsonhost.site-manage-result@1- Errors
- errors.problem@1 (application/problem+json)
Description
<p><strong>host.site.manage</strong> (first-party): Manage OpenVibe.Host tenant projects and static sites: create a project (owned by the person named with X-OV-Subject; apps cannot own projects), read projects, quotas and usage, manage members (owner role), create and delete sites, delete a deploy that is not active. Also judged by the acting principal's project role; a sandbox token (env=sandbox) is refused on production projects. Quota changes and takedowns (stop serving a site or a whole project while keeping its content for review; lift) additionally need a Network staff user.</p>GET /api/v1/projects/{id}/sites
Manage OpenVibe.Host tenant projects and static sites: create a project (owned by the person named with X-OV-Subject; apps cannot own projects), read projects, quotas and usage, manage members (owner
- Capabilities
- host.site.manage
- Visibility
- first-party
- Parameters
id(path, required)
- Input
- host.site-manage-request@1
- Response
application/jsonhost.site-manage-result@1- Errors
- errors.problem@1 (application/problem+json)
Description
<p><strong>host.site.manage</strong> (first-party): Manage OpenVibe.Host tenant projects and static sites: create a project (owned by the person named with X-OV-Subject; apps cannot own projects), read projects, quotas and usage, manage members (owner role), create and delete sites, delete a deploy that is not active. Also judged by the acting principal's project role; a sandbox token (env=sandbox) is refused on production projects. Quota changes and takedowns (stop serving a site or a whole project while keeping its content for review; lift) additionally need a Network staff user.</p>POST /api/v1/projects/{id}/sites
Manage OpenVibe.Host tenant projects and static sites: create a project (owned by the person named with X-OV-Subject; apps cannot own projects), read projects, quotas and usage, manage members (owner
- Capabilities
- host.site.manage
- Visibility
- first-party
- Parameters
id(path, required)
- Request body
application/jsonhost.site-manage-request@1- Response
application/jsonhost.site-manage-result@1- Errors
- errors.problem@1 (application/problem+json)
Description
<p><strong>host.site.manage</strong> (first-party): Manage OpenVibe.Host tenant projects and static sites: create a project (owned by the person named with X-OV-Subject; apps cannot own projects), read projects, quotas and usage, manage members (owner role), create and delete sites, delete a deploy that is not active. Also judged by the acting principal's project role; a sandbox token (env=sandbox) is refused on production projects. Quota changes and takedowns (stop serving a site or a whole project while keeping its content for review; lift) additionally need a Network staff user.</p>POST /api/v1/projects/{id}/takedown
Manage OpenVibe.Host tenant projects and static sites: create a project (owned by the person named with X-OV-Subject; apps cannot own projects), read projects, quotas and usage, manage members (owner
- Capabilities
- host.site.manage
- Visibility
- first-party
- Parameters
id(path, required)
- Request body
application/jsonhost.site-manage-request@1- Response
application/jsonhost.site-manage-result@1- Errors
- errors.problem@1 (application/problem+json)
Description
<p><strong>host.site.manage</strong> (first-party): Manage OpenVibe.Host tenant projects and static sites: create a project (owned by the person named with X-OV-Subject; apps cannot own projects), read projects, quotas and usage, manage members (owner role), create and delete sites, delete a deploy that is not active. Also judged by the acting principal's project role; a sandbox token (env=sandbox) is refused on production projects. Quota changes and takedowns (stop serving a site or a whole project while keeping its content for review; lift) additionally need a Network staff user.</p>DELETE /api/v1/projects/{id}/takedown
Manage OpenVibe.Host tenant projects and static sites: create a project (owned by the person named with X-OV-Subject; apps cannot own projects), read projects, quotas and usage, manage members (owner
- Capabilities
- host.site.manage
- Visibility
- first-party
- Parameters
id(path, required)
- Input
- host.site-manage-request@1
- Response
application/jsonhost.site-manage-result@1- Errors
- errors.problem@1 (application/problem+json)
Description
<p><strong>host.site.manage</strong> (first-party): Manage OpenVibe.Host tenant projects and static sites: create a project (owned by the person named with X-OV-Subject; apps cannot own projects), read projects, quotas and usage, manage members (owner role), create and delete sites, delete a deploy that is not active. Also judged by the acting principal's project role; a sandbox token (env=sandbox) is refused on production projects. Quota changes and takedowns (stop serving a site or a whole project while keeping its content for review; lift) additionally need a Network staff user.</p>GET /api/v1/sites/{id}
Manage OpenVibe.Host tenant projects and static sites: create a project (owned by the person named with X-OV-Subject; apps cannot own projects), read projects, quotas and usage, manage members (owner
- Capabilities
- host.site.manage
- Visibility
- first-party
- Parameters
id(path, required)
- Input
- host.site-manage-request@1
- Response
application/jsonhost.site-manage-result@1- Errors
- errors.problem@1 (application/problem+json)
Description
<p><strong>host.site.manage</strong> (first-party): Manage OpenVibe.Host tenant projects and static sites: create a project (owned by the person named with X-OV-Subject; apps cannot own projects), read projects, quotas and usage, manage members (owner role), create and delete sites, delete a deploy that is not active. Also judged by the acting principal's project role; a sandbox token (env=sandbox) is refused on production projects. Quota changes and takedowns (stop serving a site or a whole project while keeping its content for review; lift) additionally need a Network staff user.</p>DELETE /api/v1/sites/{id}
Manage OpenVibe.Host tenant projects and static sites: create a project (owned by the person named with X-OV-Subject; apps cannot own projects), read projects, quotas and usage, manage members (owner
- Capabilities
- host.site.manage
- Visibility
- first-party
- Parameters
id(path, required)
- Input
- host.site-manage-request@1
- Response
application/jsonhost.site-manage-result@1- Errors
- errors.problem@1 (application/problem+json)
Description
<p><strong>host.site.manage</strong> (first-party): Manage OpenVibe.Host tenant projects and static sites: create a project (owned by the person named with X-OV-Subject; apps cannot own projects), read projects, quotas and usage, manage members (owner role), create and delete sites, delete a deploy that is not active. Also judged by the acting principal's project role; a sandbox token (env=sandbox) is refused on production projects. Quota changes and takedowns (stop serving a site or a whole project while keeping its content for review; lift) additionally need a Network staff user.</p>GET /api/v1/sites/{id}/deploys
Upload an immutable static deploy (tar/tar.gz or multipart files; validated for path traversal, links, special and hidden files, server-side code, file types and quotas; never executed), list deploys
- Capabilities
- host.deploy.create
- Visibility
- first-party
- Parameters
id(path, required)
- Input
- host.deploy-create-request@1
- Response
application/jsonhost.deploy-create-result@1- Errors
- errors.problem@1 (application/problem+json)
Description
<p><strong>host.deploy.create</strong> (first-party): Upload an immutable static deploy (tar/tar.gz or multipart files; validated for path traversal, links, special and hidden files, server-side code, file types and quotas; never executed), list deploys and their upload logs, activate a deploy and roll a site back to any earlier ready deploy (one atomic pointer switch). Also judged by the acting principal's project role (deployer or above); an app principal added to a project as deployer can deploy from CI.</p>POST /api/v1/sites/{id}/deploys
Upload an immutable static deploy (tar/tar.gz or multipart files; validated for path traversal, links, special and hidden files, server-side code, file types and quotas; never executed), list deploys
- Capabilities
- host.deploy.create
- Visibility
- first-party
- Parameters
id(path, required)
- Request body
application/jsonhost.deploy-create-request@1- Response
application/jsonhost.deploy-create-result@1- Errors
- errors.problem@1 (application/problem+json)
Description
<p><strong>host.deploy.create</strong> (first-party): Upload an immutable static deploy (tar/tar.gz or multipart files; validated for path traversal, links, special and hidden files, server-side code, file types and quotas; never executed), list deploys and their upload logs, activate a deploy and roll a site back to any earlier ready deploy (one atomic pointer switch). Also judged by the acting principal's project role (deployer or above); an app principal added to a project as deployer can deploy from CI.</p>GET /api/v1/sites/{id}/domains
Add a custom domain to a static site (never an OpenVibe domain; not in sandbox projects), read its DNS TXT verification and routing records, trigger a verification check, and remove it.
- Capabilities
- host.domain.manage
- Visibility
- first-party
- Parameters
id(path, required)
- Input
- host.domain-manage-request@1
- Response
application/jsonhost.domain-manage-result@1- Errors
- errors.problem@1 (application/problem+json)
Description
<p><strong>host.domain.manage</strong> (first-party): Add a custom domain to a static site (never an OpenVibe domain; not in sandbox projects), read its DNS TXT verification and routing records, trigger a verification check, and remove it. A custom domain is served only after its TXT record is verified; TLS certificates are issued by an operator and never pass through this capability.</p>POST /api/v1/sites/{id}/domains
Add a custom domain to a static site (never an OpenVibe domain; not in sandbox projects), read its DNS TXT verification and routing records, trigger a verification check, and remove it.
- Capabilities
- host.domain.manage
- Visibility
- first-party
- Parameters
id(path, required)
- Request body
application/jsonhost.domain-manage-request@1- Response
application/jsonhost.domain-manage-result@1- Errors
- errors.problem@1 (application/problem+json)
Description
<p><strong>host.domain.manage</strong> (first-party): Add a custom domain to a static site (never an OpenVibe domain; not in sandbox projects), read its DNS TXT verification and routing records, trigger a verification check, and remove it. A custom domain is served only after its TXT record is verified; TLS certificates are issued by an operator and never pass through this capability.</p>POST /api/v1/sites/{id}/rollback
Upload an immutable static deploy (tar/tar.gz or multipart files; validated for path traversal, links, special and hidden files, server-side code, file types and quotas; never executed), list deploys
- Capabilities
- host.deploy.create
- Visibility
- first-party
- Parameters
id(path, required)
- Request body
application/jsonhost.deploy-create-request@1- Response
application/jsonhost.deploy-create-result@1- Errors
- errors.problem@1 (application/problem+json)
Description
<p><strong>host.deploy.create</strong> (first-party): Upload an immutable static deploy (tar/tar.gz or multipart files; validated for path traversal, links, special and hidden files, server-side code, file types and quotas; never executed), list deploys and their upload logs, activate a deploy and roll a site back to any earlier ready deploy (one atomic pointer switch). Also judged by the acting principal's project role (deployer or above); an app principal added to a project as deployer can deploy from CI.</p>POST /api/v1/sites/{id}/takedown
Manage OpenVibe.Host tenant projects and static sites: create a project (owned by the person named with X-OV-Subject; apps cannot own projects), read projects, quotas and usage, manage members (owner
- Capabilities
- host.site.manage
- Visibility
- first-party
- Parameters
id(path, required)
- Request body
application/jsonhost.site-manage-request@1- Response
application/jsonhost.site-manage-result@1- Errors
- errors.problem@1 (application/problem+json)
Description
<p><strong>host.site.manage</strong> (first-party): Manage OpenVibe.Host tenant projects and static sites: create a project (owned by the person named with X-OV-Subject; apps cannot own projects), read projects, quotas and usage, manage members (owner role), create and delete sites, delete a deploy that is not active. Also judged by the acting principal's project role; a sandbox token (env=sandbox) is refused on production projects. Quota changes and takedowns (stop serving a site or a whole project while keeping its content for review; lift) additionally need a Network staff user.</p>DELETE /api/v1/sites/{id}/takedown
Manage OpenVibe.Host tenant projects and static sites: create a project (owned by the person named with X-OV-Subject; apps cannot own projects), read projects, quotas and usage, manage members (owner
- Capabilities
- host.site.manage
- Visibility
- first-party
- Parameters
id(path, required)
- Input
- host.site-manage-request@1
- Response
application/jsonhost.site-manage-result@1- Errors
- errors.problem@1 (application/problem+json)