Builders

List Github Credentials

GET/api/v1/builders/github-credentials

Also as:MCPtool_call software-factory.listGithubCredentialsskillsoftware-factory

The brand's GitHub credentials, classified — the project picker's source.

Request

curl "https://app.opvs.ai/api/v1/builders/github-credentials" \
  -H "Authorization: Bearer $OPVS_TOKEN"

import os
import requests

r = requests.request(
    "GET",
    "https://app.opvs.ai/api/v1/builders/github-credentials",
    headers={"Authorization": f"Bearer {os.environ['OPVS_TOKEN']}"},
)
r.raise_for_status()
print(r.json())

const r = await fetch("https://app.opvs.ai/api/v1/builders/github-credentials", {
  method: "GET",
  headers: { Authorization: `Bearer ${process.env.OPVS_TOKEN}` },
});
if (!r.ok) throw new Error(String(r.status));
console.log(await r.json());

req, _ := http.NewRequest("GET", "https://app.opvs.ai/api/v1/builders/github-credentials", nil)
req.Header.Set("Authorization", "Bearer "+os.Getenv("OPVS_TOKEN"))
resp, err := http.DefaultClient.Do(req)
if err != nil { log.Fatal(err) }
defer resp.Body.Close()

Try itGET /api/v1/builders/github-credentials

Server fixedYour API token kept in this tab only

Used once, saved nowhere. Your token travels for this request through opvs.ai and SpiderPublish to app.opvs.ai, then this page forgets it when the tab closes.

GET only · 30 tries a minute

Get Project Repo

GET/api/v1/builders/projects/{project_id}/repo

Also as:MCPtool_call software-factory.getProjectReposkillsoftware-factory

The repo this project builds. 404 when none is attached.

Errors

Code	When	What to do
422	Validation Error	—

Request

curl "https://app.opvs.ai/api/v1/builders/projects/{project_id}/repo" \
  -H "Authorization: Bearer $OPVS_TOKEN"

import os
import requests

r = requests.request(
    "GET",
    "https://app.opvs.ai/api/v1/builders/projects/{project_id}/repo",
    headers={"Authorization": f"Bearer {os.environ['OPVS_TOKEN']}"},
)
r.raise_for_status()
print(r.json())

const r = await fetch("https://app.opvs.ai/api/v1/builders/projects/{project_id}/repo", {
  method: "GET",
  headers: { Authorization: `Bearer ${process.env.OPVS_TOKEN}` },
});
if (!r.ok) throw new Error(String(r.status));
console.log(await r.json());

req, _ := http.NewRequest("GET", "https://app.opvs.ai/api/v1/builders/projects/{project_id}/repo", nil)
req.Header.Set("Authorization", "Bearer "+os.Getenv("OPVS_TOKEN"))
resp, err := http.DefaultClient.Do(req)
if err != nil { log.Fatal(err) }
defer resp.Body.Close()

Try itGET /api/v1/builders/projects/{project_id}/repo

Server fixedYour API token kept in this tab only

Used once, saved nowhere. Your token travels for this request through opvs.ai and SpiderPublish to app.opvs.ai, then this page forgets it when the tab closes.

GET only · 30 tries a minute

Put Project Repo

PUT/api/v1/builders/projects/{project_id}/repo

Also as:MCPtool_call software-factory.setProjectReposkillsoftware-factory

Attach (or replace) the repo this project builds, and which of the brand's GitHub credentials its BUILDS authenticate with.

Errors

Code	When	What to do
422	Validation Error	—

Request

curl -X PUT "https://app.opvs.ai/api/v1/builders/projects/{project_id}/repo" \
  -H "Authorization: Bearer $OPVS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

import os
import requests

r = requests.request(
    "PUT",
    "https://app.opvs.ai/api/v1/builders/projects/{project_id}/repo",
    headers={"Authorization": f"Bearer {os.environ['OPVS_TOKEN']}", "Content-Type": "application/json"},
    data='{}',
)
r.raise_for_status()
print(r.json())

const r = await fetch("https://app.opvs.ai/api/v1/builders/projects/{project_id}/repo", {
  method: "PUT",
  headers: { Authorization: `Bearer ${process.env.OPVS_TOKEN}`, "Content-Type": "application/json" },
  body: JSON.stringify({}),
});
if (!r.ok) throw new Error(String(r.status));
console.log(await r.json());

