# Projects

## Create Project

**post** `/v1/projects`

Create a new project

### Body Parameters

- `name: string`

  Project name.

- `tags: optional array of string`

  Tags to attach to the Project.

### Returns

- `Project object { id, created_at, name, 3 more }`

  Project response.

  - `id: string`

    Project ID.

  - `created_at: string`

    When the Project was created.

  - `name: string`

    Project name.

  - `resources: ProjectResources`

    Resource counts for the project.

    - `blockchain: ProjectBlockchainResources`

      Blockchain resources.

      - `rpc_nodes_dedicated: number`

        Number of dedicated RPC nodes in the project.

      - `rpc_nodes_flex: number`

        Number of flex RPC nodes in the project.

    - `cloud: ProjectCloudResources`

      Cloud infrastructure resources.

      - `connect_connections: number`

        Number of Connect connections in the project.

      - `nks_clusters: number`

        Number of NKS clusters in the project.

      - `nks_node_pools: number`

        Number of NKS node pools in the project.

      - `vms: number`

        Number of VMs in the project.

      - `volumes: number`

        Number of volumes in the project.

      - `vpcs: number`

        Number of VPCs in the project.

  - `tags: array of string`

    Tags attached to the Project.

  - `updated_at: string`

    When the Project was updated.

### Example

```http
curl https://api.nirvanalabs.io/v1/projects \
    -H 'Content-Type: application/json' \
    -H "Authorization: Bearer $NIRVANA_LABS_API_KEY" \
    -d '{
          "name": "My Project",
          "tags": [
            "production",
            "ethereum"
          ]
        }'
```

#### Response

```json
{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "created_at": "2025-01-01T00:00:00Z",
  "name": "My Project",
  "resources": {
    "blockchain": {
      "rpc_nodes_dedicated": 1,
      "rpc_nodes_flex": 3
    },
    "cloud": {
      "connect_connections": 1,
      "nks_clusters": 2,
      "nks_node_pools": 4,
      "vms": 5,
      "volumes": 10,
      "vpcs": 2
    }
  },
  "tags": [
    "production",
    "ethereum"
  ],
  "updated_at": "2025-01-01T00:00:00Z"
}
```

## Get Project Details

**get** `/v1/projects/{project_id}`

Get details about a project

### Path Parameters

- `project_id: string`

### Returns

- `Project object { id, created_at, name, 3 more }`

  Project response.

  - `id: string`

    Project ID.

  - `created_at: string`

    When the Project was created.

  - `name: string`

    Project name.

  - `resources: ProjectResources`

    Resource counts for the project.

    - `blockchain: ProjectBlockchainResources`

      Blockchain resources.

      - `rpc_nodes_dedicated: number`

        Number of dedicated RPC nodes in the project.

      - `rpc_nodes_flex: number`

        Number of flex RPC nodes in the project.

    - `cloud: ProjectCloudResources`

      Cloud infrastructure resources.

      - `connect_connections: number`

        Number of Connect connections in the project.

      - `nks_clusters: number`

        Number of NKS clusters in the project.

      - `nks_node_pools: number`

        Number of NKS node pools in the project.

      - `vms: number`

        Number of VMs in the project.

      - `volumes: number`

        Number of volumes in the project.

      - `vpcs: number`

        Number of VPCs in the project.

  - `tags: array of string`

    Tags attached to the Project.

  - `updated_at: string`

    When the Project was updated.

### Example

```http
curl https://api.nirvanalabs.io/v1/projects/$PROJECT_ID \
    -H "Authorization: Bearer $NIRVANA_LABS_API_KEY"
```

#### Response

```json
{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "created_at": "2025-01-01T00:00:00Z",
  "name": "My Project",
  "resources": {
    "blockchain": {
      "rpc_nodes_dedicated": 1,
      "rpc_nodes_flex": 3
    },
    "cloud": {
      "connect_connections": 1,
      "nks_clusters": 2,
      "nks_node_pools": 4,
      "vms": 5,
      "volumes": 10,
      "vpcs": 2
    }
  },
  "tags": [
    "production",
    "ethereum"
  ],
  "updated_at": "2025-01-01T00:00:00Z"
}
```

## Update Project

**patch** `/v1/projects/{project_id}`

Update an existing project

### Path Parameters

- `project_id: string`

### Body Parameters

- `name: optional string`

  Project name.

- `tags: optional array of string`

  Tags to attach to the Project.

### Returns

