Rest API

Get user enclaves

get

Retrieve all enclaves associated with a wallet address

Authorizations
Query parameters
walletstringRequired

Wallet address to filter enclaves

Example: 0x4B0897b0513fdc7C541B6d9D7E929C4e5364D2dB
Responses
200

List of enclaves

application/json
get
GET /api/enclaves HTTP/1.1
Host: app.trezalabs.com
Authorization: Bearer JWT
Accept: */*

{
  "enclaves": [
    {
      "id": "enc_123456",
      "name": "Trading Bot Enclave",
      "description": "Secure environment for automated trading strategies",
      "status": "PENDING_DEPLOY",
      "region": "us-east-1",
      "walletAddress": "0x4B0897b0513fdc7C541B6d9D7E929C4e5364D2dB",
      "providerId": "aws-nitro",
      "providerConfig": {
        "dockerImage": "my-app:latest",
        "cpuCount": 2,
        "memoryMiB": 512
      },
      "createdAt": "2024-01-15T00:00:00Z",
      "updatedAt": "2024-01-15T00:00:00Z",
      "githubConnection": {
        "isConnected": true,
        "username": "example-user",
        "selectedRepo": "example-user/trading-bot",
        "selectedBranch": "main",
        "accessToken": "gho_xxxxxxxxxxxxxxxxxxxx"
      },
      "error_message": "Deployment failed: Instance type not compatible with Nitro Enclaves"
    }
  ]
}

Create new enclave

post

Create a new secure enclave

Authorizations
Body
namestringRequiredExample: Trading Bot Enclave
descriptionstringRequiredExample: Secure environment for automated trading strategies
regionstringRequiredExample: us-east-1
walletAddressstringRequiredExample: 0x4B0897b0513fdc7C541B6d9D7E929C4e5364D2dB
providerIdstringRequiredExample: aws-nitro
providerConfigobjectOptionalExample: {"dockerImage":"my-app:latest","cpuCount":2,"memoryMiB":512}
Responses
201

Enclave created successfully

application/json
post
POST /api/enclaves HTTP/1.1
Host: app.trezalabs.com
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 456

{
  "name": "Trading Bot Enclave",
  "description": "Secure environment for automated trading strategies",
  "region": "us-east-1",
  "walletAddress": "0x4B0897b0513fdc7C541B6d9D7E929C4e5364D2dB",
  "providerId": "aws-nitro",
  "providerConfig": {
    "dockerImage": "my-app:latest",
    "cpuCount": 2,
    "memoryMiB": 512
  },
  "githubConnection": {
    "isConnected": true,
    "username": "example-user",
    "selectedRepo": "example-user/trading-bot",
    "selectedBranch": "main",
    "accessToken": "gho_xxxxxxxxxxxxxxxxxxxx"
  }
}
{
  "enclave": {
    "id": "enc_123456",
    "name": "Trading Bot Enclave",
    "description": "Secure environment for automated trading strategies",
    "status": "PENDING_DEPLOY",
    "region": "us-east-1",
    "walletAddress": "0x4B0897b0513fdc7C541B6d9D7E929C4e5364D2dB",
    "providerId": "aws-nitro",
    "providerConfig": {
      "dockerImage": "my-app:latest",
      "cpuCount": 2,
      "memoryMiB": 512
    },
    "createdAt": "2024-01-15T00:00:00Z",
    "updatedAt": "2024-01-15T00:00:00Z",
    "githubConnection": {
      "isConnected": true,
      "username": "example-user",
      "selectedRepo": "example-user/trading-bot",
      "selectedBranch": "main",
      "accessToken": "gho_xxxxxxxxxxxxxxxxxxxx"
    },
    "error_message": "Deployment failed: Instance type not compatible with Nitro Enclaves"
  }
}

Update enclave

put

Update an existing enclave

Authorizations
Body
idstringRequiredExample: enc_123456
namestringOptionalExample: Updated Enclave Name
descriptionstringOptionalExample: Updated description
regionstringOptionalExample: us-west-2
walletAddressstringRequiredExample: 0x4B0897b0513fdc7C541B6d9D7E929C4e5364D2dB
providerIdstringOptionalExample: aws-nitro
providerConfigobjectOptionalExample: {"dockerImage":"my-app:v2","cpuCount":4,"memoryMiB":1024}
Responses
200

Enclave updated successfully

application/json
put
PUT /api/enclaves HTTP/1.1
Host: app.trezalabs.com
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 440

{
  "id": "enc_123456",
  "name": "Updated Enclave Name",
  "description": "Updated description",
  "region": "us-west-2",
  "walletAddress": "0x4B0897b0513fdc7C541B6d9D7E929C4e5364D2dB",
  "providerId": "aws-nitro",
  "providerConfig": {
    "dockerImage": "my-app:v2",
    "cpuCount": 4,
    "memoryMiB": 1024
  },
  "githubConnection": {
    "isConnected": true,
    "username": "example-user",
    "selectedRepo": "example-user/trading-bot",
    "selectedBranch": "main",
    "accessToken": "gho_xxxxxxxxxxxxxxxxxxxx"
  }
}
{
  "enclave": {
    "id": "enc_123456",
    "name": "Trading Bot Enclave",
    "description": "Secure environment for automated trading strategies",
    "status": "PENDING_DEPLOY",
    "region": "us-east-1",
    "walletAddress": "0x4B0897b0513fdc7C541B6d9D7E929C4e5364D2dB",
    "providerId": "aws-nitro",
    "providerConfig": {
      "dockerImage": "my-app:latest",
      "cpuCount": 2,
      "memoryMiB": 512
    },
    "createdAt": "2024-01-15T00:00:00Z",
    "updatedAt": "2024-01-15T00:00:00Z",
    "githubConnection": {
      "isConnected": true,
      "username": "example-user",
      "selectedRepo": "example-user/trading-bot",
      "selectedBranch": "main",
      "accessToken": "gho_xxxxxxxxxxxxxxxxxxxx"
    },
    "error_message": "Deployment failed: Instance type not compatible with Nitro Enclaves"
  }
}

Delete enclave

delete

Delete an existing enclave

Authorizations
Query parameters
idstringRequired

Enclave ID to delete

Example: enc_123456
walletstringRequired

Wallet address for authorization

Example: 0x4B0897b0513fdc7C541B6d9D7E929C4e5364D2dB
Responses
200

Enclave deleted successfully

application/json
delete
DELETE /api/enclaves HTTP/1.1
Host: app.trezalabs.com
Authorization: Bearer JWT
Accept: */*

