RAZIEL.docs
API Explorer

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.

GET
/api/projects
AuthorizationBearer <token>

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.

POST
/api/projects
AuthorizationBearer <token>

Clerk session token. Automatically set as a cookie in the browser; pass as Authorization: Bearer for server-side calls.

In: header

namestring
repoFullName?string
repoUrl?string
repos?array<object>

Multi-repo: first entry is the primary

defaultBranch?string
Default"main"
description?string
isPrivate?boolean
Defaultfalse
buildAgent?string
Default"claude-code"
instructions?string

AGENTS.md prose (max 10,000 chars)

skills?array<object>
plugins?array<object>
mcps?array<object>
docs?array<object>
tools?array<object>
sandboxSize?string
Default"basic"
Value in"basic" | "standard" | "max"
env?array<object>

Project-scoped secrets injected into builds and sessions

skipBuild?boolean

Create project without running an initial build

Defaultfalse

Response 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).

GET
/api/projects/{id}
AuthorizationBearer <token>

Clerk session token. Automatically set as a cookie in the browser; pass as Authorization: Bearer for server-side calls.

In: header

Path Parameters

idstring

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.

PATCH
/api/projects/{id}
AuthorizationBearer <token>

Clerk session token. Automatically set as a cookie in the browser; pass as Authorization: Bearer for server-side calls.

In: header

Path Parameters

idstring
name?string
description?string
defaultBranch?string
instructions?string

AGENTS.md prose (max 10,000 chars)

skills?array<object>
plugins?array<object>
mcps?array<object>
docs?array<object>
tools?array<object>
sandboxSize?string
Value in"basic" | "standard" | "max"
deployTarget?string
Value in"vercel" | "fly" | ""
deployConfig?object

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).

DELETE
/api/projects/{id}
AuthorizationBearer <token>

Clerk session token. Automatically set as a cookie in the browser; pass as Authorization: Bearer for server-side calls.

In: header

Path Parameters

idstring

Response Body

curl -X DELETE "https://app.raziel.fun/api/projects/string"
Empty
{
  "error": "Unauthorized"
}
{
  "error": "Not found"
}

List project repos

GET
/api/projects/{id}/repos
AuthorizationBearer <token>

Clerk session token. Automatically set as a cookie in the browser; pass as Authorization: Bearer for server-side calls.

In: header

Path Parameters

idstring

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

POST
/api/projects/{id}/repos
AuthorizationBearer <token>

Clerk session token. Automatically set as a cookie in the browser; pass as Authorization: Bearer for server-side calls.

In: header

Path Parameters

idstring
repoFullNamestring
repoUrlstring
defaultBranch?string
Default"main"
clonePath?string
isPrimary?boolean

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

DELETE
/api/projects/{id}/repos/{repoId}
AuthorizationBearer <token>

Clerk session token. Automatically set as a cookie in the browser; pass as Authorization: Bearer for server-side calls.

In: header

Path Parameters

idstring
repoIdstring

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.

GET
/api/projects/{id}/secrets
AuthorizationBearer <token>

Clerk session token. Automatically set as a cookie in the browser; pass as Authorization: Bearer for server-side calls.

In: header

Path Parameters

idstring

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

POST
/api/projects/{id}/secrets
AuthorizationBearer <token>

Clerk session token. Automatically set as a cookie in the browser; pass as Authorization: Bearer for server-side calls.

In: header

Path Parameters

idstring
keystring
valuestring

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

DELETE
/api/projects/{id}/secrets/{secretId}
AuthorizationBearer <token>

Clerk session token. Automatically set as a cookie in the browser; pass as Authorization: Bearer for server-side calls.

In: header

Path Parameters

idstring
secretIdstring

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.

POST
/api/projects/{id}/build
AuthorizationBearer <token>

Clerk session token. Automatically set as a cookie in the browser; pass as Authorization: Bearer for server-side calls.

In: header

Path Parameters

idstring
agent?string
Default"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).

GET
/api/projects/{id}/deploy
AuthorizationBearer <token>

Clerk session token. Automatically set as a cookie in the browser; pass as Authorization: Bearer for server-side calls.

In: header

Path Parameters

idstring

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.

POST
/api/projects/{id}/deploy
AuthorizationBearer <token>

Clerk session token. Automatically set as a cookie in the browser; pass as Authorization: Bearer for server-side calls.

In: header

Path Parameters

idstring

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"
}
Empty

Get project activity

Returns recent sessions and builds for the project.

GET
/api/projects/{id}/activity
AuthorizationBearer <token>

Clerk session token. Automatically set as a cookie in the browser; pass as Authorization: Bearer for server-side calls.

In: header

Path Parameters

idstring

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.

GET
/api/projects/{id}/mcps
AuthorizationBearer <token>

Clerk session token. Automatically set as a cookie in the browser; pass as Authorization: Bearer for server-side calls.

In: header

Path Parameters

idstring

Response Body

curl -X GET "https://app.raziel.fun/api/projects/string/mcps"
{
  "mcps": [
    {}
  ]
}
{
  "error": "Unauthorized"
}
{
  "error": "Not found"
}