- `Project object { id, created_at, name, 3 more }`

  Project response.

  - `id: string`

    Project ID.

  - `created_at: string`

    When the Project was created.

  - `name: string`

    Project name.

  - `resources: ProjectResources`

    Resource counts for the project.

    - `blockchain: ProjectBlockchainResources`

      Blockchain resources.

      - `rpc_nodes_dedicated: number`

        Number of dedicated RPC nodes in the project.

      - `rpc_nodes_flex: number`

        Number of flex RPC nodes in the project.

    - `cloud: ProjectCloudResources`

      Cloud infrastructure resources.

      - `connect_connections: number`

        Number of Connect connections in the project.

      - `nks_clusters: number`

        Number of NKS clusters in the project.

      - `nks_node_pools: number`

        Number of NKS node pools in the project.

      - `vms: number`

        Number of VMs in the project.

      - `volumes: number`

        Number of volumes in the project.

      - `vpcs: number`

        Number of VPCs in the project.

  - `tags: array of string`

    Tags attached to the Project.

  - `updated_at: string`

    When the Project was updated.

### Example

```http
curl https://api.nirvanalabs.io/v1/projects/$PROJECT_ID \
    -X PATCH \
    -H 'Content-Type: application/json' \
    -H "Authorization: Bearer $NIRVANA_LABS_API_KEY" \
    -d '{
          "name": "My Updated Project",
          "tags": [
            "production",
            "ethereum"
          ]
        }'
```

#### Response

```json
{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "created_at": "2025-01-01T00:00:00Z",
  "name": "My Project",
  "resources": {
    "blockchain": {
      "rpc_nodes_dedicated": 1,
      "rpc_nodes_flex": 3
    },
    "cloud": {
      "connect_connections": 1,
      "nks_clusters": 2,
      "nks_node_pools": 4,
      "vms": 5,
      "volumes": 10,
      "vpcs": 2
    }
  },
  "tags": [
    "production",
    "ethereum"
  ],
  "updated_at": "2025-01-01T00:00:00Z"
}
```

## Delete Project

**delete** `/v1/projects/{project_id}`

Delete a project

### Path Parameters

- `project_id: string`

### Example

```http
curl https://api.nirvanalabs.io/v1/projects/$PROJECT_ID \
    -X DELETE \
    -H "Authorization: Bearer $NIRVANA_LABS_API_KEY"
```

## List Projects

**get** `/v1/projects`

List all projects

### Query Parameters

- `cursor: optional string`

  Pagination cursor returned by a previous request

- `limit: optional number`

  Maximum number of items to return

### Returns

- `ProjectList object { items, pagination }`

  - `items: array of Project`

    - `id: string`

      Project ID.

    - `created_at: string`

      When the Project was created.

    - `name: string`

      Project name.

    - `resources: ProjectResources`

      Resource counts for the project.

      - `blockchain: ProjectBlockchainResources`

        Blockchain resources.

        - `rpc_nodes_dedicated: number`

          Number of dedicated RPC nodes in the project.

        - `rpc_nodes_flex: number`

          Number of flex RPC nodes in the project.

      - `cloud: ProjectCloudResources`

        Cloud infrastructure resources.

        - `connect_connections: number`

          Number of Connect connections in the project.

        - `nks_clusters: number`

          Number of NKS clusters in the project.

        - `nks_node_pools: number`

          Number of NKS node pools in the project.

        - `vms: number`

          Number of VMs in the project.

        - `volumes: number`

          Number of volumes in the project.

        - `vpcs: number`

          Number of VPCs in the project.

    - `tags: array of string`

      Tags attached to the Project.

    - `updated_at: string`

      When the Project was updated.

  - `pagination: Pagination`

    Pagination response details.

    - `next_cursor: string`

    - `previous_cursor: string`

    - `total_count: number`

### Example

```http
curl https://api.nirvanalabs.io/v1/projects \
    -H "Authorization: Bearer $NIRVANA_LABS_API_KEY"
```

#### Response

```json
{
  "items": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "created_at": "2025-01-01T00:00:00Z",
      "name": "My Project",
      "resources": {
        "blockchain": {
          "rpc_nodes_dedicated": 1,
          "rpc_nodes_flex": 3
        },
        "cloud": {
          "connect_connections": 1,
          "nks_clusters": 2,
          "nks_node_pools": 4,
          "vms": 5,
          "volumes": 10,
          "vpcs": 2
        }
      },
      "tags": [
        "production",
        "ethereum"
      ],
      "updated_at": "2025-01-01T00:00:00Z"
    }
  ],
  "pagination": {
    "next_cursor": "RhwniMT4B74siYZcPF8TnCdGI1l9rpPvg",
    "previous_cursor": "ARhwnmi1hA7wEbHbMjdYQlOB_ZusP4fYvw",
    "total_count": 125
  }
}
```