{
  "message": "Enclave deleted successfully"
}

Get available providers

get

Retrieve all available enclave providers or a specific provider by ID

Authorizations
Query parameters
idstringOptional

Specific provider ID to retrieve

Example: aws-nitro
Responses
200

Provider(s) retrieved successfully

application/json
Responseone of
or
get
GET /api/providers HTTP/1.1
Host: app.trezalabs.com
Authorization: Bearer JWT
Accept: */*

{
  "providers": [
    {
      "id": "aws-nitro",
      "name": "AWS Nitro Enclaves",
      "description": "Secure isolated compute environments using AWS Nitro technology",
      "regions": [
        "us-east-1",
        "us-west-2",
        "eu-west-1"
      ],
      "configSchema": {
        "dockerImage": {
          "type": "string",
          "label": "Docker Image",
          "required": true,
          "description": "Container image to deploy"
        },
        "cpuCount": {
          "type": "number",
          "label": "CPU Count",
          "defaultValue": 2,
          "validation": {
            "min": 1,
            "max": 8
          }
        }
      }
    }
  ]
}

Initiate GitHub OAuth flow

get

Get GitHub OAuth authorization URL

Authorizations
Query parameters
statestringOptional

Optional state parameter for OAuth flow

Responses
200

GitHub OAuth URL generated

application/json
get
GET /api/github/auth HTTP/1.1
Host: app.trezalabs.com
Authorization: Bearer JWT
Accept: */*

{
  "authUrl": "https://github.com/login/oauth/authorize?client_id=...",
  "state": "abc123"
}

Exchange OAuth code for access token

post

Exchange GitHub OAuth authorization code for access token

Authorizations
Body
codestringRequired

OAuth authorization code from GitHub

Example: abcdef123456
statestringOptional

State parameter from OAuth flow

Example: abc123
Responses
200

Access token obtained successfully

application/json
post
POST /api/github/auth HTTP/1.1
Host: app.trezalabs.com
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 40

{
  "code": "abcdef123456",
  "state": "abc123"
}
{
  "access_token": "gho_xxxxxxxxxxxxxxxxxxxx",
  "user": {
    "id": 12345,
    "login": "username",
    "name": "John Doe",
    "avatar_url": "https://avatars.githubusercontent.com/u/12345"
  }
}

GitHub OAuth callback

get

Handle GitHub OAuth callback and redirect to platform

Authorizations
Query parameters
codestringOptional

OAuth authorization code

statestringOptional

OAuth state parameter

errorstringOptional

OAuth error if any

Responses
302

Redirect to platform page with success or error parameters

No content
get
GET /api/github/callback HTTP/1.1
Host: app.trezalabs.com
Authorization: Bearer JWT
Accept: */*
302

Redirect to platform page with success or error parameters

No content

Get user repositories

get

Fetch GitHub repositories for authenticated user

Authorizations
Query parameters
tokenstringRequired

GitHub access token

Example: gho_xxxxxxxxxxxxxxxxxxxx
Responses
200

List of repositories

application/json
get
GET /api/github/repositories HTTP/1.1
Host: app.trezalabs.com
Authorization: Bearer JWT
Accept: */*

