Skip to main content
POST
/
builds
/
create
curl -X POST https://www.orgo.ai/api/builds/create \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "orgId": "550e8400-e29b-41d4-a716-446655440000",
    "projectId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "name": "data-science"
  }'

{
  "success": true,
  "build": {
    "id": "a3bb189e-8bf9-3888-9912-ace4e6543002",
    "tag": "abc123-def456-1234567890-xyz789",
    "imageRef": "registry.fly.io/orgoforge:abc123-def456-1234567890-xyz789",
    "buildkitUrl": "tcp://137.66.60.244:1234",
    "status": "pending"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.orgo.ai/llms.txt

Use this file to discover all available pages before exploring further.

Registers a new template build with the Orgo build system. Returns build information including the image reference and BuildKit URL.
This endpoint is typically called by the SDK’s Template.build() method. You don’t need to call it directly unless building a custom integration.

​
Request Body

​
orgId
string
required
Organization or user ID
​
projectId
string
required
Workspace ID to store the template in
​
name
string
Template name (used to reference it when creating computers)

​
Response

​
success
boolean
Whether the build was registered successfully
​
build
object
curl -X POST https://www.orgo.ai/api/builds/create \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "orgId": "550e8400-e29b-41d4-a716-446655440000",
    "projectId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "name": "data-science"
  }'

{
  "success": true,
  "build": {
    "id": "a3bb189e-8bf9-3888-9912-ace4e6543002",
    "tag": "abc123-def456-1234567890-xyz789",
    "imageRef": "registry.fly.io/orgoforge:abc123-def456-1234567890-xyz789",
    "buildkitUrl": "tcp://137.66.60.244:1234",
    "status": "pending"
  }
}