Projects API

Create, manage, and monitor your Teenode projects via the REST API.

List Projects

Retrieve all projects for your team:

curl https://api.teenode.com/v1/projects \
  -H "Authorization: Bearer YOUR_API_KEY"

Response:

{
  "projects": [
    {
      "id": "proj_abc123",
      "name": "my-app",
      "type": "GIT_DEPLOY",
      "status": "ACTIVE",
      "region": "us-east",
      "created_at": "2024-01-15T10:30:00Z",
      "updated_at": "2024-01-15T10:35:00Z"
    }
  ],
  "total": 1,
  "page": 1,
  "per_page": 20
}

Create a Project

Create a new TEE VM project:

curl -X POST https://api.teenode.com/v1/projects \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "my-secure-vm",
    "type": "TEE_VM",
    "region": "us-east",
    "specs": {
      "cpu": 2,
      "memory": 4096,
      "disk": 50
    }
  }'

Create a Git Deploy project:

curl -X POST https://api.teenode.com/v1/projects \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "my-app",
    "type": "GIT_DEPLOY",
    "region": "us-west",
    "git_config": {
      "url": "https://github.com/yourusername/your-app",
      "branch": "main",
      "build_command": "npm run build",
      "start_command": "npm start"
    }
  }'

Get Project Details

Retrieve detailed information about a specific project:

curl https://api.teenode.com/v1/projects/proj_abc123 \
  -H "Authorization: Bearer YOUR_API_KEY"

Update a Project

Update project configuration:

curl -X PATCH https://api.teenode.com/v1/projects/proj_abc123 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "updated-name",
    "specs": {
      "cpu": 4,
      "memory": 8192
    }
  }'

Updating specs may cause your project to restart. Plan accordingly.

Delete a Project

Permanently delete a project:

curl -X DELETE https://api.teenode.com/v1/projects/proj_abc123 \
  -H "Authorization: Bearer YOUR_API_KEY"

This action cannot be undone. All data associated with the project will be permanently deleted.

Project Types

TEE_VM - Trusted Execution Environment Virtual Machine
GIT_DEPLOY - Automated deployment from Git repository
CONTAINER - Docker container deployment

Project Status

CREATING - Project is being provisioned
ACTIVE - Project is running and healthy
STOPPED - Project is stopped
ERROR - Project encountered an error
DELETING - Project is being deleted

Query Parameters

Filter and paginate results:

curl "https://api.teenode.com/v1/projects?page=1&per_page=20&type=TEE_VM&status=ACTIVE" \
  -H "Authorization: Bearer YOUR_API_KEY"

Related Resources

PreviousAPI Authentication

NextAPI Deployments