{
  "repositories": [
    {
      "id": 123456,
      "name": "my-repo",
      "fullName": "username/my-repo",
      "description": "A sample repository",
      "private": false,
      "defaultBranch": "main",
      "language": "TypeScript",
      "updatedAt": "2024-01-15T00:00:00Z",
      "htmlUrl": "https://github.com/username/my-repo"
    }
  ]
}

Get repository branches

post

Fetch branches for a specific repository

Authorizations
Body
accessTokenstringRequiredExample: gho_xxxxxxxxxxxxxxxxxxxx
repositorystringRequiredExample: username/repo-name
Responses
200

List of branches

application/json
post
POST /api/github/repositories HTTP/1.1
Host: app.trezalabs.com
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 76

{
  "accessToken": "gho_xxxxxxxxxxxxxxxxxxxx",
  "repository": "username/repo-name"
}
{
  "branches": [
    {
      "name": "main",
      "commit": {
        "sha": "abc123def456",
        "url": "https://api.github.com/repos/username/repo/commits/abc123def456"
      }
    }
  ]
}

Get API keys

get

Retrieve all API keys for the authenticated user

Authorizations
Query parameters
walletstringRequired

Wallet address to filter API keys

Example: 0x4B0897b0513fdc7C541B6d9D7E929C4e5364D2dB
Responses
200

List of API keys

application/json
get
GET /api/api-keys HTTP/1.1
Host: app.trezalabs.com
Authorization: Bearer JWT
Accept: */*

{
  "apiKeys": [
    {
      "id": "key_123456",
      "name": "Production API Key",
      "key": "api_key_example_12345",
      "keyHash": "sha256_hash_of_key",
      "permissions": [
        "enclaves:read",
        "tasks:read"
      ],
      "status": "active",
      "walletAddress": "0x4B0897b0513fdc7C541B6d9D7E929C4e5364D2dB",
      "createdAt": "2024-01-15T00:00:00Z",
      "updatedAt": "2024-01-15T00:00:00Z",
      "lastUsed": "2024-01-15T12:30:00Z"
    }
  ]
}

Create API key

post

Create a new API key with specified permissions

Authorizations
Body
namestringRequiredExample: Production API Key
walletAddressstringRequiredExample: 0x4B0897b0513fdc7C541B6d9D7E929C4e5364D2dB
Responses
201

API key created successfully

application/json
post
POST /api/api-keys HTTP/1.1
Host: app.trezalabs.com
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 135

{
  "name": "Production API Key",
  "permissions": [
    "enclaves:read",
    "tasks:read"
  ],
  "walletAddress": "0x4B0897b0513fdc7C541B6d9D7E929C4e5364D2dB"
}
{
  "apiKey": {
    "id": "key_123456",
    "name": "Production API Key",
    "key": "api_key_example_12345",
    "keyHash": "sha256_hash_of_key",
    "permissions": [
      "enclaves:read",
      "tasks:read"
    ],
    "status": "active",
    "walletAddress": "0x4B0897b0513fdc7C541B6d9D7E929C4e5364D2dB",
    "createdAt": "2024-01-15T00:00:00Z",
    "updatedAt": "2024-01-15T00:00:00Z",
    "lastUsed": "2024-01-15T12:30:00Z"
  }
}

Update API key

put

Update an existing API key

Authorizations
Body
idstringRequiredExample: key_123456
namestringOptionalExample: Updated API Key Name
statusstring · enumOptionalExample: activePossible values:
walletAddressstringRequiredExample: 0x4B0897b0513fdc7C541B6d9D7E929C4e5364D2dB
Responses
200

API key updated successfully

application/json
put
PUT /api/api-keys HTTP/1.1
Host: app.trezalabs.com
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 177

{
  "id": "key_123456",
  "name": "Updated API Key Name",
  "permissions": [
    "enclaves:read",
    "enclaves:write"
  ],
  "status": "active",
  "walletAddress": "0x4B0897b0513fdc7C541B6d9D7E929C4e5364D2dB"
}
{
  "apiKey": {
    "id": "key_123456",
    "name": "Production API Key",
    "key": "api_key_example_12345",
    "keyHash": "sha256_hash_of_key",
    "permissions": [
      "enclaves:read",
      "tasks:read"
    ],
    "status": "active",
    "walletAddress": "0x4B0897b0513fdc7C541B6d9D7E929C4e5364D2dB",
    "createdAt": "2024-01-15T00:00:00Z",
    "updatedAt": "2024-01-15T00:00:00Z",
    "lastUsed": "2024-01-15T12:30:00Z"
  }
}

Delete API key

delete

Delete an existing API key

Authorizations
Query parameters
idstringRequired

API key ID to delete

Example: key_123456
walletstringRequired

Wallet address for authorization

Example: 0x4B0897b0513fdc7C541B6d9D7E929C4e5364D2dB
Responses
200

API key deleted successfully

application/json
delete
DELETE /api/api-keys HTTP/1.1
Host: app.trezalabs.com
Authorization: Bearer JWT
Accept: */*

