Skip to main content

Project

The Project object represents a logical grouping of resources, deployments, and configurations within an organization. Projects enable multi-environment management (e.g., production, staging, development).

Schema: ProjectSchema Source: src/core/account/project.schema.ts


Attributes

AttributeTypeRequiredDefaultDescription
idstringUnique identifier for the project
namestringYesProject name (minimum 2 characters)
regionIdstringNoTravnex region ID (can inherit from organization)
descriptionstringNoDescription of the project's purpose
compliancearray<string>NoCompliance standards (e.g., ["SOC2", "HIPAA"])
isDefaultbooleanWhether this is the default project (system-managed)
serviceStatusenumNoACTIVECurrent service status. One of ACTIVE, SUSPENDED, or INACTIVE.
metadataobjectNoCustom key-value metadata
createdAtnumberUnix timestamp when created
updatedAtnumberUnix timestamp when last updated

Example

{
"id": "proj_abc123",
"name": "Production Environment",
"regionId": "us-west-2",
"description": "Main production deployment project",
"compliance": ["SOC2", "HIPAA"],
"isDefault": true,
"serviceStatus": "ACTIVE",
"metadata": {
"environment": "production"
},
"createdAt": 1709856000000,
"updatedAt": 1709856000000
}

Create / Update Schemas

SchemaDescriptionOmits
CreateProjectSchemaFor creating new projectsid, createdAt, updatedAt, isDefault
UpdateProjectSchemaFor partial updatesAll fields optional except id

Create Example

const newProject: CreateProject = {
name: "Development Environment",
description: "Development and testing project"
};

Update Example

const updateProject: UpdateProject = {
id: "proj_abc123",
name: "Production Environment v2",
description: "Updated production deployment"
};