req, _ := http.NewRequest("PUT", "https://app.opvs.ai/api/v1/builders/projects/{project_id}/repo", strings.NewReader(`{}`))
req.Header.Set("Authorization", "Bearer "+os.Getenv("OPVS_TOKEN"))
req.Header.Set("Content-Type", "application/json")
resp, err := http.DefaultClient.Do(req)
if err != nil { log.Fatal(err) }
defer resp.Body.Close()

Try itPUT /api/v1/builders/projects/{project_id}/repo

Try it sends reading requests only.

This endpoint changes data in your workspace, so it is not sent from the docs. Copy the command and run it in your own terminal.

Delete Project Repo

DELETE/api/v1/builders/projects/{project_id}/repo

Also as:MCPtool_call software-factory.deleteProjectReposkillsoftware-factory

Detach this project's repo.

Errors

Code	When	What to do
422	Validation Error	—

Request

curl -X DELETE "https://app.opvs.ai/api/v1/builders/projects/{project_id}/repo" \
  -H "Authorization: Bearer $OPVS_TOKEN"

import os
import requests

r = requests.request(
    "DELETE",
    "https://app.opvs.ai/api/v1/builders/projects/{project_id}/repo",
    headers={"Authorization": f"Bearer {os.environ['OPVS_TOKEN']}"},
)
r.raise_for_status()
print(r.json())

const r = await fetch("https://app.opvs.ai/api/v1/builders/projects/{project_id}/repo", {
  method: "DELETE",
  headers: { Authorization: `Bearer ${process.env.OPVS_TOKEN}` },
});
if (!r.ok) throw new Error(String(r.status));
console.log(await r.json());

req, _ := http.NewRequest("DELETE", "https://app.opvs.ai/api/v1/builders/projects/{project_id}/repo", nil)
req.Header.Set("Authorization", "Bearer "+os.Getenv("OPVS_TOKEN"))
resp, err := http.DefaultClient.Do(req)
if err != nil { log.Fatal(err) }
defer resp.Body.Close()

Try itDELETE /api/v1/builders/projects/{project_id}/repo

Try it sends reading requests only.

This endpoint changes data in your workspace, so it is not sent from the docs. Copy the command and run it in your own terminal.

Get Project Merge Owner

GET/api/v1/builders/projects/{project_id}/merge-owner

Also as:MCPtool_call software-factory.getProjectMergeOwnerskillsoftware-factory

Return the configured address and its mailbox/wake readiness.

Errors

Code	When	What to do
422	Validation Error	—

Request

curl "https://app.opvs.ai/api/v1/builders/projects/{project_id}/merge-owner" \
  -H "Authorization: Bearer $OPVS_TOKEN"

import os
import requests

r = requests.request(
    "GET",
    "https://app.opvs.ai/api/v1/builders/projects/{project_id}/merge-owner",
    headers={"Authorization": f"Bearer {os.environ['OPVS_TOKEN']}"},
)
r.raise_for_status()
print(r.json())

const r = await fetch("https://app.opvs.ai/api/v1/builders/projects/{project_id}/merge-owner", {
  method: "GET",
  headers: { Authorization: `Bearer ${process.env.OPVS_TOKEN}` },
});
if (!r.ok) throw new Error(String(r.status));
console.log(await r.json());

req, _ := http.NewRequest("GET", "https://app.opvs.ai/api/v1/builders/projects/{project_id}/merge-owner", nil)
req.Header.Set("Authorization", "Bearer "+os.Getenv("OPVS_TOKEN"))
resp, err := http.DefaultClient.Do(req)
if err != nil { log.Fatal(err) }
defer resp.Body.Close()

Try itGET /api/v1/builders/projects/{project_id}/merge-owner

Server fixedYour API token kept in this tab only

Used once, saved nowhere. Your token travels for this request through opvs.ai and SpiderPublish to app.opvs.ai, then this page forgets it when the tab closes.

GET only · 30 tries a minute

Put Project Merge Owner

PUT/api/v1/builders/projects/{project_id}/merge-owner

Also as:MCPtool_call software-factory.setProjectMergeOwnerskillsoftware-factory

Set a live, same-brand OPVS address as the project's merge owner.

Errors

Code	When	What to do
422	Validation Error	—

Request

curl -X PUT "https://app.opvs.ai/api/v1/builders/projects/{project_id}/merge-owner" \
  -H "Authorization: Bearer $OPVS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

import os
import requests

r = requests.request(
    "PUT",
    "https://app.opvs.ai/api/v1/builders/projects/{project_id}/merge-owner",
    headers={"Authorization": f"Bearer {os.environ['OPVS_TOKEN']}", "Content-Type": "application/json"},
    data='{}',
)
r.raise_for_status()
print(r.json())

