Projects & Deploy

1
const { data: projects, meta } = await r.projects.list();
2
3
for (const project of projects) {
4
  console.log(`${project.name} (${project.slug})`);
5
}
6
7
// Filter by organization
8
const { data: orgProjects } = await r.projects.list({
9
  organization_id: 'org_123',
10
});

1
const { data: project } = await r.projects.get('proj_123');
2
3
console.log(project.name);
4
console.log(project.slug);
5
console.log(project.repo_url);
6
console.log(project.sandbox?.status);       // 'running' | 'stopped' | ...
7
console.log(project.databases);              // [{ id, name, status }]
8
console.log(project.storage_buckets);        // [{ id, name }]

1
const { data: project } = await r.projects.create({
2
  organization_id: 'org_123',
3
  name: 'My New App',
4
});
5
6
console.log(project.id);   // 'proj_abc...'
7
console.log(project.slug); // 'my-new-app' (auto-generated if not provided)

1
const result = await r.projects.delete('proj_123');
2
console.log(result.data.deleted); // true

1
const { data: sandbox } = await r.projects.createSandbox('proj_123');
2
3
console.log(sandbox.id);
4
console.log(sandbox.status);  // 'starting' | 'running'
5
console.log(sandbox.message); // 'Sandbox started successfully'

1
const { data: status } = await r.projects.sandbox('proj_123');
2
3
console.log(status.status);    // 'running' | 'stopped' | 'error'
4
console.log(status.e2b_id);    // E2B sandbox ID
5
console.log(status.error);     // Error message if status === 'error'

1
await r.projects.stopSandbox('proj_123');

1
const { data: result } = await r.projects.executeCode('proj_123', {
2
  code: `
3
    const response = await fetch('https://api.example.com/data');
4
    const data = await response.json();
5
    console.log(JSON.stringify(data, null, 2));
6
  `,
7
  language: 'typescript',
8
});
9
10
console.log(result.output);        // stdout output
11
console.log(result.exitCode);      // 0 on success
12
console.log(result.executionTime); // milliseconds

1
const { data: deployment } = await r.projects.deploy('proj_123', {
2
  branch: 'main',
3
  type: 'production',
4
});
5
6
console.log(deployment.id);
7
console.log(deployment.status);         // 'queued' | 'building' | 'deploying' | 'live' | 'failed'
8
console.log(deployment.deployment_url); // Live URL once deployed

1
const { data: preview } = await r.projects.deploy('proj_123', {
2
  branch: 'feature/new-ui',
3
  type: 'preview',
4
});
5
6
console.log(preview.deployment_url); // Unique preview URL

1
const { data: deployments, meta } = await r.projects.deployments('proj_123');
2
3
for (const d of deployments) {
4
  console.log(`${d.id} — ${d.status} — ${d.deployment_url ?? 'pending'}`);
5
}

1
const { data: deployment } = await r.projects.deployment('proj_123', 'deploy_456');
2
3
console.log(deployment.status);
4
console.log(deployment.branch);
5
console.log(deployment.commit_hash);
6
console.log(deployment.created_by?.name);
7
console.log(deployment.started_at);
8
console.log(deployment.completed_at);

1
const { data: logs } = await r.projects.deploymentLogs('proj_123', 'deploy_456');
2
3
console.log(logs.logs); // Build and runtime log output
4
5
// Limit log lines
6
const { data: recentLogs } = await r.projects.deploymentLogs('proj_123', 'deploy_456', {
7
  lines: 50,
8
});

1
import { Recursiv } from '@recursiv/sdk';
2
3
const r = new Recursiv();
4
5
// 1. Create the project
6
const { data: project } = await r.projects.create({
7
  organization_id: 'org_123',
8
  name: 'Hello World App',
9
});
10
console.log('Created project:', project.id);
11
12
// 2. Start a sandbox
13
const { data: sandbox } = await r.projects.createSandbox(project.id);
14
console.log('Sandbox status:', sandbox.status);
15
16
// 3. Execute code in the sandbox
17
const { data: result } = await r.projects.executeCode(project.id, {
18
  code: 'console.log("Hello from Recursiv!")',
19
  language: 'typescript',
20
});
21
console.log('Output:', result.output); // "Hello from Recursiv!\n"
22
23
// 4. Deploy to production
24
const { data: deployment } = await r.projects.deploy(project.id, {
25
  type: 'production',
26
  commit_message: 'Initial deployment',
27
});
28
console.log('Deployment:', deployment.id, deployment.status);
29
30
// 5. Poll for deployment completion
31
let status = deployment.status;
32
while (status !== 'live' && status !== 'failed') {
33
  await new Promise((resolve) => setTimeout(resolve, 5000));
34
  const { data: updated } = await r.projects.deployment(project.id, deployment.id);
35
  status = updated.status;
36
  console.log('Status:', status);
37
}
38
39
// 6. Check deployment logs
40
const { data: logs } = await r.projects.deploymentLogs(project.id, deployment.id);
41
console.log('Logs:', logs.logs);
42
43
// 7. Clean up sandbox when done developing
44
await r.projects.stopSandbox(project.id);