Projects
Projects group sessions around a GitHub repository with shared agent context
List projects
Returns all projects for the authenticated scope, ordered by creation date descending.
Clerk session token. Automatically set as a cookie in the browser; pass as Authorization: Bearer for server-side calls.
In: header
Response Body
curl -X GET "https://app.raziel.fun/api/projects"{
"projects": [
{
"id": "clx1234abc",
"userId": "string",
"orgId": "string",
"name": "My App",
"slug": "my-app",
"repoFullName": "owner/repo",
"repoUrl": "https://github.com/owner/repo.git",
"defaultBranch": "main",
"description": "string",
"isPrivate": true,
"latestBuildId": "string",
"instructions": "string",
"skills": [
{}
],
"plugins": [
{}
],
"mcps": [
{}
],
"docs": [
{}
],
"tools": [
{}
],
"sandboxSize": "basic",
"deployTarget": "vercel",
"lastDeployUrl": "string",
"lastDeployAt": "2019-08-24T14:15:22Z",
"createdAt": "2019-08-24T14:15:22Z",
"updatedAt": "2019-08-24T14:15:22Z"
}
]
}{
"error": "Unauthorized"
}Create a project
Creates a project and optionally kicks off an initial build that clones the repo, installs dependencies, and snapshots the sandbox. Pass skipBuild: true to create the project immediately without building.
Clerk session token. Automatically set as a cookie in the browser; pass as Authorization: Bearer for server-side calls.
In: header
Multi-repo: first entry is the primary
"main"false"claude-code"AGENTS.md prose (max 10,000 chars)
"basic""basic" | "standard" | "max"Project-scoped secrets injected into builds and sessions
Create project without running an initial build
falseResponse Body
curl -X POST "https://app.raziel.fun/api/projects" \
-H "Content-Type: application/json" \
-d '{
"name": "My App"
}'{
"project": {
"id": "clx1234abc",
"userId": "string",
"orgId": "string",
"name": "My App",
"slug": "my-app",
"repoFullName": "owner/repo",
"repoUrl": "https://github.com/owner/repo.git",
"defaultBranch": "main",
"description": "string",
"isPrivate": true,
"latestBuildId": "string",
"instructions": "string",
"skills": [
{}
],
"plugins": [
{}
],
"mcps": [
{}
],
"docs": [
{}
],
"tools": [
{}
],
"sandboxSize": "basic",
"deployTarget": "vercel",
"lastDeployUrl": "string",
"lastDeployAt": "2019-08-24T14:15:22Z",
"createdAt": "2019-08-24T14:15:22Z",
"updatedAt": "2019-08-24T14:15:22Z"
},
"build": {
"id": "string",
"projectId": "string",
"agent": "claude-code",
"status": "queued",
"runCommand": "string",
"snapshotId": "string",
"logs": "string",
"errorMessage": "string",
"createdAt": "2019-08-24T14:15:22Z",
"updatedAt": "2019-08-24T14:15:22Z"
}
}{
"error": "Not found"
}{
"error": "Unauthorized"
}Get a project
Returns the project and its build history (newest first, up to 20).
Clerk session token. Automatically set as a cookie in the browser; pass as Authorization: Bearer for server-side calls.
In: header
Path Parameters
Response Body
curl -X GET "https://app.raziel.fun/api/projects/string"{
"project": {
"id": "clx1234abc",
"userId": "string",
"orgId": "string",
"name": "My App",
"slug": "my-app",
"repoFullName": "owner/repo",
"repoUrl": "https://github.com/owner/repo.git",
"defaultBranch": "main",
"description": "string",
"isPrivate": true,
"latestBuildId": "string",
"instructions": "string",
"skills": [
{}
],
"plugins": [
{}
],
"mcps": [
{}
],
"docs": [
{}
],
"tools": [
{}
],
"sandboxSize": "basic",
"deployTarget": "vercel",
"lastDeployUrl": "string",
"lastDeployAt": "2019-08-24T14:15:22Z",
"createdAt": "2019-08-24T14:15:22Z",
"updatedAt": "2019-08-24T14:15:22Z"
},
"builds": [
{
"id": "string",
"projectId": "string",
"agent": "claude-code",
"status": "queued",
"runCommand": "string",
"snapshotId": "string",
"logs": "string",
"errorMessage": "string",
"createdAt": "2019-08-24T14:15:22Z",
"updatedAt": "2019-08-24T14:15:22Z"
}
]
}{
"error": "Unauthorized"
}{
"error": "Not found"
}Update a project
Updates editable fields. Changes apply to new sessions and builds; no rebuild is triggered.
Clerk session token. Automatically set as a cookie in the browser; pass as Authorization: Bearer for server-side calls.
In: header
Path Parameters
AGENTS.md prose (max 10,000 chars)
"basic" | "standard" | "max""vercel" | "fly" | ""Response Body
curl -X PATCH "https://app.raziel.fun/api/projects/string" \
-H "Content-Type: application/json" \
-d '{}'{
"project": {
"id": "clx1234abc",
"userId": "string",
"orgId": "string",
"name": "My App",
"slug": "my-app",
"repoFullName": "owner/repo",
"repoUrl": "https://github.com/owner/repo.git",
"defaultBranch": "main",
"description": "string",
"isPrivate": true,
"latestBuildId": "string",
"instructions": "string",
"skills": [
{}
],
"plugins": [
{}
],
"mcps": [
{}
],
"docs": [
{}
],
"tools": [
{}
],
"sandboxSize": "basic",
"deployTarget": "vercel",
"lastDeployUrl": "string",
"lastDeployAt": "2019-08-24T14:15:22Z",
"createdAt": "2019-08-24T14:15:22Z",
"updatedAt": "2019-08-24T14:15:22Z"
}
}{
"error": "Not found"
}{
"error": "Unauthorized"
}{
"error": "Not found"
}Delete a project
Permanently deletes the project and all related data (cascade).
Clerk session token. Automatically set as a cookie in the browser; pass as Authorization: Bearer for server-side calls.
In: header
Path Parameters
Response Body
curl -X DELETE "https://app.raziel.fun/api/projects/string"{
"error": "Unauthorized"
}{
"error": "Not found"
}List project repos
Clerk session token. Automatically set as a cookie in the browser; pass as Authorization: Bearer for server-side calls.
In: header
Path Parameters
Response Body
curl -X GET "https://app.raziel.fun/api/projects/string/repos"{
"repos": [
{
"id": "string",
"projectId": "string",
"repoFullName": "owner/repo",
"repoUrl": "https://github.com/owner/repo.git",
"defaultBranch": "main",
"clonePath": "repo",
"isPrimary": true,
"createdAt": "2019-08-24T14:15:22Z"
}
]
}{
"error": "Unauthorized"
}{
"error": "Not found"
}Add a repo to a project
Clerk session token. Automatically set as a cookie in the browser; pass as Authorization: Bearer for server-side calls.
In: header
Path Parameters
"main"Response Body
curl -X POST "https://app.raziel.fun/api/projects/string/repos" \
-H "Content-Type: application/json" \
-d '{
"repoFullName": "string",
"repoUrl": "string"
}'{
"repo": {
"id": "string",
"projectId": "string",
"repoFullName": "owner/repo",
"repoUrl": "https://github.com/owner/repo.git",
"defaultBranch": "main",
"clonePath": "repo",
"isPrimary": true,
"createdAt": "2019-08-24T14:15:22Z"
}
}{
"error": "Unauthorized"
}{
"error": "Not found"
}Remove a repo from a project
Clerk session token. Automatically set as a cookie in the browser; pass as Authorization: Bearer for server-side calls.
In: header
Path Parameters
Response Body
curl -X DELETE "https://app.raziel.fun/api/projects/string/repos/string"{
"ok": true
}{
"error": "Unauthorized"
}{
"error": "Not found"
}List project secrets
Returns secret metadata (key + hint) without plaintext values.
Clerk session token. Automatically set as a cookie in the browser; pass as Authorization: Bearer for server-side calls.
In: header
Path Parameters
Response Body
curl -X GET "https://app.raziel.fun/api/projects/string/secrets"{
"secrets": [
{
"id": "string",
"key": "string",
"valueHint": "string",
"createdAt": "2019-08-24T14:15:22Z"
}
]
}{
"error": "Unauthorized"
}{
"error": "Not found"
}Create a project secret
Clerk session token. Automatically set as a cookie in the browser; pass as Authorization: Bearer for server-side calls.
In: header
Path Parameters
Response Body
curl -X POST "https://app.raziel.fun/api/projects/string/secrets" \
-H "Content-Type: application/json" \
-d '{
"key": "DATABASE_URL",
"value": "postgres://..."
}'{
"secret": {
"id": "string",
"key": "string",
"valueHint": "string"
}
}{
"error": "Not found"
}{
"error": "Unauthorized"
}{
"error": "Not found"
}Delete a project secret
Clerk session token. Automatically set as a cookie in the browser; pass as Authorization: Bearer for server-side calls.
In: header
Path Parameters
Response Body
curl -X DELETE "https://app.raziel.fun/api/projects/string/secrets/string"{
"ok": true
}{
"error": "Unauthorized"
}{
"error": "Not found"
}Trigger a project build
Queues a new build that clones the repo, installs dependencies, and snapshots the sandbox. New sessions boot from the latest ready snapshot.
Clerk session token. Automatically set as a cookie in the browser; pass as Authorization: Bearer for server-side calls.
In: header
Path Parameters
"claude-code"Response Body
curl -X POST "https://app.raziel.fun/api/projects/string/build" \
-H "Content-Type: application/json" \
-d '{}'{
"build": {
"id": "string",
"projectId": "string",
"agent": "claude-code",
"status": "queued",
"runCommand": "string",
"snapshotId": "string",
"logs": "string",
"errorMessage": "string",
"createdAt": "2019-08-24T14:15:22Z",
"updatedAt": "2019-08-24T14:15:22Z"
}
}{
"error": "Unauthorized"
}{
"error": "Not found"
}Get deployment status
Returns the last deployment URL, timestamp, and live status (for Vercel deployments).
Clerk session token. Automatically set as a cookie in the browser; pass as Authorization: Bearer for server-side calls.
In: header
Path Parameters
Response Body
curl -X GET "https://app.raziel.fun/api/projects/string/deploy"{
"deployTarget": "string",
"lastDeployUrl": "string",
"lastDeployAt": "2019-08-24T14:15:22Z",
"liveStatus": "string"
}{
"error": "Unauthorized"
}{
"error": "Not found"
}Trigger a deployment
Triggers a deployment to the configured target (Vercel or Fly.io). Requires deployTarget and deployConfig to be set on the project.
Clerk session token. Automatically set as a cookie in the browser; pass as Authorization: Bearer for server-side calls.
In: header
Path Parameters
Response Body
curl -X POST "https://app.raziel.fun/api/projects/string/deploy"{
"url": "string",
"deploymentId": "string",
"lastDeployAt": "2019-08-24T14:15:22Z"
}{
"error": "Not found"
}{
"error": "Unauthorized"
}{
"error": "Not found"
}Get project activity
Returns recent sessions and builds for the project.
Clerk session token. Automatically set as a cookie in the browser; pass as Authorization: Bearer for server-side calls.
In: header
Path Parameters
Response Body
curl -X GET "https://app.raziel.fun/api/projects/string/activity"{
"sessions": [
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"userId": "string",
"orgId": "string",
"projectId": "string",
"sandboxId": "xyz789abc",
"agent": "claude-code",
"image": "raziel-agents",
"prompt": "Refactor the auth module",
"repoUrl": "https://github.com/owner/repo.git",
"branch": "main",
"workBranch": "raziel/alice/refactor-auth-550e",
"prNumber": 0,
"prUrl": "string",
"headSha": "string",
"status": "running",
"snapshotName": "string",
"agentStarted": true,
"inputTokens": 10000,
"outputTokens": 2500,
"estimatedCostUsd": 0.0312,
"exitCode": 0,
"errorMessage": "string",
"shareToken": "string",
"sharedAt": "2019-08-24T14:15:22Z",
"aiSummary": "string",
"summaryAt": "2019-08-24T14:15:22Z",
"forkedFromId": "string",
"tags": [
"auth",
"refactor"
],
"startedAt": "2019-08-24T14:15:22Z",
"stoppedAt": "2019-08-24T14:15:22Z"
}
],
"builds": [
{
"id": "string",
"projectId": "string",
"agent": "claude-code",
"status": "queued",
"runCommand": "string",
"snapshotId": "string",
"logs": "string",
"errorMessage": "string",
"createdAt": "2019-08-24T14:15:22Z",
"updatedAt": "2019-08-24T14:15:22Z"
}
]
}{
"error": "Unauthorized"
}{
"error": "Not found"
}Get project MCP configuration
Returns the MCP server list configured for this project.
Clerk session token. Automatically set as a cookie in the browser; pass as Authorization: Bearer for server-side calls.
In: header
Path Parameters
Response Body
curl -X GET "https://app.raziel.fun/api/projects/string/mcps"{
"mcps": [
{}
]
}{
"error": "Unauthorized"
}{
"error": "Not found"
}