## Domain Types

### Project

- `Project object { id, created_at, name, 3 more }`

  Project response.

  - `id: string`

    Project ID.

  - `created_at: string`

    When the Project was created.

  - `name: string`

    Project name.

  - `resources: ProjectResources`

    Resource counts for the project.

    - `blockchain: ProjectBlockchainResources`

      Blockchain resources.

      - `rpc_nodes_dedicated: number`

        Number of dedicated RPC nodes in the project.

      - `rpc_nodes_flex: number`

        Number of flex RPC nodes in the project.

    - `cloud: ProjectCloudResources`

      Cloud infrastructure resources.

      - `connect_connections: number`

        Number of Connect connections in the project.

      - `nks_clusters: number`

        Number of NKS clusters in the project.

      - `nks_node_pools: number`

        Number of NKS node pools in the project.

      - `vms: number`

        Number of VMs in the project.

      - `volumes: number`

        Number of volumes in the project.

      - `vpcs: number`

        Number of VPCs in the project.

  - `tags: array of string`

    Tags attached to the Project.

  - `updated_at: string`

    When the Project was updated.

### Project Blockchain Resources

- `ProjectBlockchainResources object { rpc_nodes_dedicated, rpc_nodes_flex }`

  Blockchain resources.

  - `rpc_nodes_dedicated: number`

    Number of dedicated RPC nodes in the project.

  - `rpc_nodes_flex: number`

    Number of flex RPC nodes in the project.

### Project Cloud Resources

- `ProjectCloudResources object { connect_connections, nks_clusters, nks_node_pools, 3 more }`

  Cloud infrastructure resources.

  - `connect_connections: number`

    Number of Connect connections in the project.

  - `nks_clusters: number`

    Number of NKS clusters in the project.

  - `nks_node_pools: number`

    Number of NKS node pools in the project.

  - `vms: number`

    Number of VMs in the project.

  - `volumes: number`

    Number of volumes in the project.

  - `vpcs: number`

    Number of VPCs in the project.

### Project List

- `ProjectList object { items, pagination }`

  - `items: array of Project`

    - `id: string`

      Project ID.

    - `created_at: string`

      When the Project was created.

    - `name: string`

      Project name.

    - `resources: ProjectResources`

      Resource counts for the project.

      - `blockchain: ProjectBlockchainResources`

        Blockchain resources.

        - `rpc_nodes_dedicated: number`

          Number of dedicated RPC nodes in the project.

        - `rpc_nodes_flex: number`

          Number of flex RPC nodes in the project.

      - `cloud: ProjectCloudResources`

        Cloud infrastructure resources.

        - `connect_connections: number`

          Number of Connect connections in the project.

        - `nks_clusters: number`

          Number of NKS clusters in the project.

        - `nks_node_pools: number`

          Number of NKS node pools in the project.

        - `vms: number`

          Number of VMs in the project.

        - `volumes: number`

          Number of volumes in the project.

        - `vpcs: number`

          Number of VPCs in the project.

    - `tags: array of string`

      Tags attached to the Project.

    - `updated_at: string`

      When the Project was updated.

  - `pagination: Pagination`

    Pagination response details.

    - `next_cursor: string`

    - `previous_cursor: string`

    - `total_count: number`

### Project Resources

- `ProjectResources object { blockchain, cloud }`

  Resource counts for the project.

  - `blockchain: ProjectBlockchainResources`

    Blockchain resources.

    - `rpc_nodes_dedicated: number`

      Number of dedicated RPC nodes in the project.

    - `rpc_nodes_flex: number`

      Number of flex RPC nodes in the project.

  - `cloud: ProjectCloudResources`

    Cloud infrastructure resources.

    - `connect_connections: number`

      Number of Connect connections in the project.

    - `nks_clusters: number`

      Number of NKS clusters in the project.

    - `nks_node_pools: number`

      Number of NKS node pools in the project.

    - `vms: number`

      Number of VMs in the project.

    - `volumes: number`

      Number of volumes in the project.

    - `vpcs: number`

      Number of VPCs in the project.