const r = await fetch("https://app.opvs.ai/api/v1/builders/projects/{project_id}/merge-owner", {
  method: "PUT",
  headers: { Authorization: `Bearer ${process.env.OPVS_TOKEN}`, "Content-Type": "application/json" },
  body: JSON.stringify({}),
});
if (!r.ok) throw new Error(String(r.status));
console.log(await r.json());

req, _ := http.NewRequest("PUT", "https://app.opvs.ai/api/v1/builders/projects/{project_id}/merge-owner", strings.NewReader(`{}`))
req.Header.Set("Authorization", "Bearer "+os.Getenv("OPVS_TOKEN"))
req.Header.Set("Content-Type", "application/json")
resp, err := http.DefaultClient.Do(req)
if err != nil { log.Fatal(err) }
defer resp.Body.Close()

Try itPUT /api/v1/builders/projects/{project_id}/merge-owner

Try it sends reading requests only.

This endpoint changes data in your workspace, so it is not sent from the docs. Copy the command and run it in your own terminal.

Delete Project Merge Owner

DELETE/api/v1/builders/projects/{project_id}/merge-owner

Also as:MCPtool_call software-factory.deleteProjectMergeOwnerskillsoftware-factory

Clear the merge owner without detaching or changing the repository.

Errors

Code	When	What to do
422	Validation Error	—

Request

curl -X DELETE "https://app.opvs.ai/api/v1/builders/projects/{project_id}/merge-owner" \
  -H "Authorization: Bearer $OPVS_TOKEN"

import os
import requests

r = requests.request(
    "DELETE",
    "https://app.opvs.ai/api/v1/builders/projects/{project_id}/merge-owner",
    headers={"Authorization": f"Bearer {os.environ['OPVS_TOKEN']}"},
)
r.raise_for_status()
print(r.json())

const r = await fetch("https://app.opvs.ai/api/v1/builders/projects/{project_id}/merge-owner", {
  method: "DELETE",
  headers: { Authorization: `Bearer ${process.env.OPVS_TOKEN}` },
});
if (!r.ok) throw new Error(String(r.status));
console.log(await r.json());

req, _ := http.NewRequest("DELETE", "https://app.opvs.ai/api/v1/builders/projects/{project_id}/merge-owner", nil)
req.Header.Set("Authorization", "Bearer "+os.Getenv("OPVS_TOKEN"))
resp, err := http.DefaultClient.Do(req)
if err != nil { log.Fatal(err) }
defer resp.Body.Close()

Try itDELETE /api/v1/builders/projects/{project_id}/merge-owner

Try it sends reading requests only.

This endpoint changes data in your workspace, so it is not sent from the docs. Copy the command and run it in your own terminal.

Put Hire Project

PUT/api/v1/builders/hires/{hire_id}/project

Also as:MCPtool_call software-factory.setHireProjectskillsoftware-factory

Grant (or revoke) one hired builder the right to act on a project.

Errors

Code	When	What to do
422	Validation Error	—

Request

curl -X PUT "https://app.opvs.ai/api/v1/builders/hires/{hire_id}/project" \
  -H "Authorization: Bearer $OPVS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

import os
import requests

r = requests.request(
    "PUT",
    "https://app.opvs.ai/api/v1/builders/hires/{hire_id}/project",
    headers={"Authorization": f"Bearer {os.environ['OPVS_TOKEN']}", "Content-Type": "application/json"},
    data='{}',
)
r.raise_for_status()
print(r.json())

const r = await fetch("https://app.opvs.ai/api/v1/builders/hires/{hire_id}/project", {
  method: "PUT",
  headers: { Authorization: `Bearer ${process.env.OPVS_TOKEN}`, "Content-Type": "application/json" },
  body: JSON.stringify({}),
});
if (!r.ok) throw new Error(String(r.status));
console.log(await r.json());

req, _ := http.NewRequest("PUT", "https://app.opvs.ai/api/v1/builders/hires/{hire_id}/project", strings.NewReader(`{}`))
req.Header.Set("Authorization", "Bearer "+os.Getenv("OPVS_TOKEN"))
req.Header.Set("Content-Type", "application/json")
resp, err := http.DefaultClient.Do(req)
if err != nil { log.Fatal(err) }
defer resp.Body.Close()

Try itPUT /api/v1/builders/hires/{hire_id}/project

Try it sends reading requests only.

This endpoint changes data in your workspace, so it is not sent from the docs. Copy the command and run it in your own terminal.

Get Hire Entitlements