{
  "message": "API key deleted successfully"
}

Get tasks

get

Retrieve tasks for the authenticated user, optionally filtered by enclave

Authorizations
Query parameters
walletstringRequired

Wallet address to filter tasks

Example: 0x4B0897b0513fdc7C541B6d9D7E929C4e5364D2dB
enclavestringOptional

Optional enclave ID to filter tasks

Example: enc_123456
Responses
200

List of tasks

application/json
get
GET /api/tasks HTTP/1.1
Host: app.trezalabs.com
Authorization: Bearer JWT
Accept: */*

{
  "tasks": [
    {
      "id": "task_123456",
      "name": "Daily Price Monitor",
      "description": "Monitor cryptocurrency prices and send alerts",
      "enclaveId": "enc_123456",
      "status": "pending",
      "schedule": "0 9 * * *",
      "walletAddress": "0x4B0897b0513fdc7C541B6d9D7E929C4e5364D2dB",
      "createdAt": "2024-01-15T00:00:00Z",
      "updatedAt": "2024-01-15T00:00:00Z",
      "lastRun": "2024-01-15T09:00:00Z"
    }
  ]
}

Create task

post

Create a new task within an enclave

Authorizations
Body
namestringRequiredExample: Daily Price Monitor
descriptionstringRequiredExample: Monitor cryptocurrency prices and send alerts
enclaveIdstringRequiredExample: enc_123456
schedulestringRequired

Cron-style schedule expression

Example: 0 9 * * *
walletAddressstringRequiredExample: 0x4B0897b0513fdc7C541B6d9D7E929C4e5364D2dB
Responses
201

Task created successfully

application/json
post
POST /api/tasks HTTP/1.1
Host: app.trezalabs.com
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 201

{
  "name": "Daily Price Monitor",
  "description": "Monitor cryptocurrency prices and send alerts",
  "enclaveId": "enc_123456",
  "schedule": "0 9 * * *",
  "walletAddress": "0x4B0897b0513fdc7C541B6d9D7E929C4e5364D2dB"
}
{
  "task": {
    "id": "task_123456",
    "name": "Daily Price Monitor",
    "description": "Monitor cryptocurrency prices and send alerts",
    "enclaveId": "enc_123456",
    "status": "pending",
    "schedule": "0 9 * * *",
    "walletAddress": "0x4B0897b0513fdc7C541B6d9D7E929C4e5364D2dB",
    "createdAt": "2024-01-15T00:00:00Z",
    "updatedAt": "2024-01-15T00:00:00Z",
    "lastRun": "2024-01-15T09:00:00Z"
  }
}

Update task

put

Update an existing task

Authorizations
Body
idstringRequiredExample: task_123456
namestringOptionalExample: Updated Task Name
descriptionstringOptionalExample: Updated task description
schedulestringOptionalExample: 0 */6 * * *
statusstring · enumOptionalExample: runningPossible values:
walletAddressstringRequiredExample: 0x4B0897b0513fdc7C541B6d9D7E929C4e5364D2dB
Responses
200

Task updated successfully

application/json
put
PUT /api/tasks HTTP/1.1
Host: app.trezalabs.com
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 193

{
  "id": "task_123456",
  "name": "Updated Task Name",
  "description": "Updated task description",
  "schedule": "0 */6 * * *",
  "status": "running",
  "walletAddress": "0x4B0897b0513fdc7C541B6d9D7E929C4e5364D2dB"
}
{
  "task": {
    "id": "task_123456",
    "name": "Daily Price Monitor",
    "description": "Monitor cryptocurrency prices and send alerts",
    "enclaveId": "enc_123456",
    "status": "pending",
    "schedule": "0 9 * * *",
    "walletAddress": "0x4B0897b0513fdc7C541B6d9D7E929C4e5364D2dB",
    "createdAt": "2024-01-15T00:00:00Z",
    "updatedAt": "2024-01-15T00:00:00Z",
    "lastRun": "2024-01-15T09:00:00Z"
  }
}

Delete task

delete

Delete an existing task

Authorizations
Query parameters
idstringRequired

Task ID to delete

Example: task_123456
walletstringRequired

Wallet address for authorization

Example: 0x4B0897b0513fdc7C541B6d9D7E929C4e5364D2dB
Responses
200

Task deleted successfully

application/json
delete
DELETE /api/tasks HTTP/1.1
Host: app.trezalabs.com
Authorization: Bearer JWT
Accept: */*

{
  "message": "Task deleted successfully"
}
PreviousTreza SDKNextExamples

Last updated