Projects

Input — request body

name string required

Project name

members array

Optional seed members (max 20). Each item: { email: string, role?: "admin"|"member"|"viewer" (default "member") }

Input — example request

{
  "name": "My App",
  "members": [
    {
      "email": "teammate@example.com",
      "role": "admin"
    }
  ]
}

Output — example response (201)

{
  "id": "ugtp_project_a1b2c3d4e5f6",
  "name": "My App",
  "apiKey": {
    "id": "ugtp_project_api_key_a1b2c3d4e5f6",
    "name": "My App",
    "keyPrefix": "ugtp2_0123",
    "value": "ugtp2_0123456789abcdef0123456789abcdef"
  },
  "warnings": []
}

Output — every status this endpoint answers with

Input — query and path parameters

projectId string required

Project id

Output — every status this endpoint answers with

Output — example response (200)

{
  "projects": [
    {
      "id": "ugtp_project_a1b2c3d4e5f6",
      "name": "My App",
      "isActive": true,
      "role": "owner",
      "createdAt": "2026-06-18T12:00:00.000Z",
      "membersCount": 3,
      "apiKeysCount": 2,
      "lifiFeePercent": 0.2,
      "lifiIntegrator": "extrasafe",
      "eercFees": {
        "depositFeePercent": 0.25,
        "withdrawFeePercent": 0.25,
        "transferFlatUsd": 0.1,
        "depositIsDefault": true,
        "withdrawIsDefault": true,
        "transferIsDefault": true
      }
    }
  ]
}

Output — every status this endpoint answers with

Input — query and path parameters

projectId string required

Project id

Input — request body

lifiFeePercent number

Fee percent, 0–2, at most 2 decimal places

eercDepositFeePercent number

eERC deposit fee percent, 0–2, at most 2 decimal places; null resets to the platform default

eercWithdrawFeePercent number

eERC withdraw fee percent, 0–2, at most 2 decimal places; null resets to the platform default

eercTransferFlatUsd number

eERC flat transfer fee in dollars, 0–5, cent steps; null resets to the platform default

Input — example request

{
  "lifiFeePercent": 0.25,
  "eercDepositFeePercent": 0.4,
  "eercWithdrawFeePercent": null
}

Output — example response (200)

{
  "projectId": "ugtp_project_a1b2c3d4e5f6",
  "lifiFeePercent": 0.25,
  "eercFees": {
    "depositFeePercent": 0.4,
    "withdrawFeePercent": 0.25,
    "transferFlatUsd": 0.1,
    "depositIsDefault": false,
    "withdrawIsDefault": true,
    "transferIsDefault": true
  }
}

Output — every status this endpoint answers with

Input — query and path parameters

search string

Case-insensitive project-name filter

limit number

Max results (default 50, max 50)

Output — example response (200)

{
  "projects": [
    {
      "id": "ugtp_project_a1b2c3d4e5f6",
      "name": "Acme",
      "isActive": true,
      "transactionCount": 4210,
      "createdAt": "2026-06-18T12:00:00.000Z"
    }
  ]
}

Output — every status this endpoint answers with

Input — query and path parameters

projectId string required

Project id

Output — example response (200)

{
  "members": [
    {
      "id": "ugtp_project_member_a1b2c3d4e5f6",
      "userId": "ugtp_user_a1b2c3d4e5f6",
      "email": "user@example.com",
      "name": "Jane Dev",
      "role": "owner",
      "createdAt": "2026-06-18T12:00:00.000Z"
    }
  ]
}

Output — every status this endpoint answers with

Input — query and path parameters

projectId string required

Project id

Input — request body

email string required

User or invitee email

role string

admin | member | viewer (default member)

Input — example request

{
  "email": "teammate@example.com",
  "role": "viewer"
}

Output — example response (202)

{
  "added": {
    "status": "added",
    "member": {
      "userId": "ugtp_user_a1b2c3d4e5f6",
      "email": "teammate@example.com",
      "name": "Teammate",
      "role": "viewer"
    }
  },
  "invited": {
    "status": "invited",
    "email": "newperson@example.com"
  }
}

Output — every status this endpoint answers with

Input — query and path parameters

projectId string required

Project id

Output — example response (200)

{
  "invitations": [
    {
      "id": "ugtp_project_invitation_a1b2c3d4e5f6",
      "email": "teammate@example.com",
      "role": "viewer",
      "status": "pending",
      "expiresAt": "2026-07-20T12:00:00.000Z",
      "createdAt": "2026-07-13T12:00:00.000Z"
    }
  ]
}

Output — every status this endpoint answers with

Input — query and path parameters

projectId string required

Project id

invitationId string required

Invitation id

Output — every status this endpoint answers with

Input — query and path parameters

projectId string required

Project id

invitationId string required

Invitation id

Output — every status this endpoint answers with

Input — query and path parameters

projectId string required

Project id

memberId string required

Project member id

Input — request body

role "owner" | "admin" | "member" | "viewer" required

The role to assign

Input — example request

{
  "role": "admin"
}

Output — every status this endpoint answers with

Input — query and path parameters

projectId string required

Project id

memberId string required

Project member id

Output — every status this endpoint answers with

Input — query and path parameters

token string required

Invitation token from the emailed link

Output — example response (200)

{
  "projectName": "Acme",
  "email": "teammate@example.com",
  "role": "viewer",
  "expiresAt": "2026-07-20T12:00:00.000Z"
}

Output — every status this endpoint answers with

Input — request body

token string required

Invitation token from the emailed link

password string required

Password, minimum 8 characters

name string required

Display name for a new account

Input — example request

{
  "token": "a1b2c3d4e5f6...",
  "password": "********",
  "name": "Jane Dev"
}

Output — example response (201)

{
  "newUser": {
    "requiresLogin": false,
    "sessionToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
    "projectId": "ugtp_project_a1b2c3d4e5f6",
    "email": "teammate@example.com"
  },
  "existingUser": {
    "requiresLogin": true,
    "sessionToken": null,
    "projectId": "ugtp_project_a1b2c3d4e5f6",
    "email": "teammate@example.com"
  }
}

Output — every status this endpoint answers with