GET/api/v1/builders/hires/{hire_id}/entitlements

Also as:MCPtool_call software-factory.getHireEntitlementsskillsoftware-factory

What repo verbs this builder holds, by source. 404 when no binding.

Errors

Code	When	What to do
422	Validation Error	—

Request

curl "https://app.opvs.ai/api/v1/builders/hires/{hire_id}/entitlements" \
  -H "Authorization: Bearer $OPVS_TOKEN"

import os
import requests

r = requests.request(
    "GET",
    "https://app.opvs.ai/api/v1/builders/hires/{hire_id}/entitlements",
    headers={"Authorization": f"Bearer {os.environ['OPVS_TOKEN']}"},
)
r.raise_for_status()
print(r.json())

const r = await fetch("https://app.opvs.ai/api/v1/builders/hires/{hire_id}/entitlements", {
  method: "GET",
  headers: { Authorization: `Bearer ${process.env.OPVS_TOKEN}` },
});
if (!r.ok) throw new Error(String(r.status));
console.log(await r.json());

req, _ := http.NewRequest("GET", "https://app.opvs.ai/api/v1/builders/hires/{hire_id}/entitlements", nil)
req.Header.Set("Authorization", "Bearer "+os.Getenv("OPVS_TOKEN"))
resp, err := http.DefaultClient.Do(req)
if err != nil { log.Fatal(err) }
defer resp.Body.Close()

Try itGET /api/v1/builders/hires/{hire_id}/entitlements

Server fixedYour API token kept in this tab only

Used once, saved nowhere. Your token travels for this request through opvs.ai and SpiderPublish to app.opvs.ai, then this page forgets it when the tab closes.

GET only · 30 tries a minute

Put Hire Entitlements

PUT/api/v1/builders/hires/{hire_id}/entitlements

Also as:MCPtool_call software-factory.setHireEntitlementsskillsoftware-factory

Grant (or revoke) this builder's repo verbs. The body is the FULL set.

Errors

Code	When	What to do
422	Validation Error	—

Request

curl -X PUT "https://app.opvs.ai/api/v1/builders/hires/{hire_id}/entitlements" \
  -H "Authorization: Bearer $OPVS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

import os
import requests

r = requests.request(
    "PUT",
    "https://app.opvs.ai/api/v1/builders/hires/{hire_id}/entitlements",
    headers={"Authorization": f"Bearer {os.environ['OPVS_TOKEN']}", "Content-Type": "application/json"},
    data='{}',
)
r.raise_for_status()
print(r.json())

const r = await fetch("https://app.opvs.ai/api/v1/builders/hires/{hire_id}/entitlements", {
  method: "PUT",
  headers: { Authorization: `Bearer ${process.env.OPVS_TOKEN}`, "Content-Type": "application/json" },
  body: JSON.stringify({}),
});
if (!r.ok) throw new Error(String(r.status));
console.log(await r.json());

req, _ := http.NewRequest("PUT", "https://app.opvs.ai/api/v1/builders/hires/{hire_id}/entitlements", strings.NewReader(`{}`))
req.Header.Set("Authorization", "Bearer "+os.Getenv("OPVS_TOKEN"))
req.Header.Set("Content-Type", "application/json")
resp, err := http.DefaultClient.Do(req)
if err != nil { log.Fatal(err) }
defer resp.Body.Close()

Try itPUT /api/v1/builders/hires/{hire_id}/entitlements

Try it sends reading requests only.

This endpoint changes data in your workspace, so it is not sent from the docs. Copy the command and run it in your own terminal.

Machine Grant Strict Readiness

GET/api/v1/builders/brands/{brand_id}/environment-grants/strict-readiness

Also as:MCPtool_call software-factory.machineGrantStrictReadinessskillsoftware-factory

List active machine/project pairs that strict push/write would refuse.

Errors

Code	When	What to do
422	Validation Error	—

Request

curl "https://app.opvs.ai/api/v1/builders/brands/{brand_id}/environment-grants/strict-readiness" \
  -H "Authorization: Bearer $OPVS_TOKEN"

import os
import requests

r = requests.request(
    "GET",
    "https://app.opvs.ai/api/v1/builders/brands/{brand_id}/environment-grants/strict-readiness",
    headers={"Authorization": f"Bearer {os.environ['OPVS_TOKEN']}"},
)
r.raise_for_status()
print(r.json())

const r = await fetch("https://app.opvs.ai/api/v1/builders/brands/{brand_id}/environment-grants/strict-readiness", {
  method: "GET",
  headers: { Authorization: `Bearer ${process.env.OPVS_TOKEN}` },
});
if (!r.ok) throw new Error(String(r.status));
console.log(await r.json());

req, _ := http.NewRequest("GET", "https://app.opvs.ai/api/v1/builders/brands/{brand_id}/environment-grants/strict-readiness", nil)
req.Header.Set("Authorization", "Bearer "+os.Getenv("OPVS_TOKEN"))
resp, err := http.DefaultClient.Do(req)
if err != nil { log.Fatal(err) }
defer resp.Body.Close()

Try itGET /api/v1/builders/brands/{brand_id}/environment-grants/strict-readiness

Server fixedYour API token kept in this tab only

Used once, saved nowhere. Your token travels for this request through opvs.ai and SpiderPublish to app.opvs.ai, then this page forgets it when the tab closes.

GET only · 30 tries a minute

List Environment Repo Grants

GET/api/v1/builders/brands/{brand_id}/environment-grants

Also as:MCPtool_call software-factory.listEnvironmentRepoGrantsskillsoftware-factory

List this brand's machine-project grants for a human brand admin.

Errors

Code	When	What to do
422	Validation Error	—

Request

curl "https://app.opvs.ai/api/v1/builders/brands/{brand_id}/environment-grants" \
  -H "Authorization: Bearer $OPVS_TOKEN"

import os
import requests

r = requests.request(
    "GET",
    "https://app.opvs.ai/api/v1/builders/brands/{brand_id}/environment-grants",
    headers={"Authorization": f"Bearer {os.environ['OPVS_TOKEN']}"},
)
r.raise_for_status()
print(r.json())

const r = await fetch("https://app.opvs.ai/api/v1/builders/brands/{brand_id}/environment-grants", {
  method: "GET",
  headers: { Authorization: `Bearer ${process.env.OPVS_TOKEN}` },
});
if (!r.ok) throw new Error(String(r.status));
console.log(await r.json());

req, _ := http.NewRequest("GET", "https://app.opvs.ai/api/v1/builders/brands/{brand_id}/environment-grants", nil)
req.Header.Set("Authorization", "Bearer "+os.Getenv("OPVS_TOKEN"))
resp, err := http.DefaultClient.Do(req)
if err != nil { log.Fatal(err) }
defer resp.Body.Close()

Try itGET /api/v1/builders/brands/{brand_id}/environment-grants

Server fixedYour API token kept in this tab only

Used once, saved nowhere. Your token travels for this request through opvs.ai and SpiderPublish to app.opvs.ai, then this page forgets it when the tab closes.

GET only · 30 tries a minute

Set Environment Repo Grant

PUT/api/v1/builders/brands/{brand_id}/environment-grants

Also as:MCPtool_call software-factory.setEnvironmentRepoGrantskillsoftware-factory

Replace one machine-project grant; empty entitlements revoke it.

Errors

Code	When	What to do
422	Validation Error	—

Request

curl -X PUT "https://app.opvs.ai/api/v1/builders/brands/{brand_id}/environment-grants" \
  -H "Authorization: Bearer $OPVS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

import os
import requests

r = requests.request(
    "PUT",
    "https://app.opvs.ai/api/v1/builders/brands/{brand_id}/environment-grants",
    headers={"Authorization": f"Bearer {os.environ['OPVS_TOKEN']}", "Content-Type": "application/json"},
    data='{}',
)
r.raise_for_status()
print(r.json())

const r = await fetch("https://app.opvs.ai/api/v1/builders/brands/{brand_id}/environment-grants", {
  method: "PUT",
  headers: { Authorization: `Bearer ${process.env.OPVS_TOKEN}`, "Content-Type": "application/json" },
  body: JSON.stringify({}),
});
if (!r.ok) throw new Error(String(r.status));
console.log(await r.json());

req, _ := http.NewRequest("PUT", "https://app.opvs.ai/api/v1/builders/brands/{brand_id}/environment-grants", strings.NewReader(`{}`))
req.Header.Set("Authorization", "Bearer "+os.Getenv("OPVS_TOKEN"))
req.Header.Set("Content-Type", "application/json")
resp, err := http.DefaultClient.Do(req)
if err != nil { log.Fatal(err) }
defer resp.Body.Close()

Try itPUT /api/v1/builders/brands/{brand_id}/environment-grants

Try it sends reading requests only.

This endpoint changes data in your workspace, so it is not sent from the docs. Copy the command and run it in your own terminal.

Did this answer your question?

Need help? support@opvs.aiChangelog LLM? Read llms.txt