# Public Cloud › Analytics › Lakehouse API

> Part of the OVHcloud developer hub. Index of every page and section: https://developers.eu.ovhcloud.com/llms.txt
> The Public Cloud product's sections: https://developers.eu.ovhcloud.com/reference/public-cloud/llms.txt
> Everything in one file: https://developers.eu.ovhcloud.com/llms-full.txt

> 8 operations of the OVHcloud API. Calls carry `authorization: Bearer $OVH_TOKEN`; the EU host is shown, Canada and the United States answer on api.ca.ovhcloud.com and api.us.ovhcloud.com.

Page: https://developers.eu.ovhcloud.com/reference/public-cloud/analytics/lakehouse/

OpenAPI v1: https://api.eu.ovhcloud.com/v1/__schemas/developer-hub-navigation/public-cloud/analytics/lakehouse.json?format=openapi3
OpenAPI v2: https://api.eu.ovhcloud.com/v2/__schemas/developer-hub-navigation/public-cloud/analytics/lakehouse.json?format=openapi3

## Operations

- `GET /publicCloud/project/{projectId}/managedAnalytics/lakehouse` — List the lakehouses of your project
- `GET /publicCloud/project/{projectId}/managedAnalytics/lakehouse/{lakehouseId}` — Get a lakehouse of your project
- `POST /publicCloud/project/{projectId}/managedAnalytics/lakehouse` — Create a lakehouse in your project
- `DELETE /publicCloud/project/{projectId}/managedAnalytics/lakehouse/{lakehouseId}` — Delete a lakehouse of your project
- `PUT /publicCloud/project/{projectId}/managedAnalytics/lakehouse/{lakehouseId}` — Update a lakehouse of your project
- `GET /publicCloud/project/{projectId}/managedAnalytics/lakehouse/{lakehouseId}/event` — List the events of your lakehouse
- `GET /publicCloud/project/{projectId}/managedAnalytics/lakehouse/{lakehouseId}/task` — List the tasks of your lakehouse
- `GET /publicCloud/project/{projectId}/managedAnalytics/lakehouse/{lakehouseId}/task/{taskId}` — Get a task of your lakehouse

## List the lakehouses of your project

`GET /v2/publicCloud/project/{projectId}/managedAnalytics/lakehouse`

Link: https://developers.eu.ovhcloud.com/reference/public-cloud/analytics/lakehouse/#getAllLakehouseServices

**Status:** Alpha version  
**IAM actions:** `publicCloudProject:apiovh:analytics/lakehouse/get`

The list has no region filter: to keep the lakehouses of one region, select them on `targetSpec.region`.

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `X-Pagination-Cursor` | header | string |  | Pagination cursor |
| `X-Pagination-Size` | header | integer |  | Pagination size |
| `projectId` | path | string | yes | Project ID |

### Responses

| Status | Type | Description |
| --- | --- | --- |
| 200 | publicCloud.lakehouse.Lakehouse[] | successful operation |
| 400 | object | Error 400 response |

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `checksum` | string | read-only | Hash of the target specification of the lakehouse. Send it back on update to make sure nobody changed the lakehouse in between. |
| `createdAt` | string (date-time) | read-only | Date the lakehouse was created |
| `currentState` | publicCloud.lakehouse.LakehouseCurrentState | read-only | Current state of the lakehouse, computed by the service |
| `currentState.description` | string | read-only | Description of the lakehouse. Null when it has none. |
| `currentState.endpoints` | publicCloud.lakehouse.Endpoint[] | read-only | Endpoints to reach the data of the lakehouse. Empty until the lakehouse is first READY. |
| `currentState.endpoints[].component` | publicCloud.lakehouse.EndpointComponentEnum | read-only | What the endpoint serves: the data console, the Apache Iceberg REST catalog, the OAuth2 token service, S3 storage or SQL — one of `DATA_CONSOLE`, `ICEBERG_REST`, `OAUTH2_TOKEN`, `S3`, `SQL` |
| `currentState.endpoints[].uri` | string | read-only | Address of the endpoint |
| `currentState.name` | string | read-only | Name of the lakehouse |
| `currentState.networkAccess` | publicCloud.lakehouse.NetworkAccess | read-only | Whether the source-address allowlist of the lakehouse is enforced in its region |
| `currentState.networkAccess.checkedAt` | string (date-time) | read-only | Date the region last checked the allowlist. Null when it has not reported it yet. |
| `currentState.networkAccess.message` | string | read-only | Why the allowlist is FAILED or UNSUPPORTED, for people. Null otherwise. It may change. Do not parse it. |
| `currentState.networkAccess.state` | publicCloud.lakehouse.NetworkAccessStateEnum | read-only | `DISABLED`: no filtering, every address may reach the lakehouse (filtering is off or the list is empty). `PENDING`: a change of the allowlist is being applied. `ENFORCED`: only the listed addresses may reach the lakehouse. `FAILED`: the allowlist could not be applied. `UNSUPPORTED`: the region no longer enforces allowlists. Disable or empty the list. — one of `DISABLED`, `ENFORCED`, `FAILED`, `PENDING`, `UNSUPPORTED` |
| `currentState.realm` | string | read-only | Realm of the lakehouse in the Apache Iceberg REST catalog of the region. Send it in the `Polaris-Realm` header of your Iceberg client. Null until the lakehouse is first READY. |
| `currentState.region` | publicCloud.lakehouse.RegionEnum | read-only | Region of the lakehouse: one of the region names listed by the lakehouse region reference — one of `eu-west-par`, `eu-west-poc` |
| `currentState.statusReason` | publicCloud.lakehouse.StatusReason | read-only | Why the lakehouse is in ERROR. Null in any other status. |
| `currentState.statusReason.code` | publicCloud.lakehouse.StatusReasonCodeEnum | read-only | Stable code of the reason, for programs — one of `CANCELED`, `CATALOG_NOT_EMPTY`, `DEDICATED_COMPUTE_POOL_EXISTS`, `DEDICATED_UNAVAILABLE`, `INVALID_SHAPE`, `LAKEHOUSE_NOT_EMPTY`, `OPERATION_FAILED`, `QUOTA_EXCEEDED`, `RECONCILE_FAILED`, `REGION_UNAVAILABLE`, `SCHEMA_NOT_EMPTY`, `TIMED_OUT` |
| `currentState.statusReason.message` | string | read-only | Explanation of the reason, for people. It may change. Do not parse it. |
| `currentTasks` | common.CurrentTask[] | read-only | Tasks in progress on the lakehouse, and its last failed task while the lakehouse is in ERROR. Always an array. Empty when there is none. |
| `currentTasks[].errors` | common.TaskError[] | read-only | Errors that occurred on the task |
| `currentTasks[].errors[].message` | string | read-only | Error description |
| `currentTasks[].id` | string (uuid) | read-only | Identifier of the current task |
| `currentTasks[].link` | string | read-only | Link to the task details |
| `currentTasks[].status` | common.CurrentTaskStatusEnum | read-only | Current global status of the current task — one of `ERROR`, `PENDING`, `RUNNING`, `SCHEDULED`, `WAITING_USER_INPUT` |
| `currentTasks[].type` | string | read-only | Type of the current task |
| `id` | string (uuid) | read-only | Unique identifier of the lakehouse |
| `resourceStatus` | common.ResourceStatusEnum | read-only | Readiness status of the lakehouse. A change is accepted only in READY or ERROR, except after a refused deletion (ERROR with a `*_NOT_EMPTY` status reason code), where only a new deletion is accepted. A deletion is also accepted in CREATING and UPDATING and replaces the change in progress. — one of `CREATING`, `CREATION_PLANNED`, `DELETING`, `ERROR`, `OUT_OF_SYNC`, `READY`, `SUSPENDED`, `UNKNOWN`, `UPDATING` |
| `targetSpec` | publicCloud.lakehouse.LakehouseTargetSpec | read-only | Last requested specification of the lakehouse |
| `targetSpec.description` | string | read-only | Description of the lakehouse. At most 255 characters. |
| `targetSpec.ipRestrictions` | publicCloud.lakehouse.IpRestriction[] | read-only | Source addresses allowed to reach the lakehouse, kept even while filtering is disabled. Empty when there is none. |
| `targetSpec.ipRestrictions[].description` | string |  | Description of the entry. At most 255 characters. |
| `targetSpec.ipRestrictions[].ip` | ipBlock | yes | A public IPv4 or IPv6 block in CIDR notation, or a single address (stored as a /32 or a /128). It is stored masked, for example 203.0.114.17/24 as 203.0.114.0/24. Private, loopback, link-local, multicast, documentation and other special-purpose ranges, and 0.0.0.0/0 and ::/0, are refused. |
| `targetSpec.ipRestrictionsEnabled` | boolean | read-only | Whether only the addresses of `ipRestrictions` may reach the lakehouse. When false, every address may. |
| `targetSpec.name` | string | read-only | Name of the lakehouse, unique in the project |
| `targetSpec.region` | publicCloud.lakehouse.RegionEnum | read-only | Region of the lakehouse: one of the region names listed by the lakehouse region reference. Immutable after creation. Not part of an update. — one of `eu-west-par`, `eu-west-poc` |
| `updatedAt` | string (date-time) | read-only | Date of the last change to the lakehouse |

```json
[
  {
    "checksum": "string",
    "createdAt": "2024-01-01T12:00:00Z",
    "currentState": {
      "description": "string",
      "endpoints": [
        {
          "component": "DATA_CONSOLE",
          "uri": "string"
        }
      ],
      "name": "string",
      "networkAccess": {
        "checkedAt": "2024-01-01T12:00:00Z",
        "message": "string",
        "state": "DISABLED"
      },
      "realm": "string",
      "region": "eu-west-par",
      "statusReason": {
        "code": "CANCELED",
        "message": "string"
      }
    },
    "currentTasks": [
      {
        "errors": [
          {
            "message": "string"
          }
        ],
        "id": "00000000-0000-0000-0000-000000000000",
        "link": "string",
        "status": "ERROR",
        "type": "string"
      }
    ],
    "id": "00000000-0000-0000-0000-000000000000",
    "resourceStatus": "CREATING",
    "targetSpec": {
      "description": "string",
      "ipRestrictions": [
        {
          "description": "string",
          "ip": "192.0.2.0/24"
        }
      ],
      "ipRestrictionsEnabled": true,
      "name": "string",
      "region": "eu-west-par"
    },
    "updatedAt": "2024-01-01T12:00:00Z"
  }
]
```

### Example

```bash
curl -X GET \
  "https://api.eu.ovhcloud.com/v2/publicCloud/project/{projectId}/managedAnalytics/lakehouse" \
  -H "accept: application/json" \
  -H "X-Schemas-Version: 2026-06" \
  -H "authorization: Bearer $OVH_TOKEN"
```

```python
'''
First, install the latest release of Python wrapper: $ pip install ovh
'''
import json
import ovh

# Instantiate an OVH Client.
# You can generate new credentials with full access to your account on
# the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)
client = ovh.Client(
	endpoint='ovh-eu',               # Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)
	application_key='xxxxxxxxxx',    # Application Key
	application_secret='xxxxxxxxxx', # Application Secret
	consumer_key='xxxxxxxxxx',       # Consumer Key
)

result = client.get("/v2/publicCloud/project/{projectId}/managedAnalytics/lakehouse")

# Pretty print
print(json.dumps(result, indent=4))
```

```php
<?php
/**
 * First, download the latest release of PHP wrapper on github
 * And include this script into the folder with extracted files
 */
require __DIR__ . '/vendor/autoload.php';
use \Ovh\Api;

/**
 * Instantiate an OVH Client.
 * You can generate new credentials with full access to your account on
 * the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)
 */
$ovh = new Api('xxxxxxxxxx',  // Application Key
               'xxxxxxxxxx',  // Application Secret
               'ovh-eu',      // Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)
               'xxxxxxxxxx'); // Consumer Key

$result = $ovh->get("/v2/publicCloud/project/{projectId}/managedAnalytics/lakehouse");

print_r($result);
?>
```

## Get a lakehouse of your project

`GET /v2/publicCloud/project/{projectId}/managedAnalytics/lakehouse/{lakehouseId}`

Link: https://developers.eu.ovhcloud.com/reference/public-cloud/analytics/lakehouse/#getLakehouseService

**Status:** Alpha version  
**IAM actions:** `publicCloudProject:apiovh:analytics/lakehouse/get`

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `lakehouseId` | path | string (uuid) | yes | Lakehouse ID |
| `projectId` | path | string | yes | Project ID |

### Responses

| Status | Type | Description |
| --- | --- | --- |
| 200 | publicCloud.lakehouse.Lakehouse | successful operation |
| 400 | object | Error 400 response |
| 404 | object | Error 404 response |

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `checksum` | string | read-only | Hash of the target specification of the lakehouse. Send it back on update to make sure nobody changed the lakehouse in between. |
| `createdAt` | string (date-time) | read-only | Date the lakehouse was created |
| `currentState` | publicCloud.lakehouse.LakehouseCurrentState | read-only | Current state of the lakehouse, computed by the service |
| `currentState.description` | string | read-only | Description of the lakehouse. Null when it has none. |
| `currentState.endpoints` | publicCloud.lakehouse.Endpoint[] | read-only | Endpoints to reach the data of the lakehouse. Empty until the lakehouse is first READY. |
| `currentState.endpoints[].component` | publicCloud.lakehouse.EndpointComponentEnum | read-only | What the endpoint serves: the data console, the Apache Iceberg REST catalog, the OAuth2 token service, S3 storage or SQL — one of `DATA_CONSOLE`, `ICEBERG_REST`, `OAUTH2_TOKEN`, `S3`, `SQL` |
| `currentState.endpoints[].uri` | string | read-only | Address of the endpoint |
| `currentState.name` | string | read-only | Name of the lakehouse |
| `currentState.networkAccess` | publicCloud.lakehouse.NetworkAccess | read-only | Whether the source-address allowlist of the lakehouse is enforced in its region |
| `currentState.networkAccess.checkedAt` | string (date-time) | read-only | Date the region last checked the allowlist. Null when it has not reported it yet. |
| `currentState.networkAccess.message` | string | read-only | Why the allowlist is FAILED or UNSUPPORTED, for people. Null otherwise. It may change. Do not parse it. |
| `currentState.networkAccess.state` | publicCloud.lakehouse.NetworkAccessStateEnum | read-only | `DISABLED`: no filtering, every address may reach the lakehouse (filtering is off or the list is empty). `PENDING`: a change of the allowlist is being applied. `ENFORCED`: only the listed addresses may reach the lakehouse. `FAILED`: the allowlist could not be applied. `UNSUPPORTED`: the region no longer enforces allowlists. Disable or empty the list. — one of `DISABLED`, `ENFORCED`, `FAILED`, `PENDING`, `UNSUPPORTED` |
| `currentState.realm` | string | read-only | Realm of the lakehouse in the Apache Iceberg REST catalog of the region. Send it in the `Polaris-Realm` header of your Iceberg client. Null until the lakehouse is first READY. |
| `currentState.region` | publicCloud.lakehouse.RegionEnum | read-only | Region of the lakehouse: one of the region names listed by the lakehouse region reference — one of `eu-west-par`, `eu-west-poc` |
| `currentState.statusReason` | publicCloud.lakehouse.StatusReason | read-only | Why the lakehouse is in ERROR. Null in any other status. |
| `currentState.statusReason.code` | publicCloud.lakehouse.StatusReasonCodeEnum | read-only | Stable code of the reason, for programs — one of `CANCELED`, `CATALOG_NOT_EMPTY`, `DEDICATED_COMPUTE_POOL_EXISTS`, `DEDICATED_UNAVAILABLE`, `INVALID_SHAPE`, `LAKEHOUSE_NOT_EMPTY`, `OPERATION_FAILED`, `QUOTA_EXCEEDED`, `RECONCILE_FAILED`, `REGION_UNAVAILABLE`, `SCHEMA_NOT_EMPTY`, `TIMED_OUT` |
| `currentState.statusReason.message` | string | read-only | Explanation of the reason, for people. It may change. Do not parse it. |
| `currentTasks` | common.CurrentTask[] | read-only | Tasks in progress on the lakehouse, and its last failed task while the lakehouse is in ERROR. Always an array. Empty when there is none. |
| `currentTasks[].errors` | common.TaskError[] | read-only | Errors that occurred on the task |
| `currentTasks[].errors[].message` | string | read-only | Error description |
| `currentTasks[].id` | string (uuid) | read-only | Identifier of the current task |
| `currentTasks[].link` | string | read-only | Link to the task details |
| `currentTasks[].status` | common.CurrentTaskStatusEnum | read-only | Current global status of the current task — one of `ERROR`, `PENDING`, `RUNNING`, `SCHEDULED`, `WAITING_USER_INPUT` |
| `currentTasks[].type` | string | read-only | Type of the current task |
| `id` | string (uuid) | read-only | Unique identifier of the lakehouse |
| `resourceStatus` | common.ResourceStatusEnum | read-only | Readiness status of the lakehouse. A change is accepted only in READY or ERROR, except after a refused deletion (ERROR with a `*_NOT_EMPTY` status reason code), where only a new deletion is accepted. A deletion is also accepted in CREATING and UPDATING and replaces the change in progress. — one of `CREATING`, `CREATION_PLANNED`, `DELETING`, `ERROR`, `OUT_OF_SYNC`, `READY`, `SUSPENDED`, `UNKNOWN`, `UPDATING` |
| `targetSpec` | publicCloud.lakehouse.LakehouseTargetSpec | read-only | Last requested specification of the lakehouse |
| `targetSpec.description` | string | read-only | Description of the lakehouse. At most 255 characters. |
| `targetSpec.ipRestrictions` | publicCloud.lakehouse.IpRestriction[] | read-only | Source addresses allowed to reach the lakehouse, kept even while filtering is disabled. Empty when there is none. |
| `targetSpec.ipRestrictions[].description` | string |  | Description of the entry. At most 255 characters. |
| `targetSpec.ipRestrictions[].ip` | ipBlock | yes | A public IPv4 or IPv6 block in CIDR notation, or a single address (stored as a /32 or a /128). It is stored masked, for example 203.0.114.17/24 as 203.0.114.0/24. Private, loopback, link-local, multicast, documentation and other special-purpose ranges, and 0.0.0.0/0 and ::/0, are refused. |
| `targetSpec.ipRestrictionsEnabled` | boolean | read-only | Whether only the addresses of `ipRestrictions` may reach the lakehouse. When false, every address may. |
| `targetSpec.name` | string | read-only | Name of the lakehouse, unique in the project |
| `targetSpec.region` | publicCloud.lakehouse.RegionEnum | read-only | Region of the lakehouse: one of the region names listed by the lakehouse region reference. Immutable after creation. Not part of an update. — one of `eu-west-par`, `eu-west-poc` |
| `updatedAt` | string (date-time) | read-only | Date of the last change to the lakehouse |

```json
{
  "checksum": "string",
  "createdAt": "2024-01-01T12:00:00Z",
  "currentState": {
    "description": "string",
    "endpoints": [
      {
        "component": "DATA_CONSOLE",
        "uri": "string"
      }
    ],
    "name": "string",
    "networkAccess": {
      "checkedAt": "2024-01-01T12:00:00Z",
      "message": "string",
      "state": "DISABLED"
    },
    "realm": "string",
    "region": "eu-west-par",
    "statusReason": {
      "code": "CANCELED",
      "message": "string"
    }
  },
  "currentTasks": [
    {
      "errors": [
        {
          "message": "string"
        }
      ],
      "id": "00000000-0000-0000-0000-000000000000",
      "link": "string",
      "status": "ERROR",
      "type": "string"
    }
  ],
  "id": "00000000-0000-0000-0000-000000000000",
  "resourceStatus": "CREATING",
  "targetSpec": {
    "description": "string",
    "ipRestrictions": [
      {
        "description": "string",
        "ip": "192.0.2.0/24"
      }
    ],
    "ipRestrictionsEnabled": true,
    "name": "string",
    "region": "eu-west-par"
  },
  "updatedAt": "2024-01-01T12:00:00Z"
}
```

### Example

```bash
curl -X GET \
  "https://api.eu.ovhcloud.com/v2/publicCloud/project/{projectId}/managedAnalytics/lakehouse/{lakehouseId}" \
  -H "accept: application/json" \
  -H "X-Schemas-Version: 2026-06" \
  -H "authorization: Bearer $OVH_TOKEN"
```

```python
'''
First, install the latest release of Python wrapper: $ pip install ovh
'''
import json
import ovh

# Instantiate an OVH Client.
# You can generate new credentials with full access to your account on
# the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)
client = ovh.Client(
	endpoint='ovh-eu',               # Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)
	application_key='xxxxxxxxxx',    # Application Key
	application_secret='xxxxxxxxxx', # Application Secret
	consumer_key='xxxxxxxxxx',       # Consumer Key
)

result = client.get("/v2/publicCloud/project/{projectId}/managedAnalytics/lakehouse/{lakehouseId}")

# Pretty print
print(json.dumps(result, indent=4))
```

```php
<?php
/**
 * First, download the latest release of PHP wrapper on github
 * And include this script into the folder with extracted files
 */
require __DIR__ . '/vendor/autoload.php';
use \Ovh\Api;

/**
 * Instantiate an OVH Client.
 * You can generate new credentials with full access to your account on
 * the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)
 */
$ovh = new Api('xxxxxxxxxx',  // Application Key
               'xxxxxxxxxx',  // Application Secret
               'ovh-eu',      // Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)
               'xxxxxxxxxx'); // Consumer Key

$result = $ovh->get("/v2/publicCloud/project/{projectId}/managedAnalytics/lakehouse/{lakehouseId}");

print_r($result);
?>
```

## Create a lakehouse in your project

`POST /v2/publicCloud/project/{projectId}/managedAnalytics/lakehouse`

Link: https://developers.eu.ovhcloud.com/reference/public-cloud/analytics/lakehouse/#createLakehouseService

**Status:** Alpha version  
**IAM actions:** `publicCloudProject:apiovh:analytics/lakehouse/create`

Creates the lakehouse asynchronously. The response is the lakehouse in CREATING, with the creation task in `currentTasks`: follow it on the task routes of the lakehouse, or read the lakehouse until its `resourceStatus` is READY or ERROR.

The lakehouse is created with its first catalog, described by `targetSpec.catalog`. That catalog is then a resource of its own: it is listed under the catalogs of the lakehouse, with its own status and its own creation task, and it is not echoed in the `targetSpec` of the lakehouse. The lakehouse can be READY while its first catalog is still CREATING.

The optional `ipRestrictions` restricts the source addresses allowed to reach the lakehouse (its Apache Iceberg REST catalog, SQL and S3 endpoints) once `ipRestrictionsEnabled` is true. Each entry is a public IPv4 or IPv6 block, or a single address, at most 32 entries with at least one IPv4 block. The list is stored normalized: masked, without duplicates, sorted. Enabling filtering needs a region whose `ipRestrictions` capability is true. Otherwise the creation is refused with a 409. The lakehouse turns READY once the region enforces the list, which `currentState.networkAccess` shows.

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `projectId` | path | string | yes | Project ID |

### Request body (required)

Type: `publicCloud.lakehouse.LakehouseCreation`

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `targetSpec` | publicCloud.lakehouse.LakehouseCreationTargetSpec | yes | Specification of the lakehouse to create |
| `targetSpec.catalog` | publicCloud.lakehouse.LakehouseCatalogCreation | yes | First catalog of the lakehouse, created with it. It then lives on as a catalog resource of its own, listed under the catalogs of the lakehouse, with its own status and tasks. |
| `targetSpec.catalog.description` | string |  | Description of the catalog. At most 255 characters. |
| `targetSpec.catalog.name` | string | yes | Name of the catalog, the name Apache Iceberg and SQL clients see. Same rules as the lakehouse name. Immutable after creation. |
| `targetSpec.description` | string |  | Description of the lakehouse. At most 255 characters. |
| `targetSpec.ipRestrictions` | publicCloud.lakehouse.IpRestriction[] |  | Source addresses allowed to reach the lakehouse. When omitted, none. At most 32 entries. |
| `targetSpec.ipRestrictions[].description` | string |  | Description of the entry. At most 255 characters. |
| `targetSpec.ipRestrictions[].ip` | ipBlock | yes | A public IPv4 or IPv6 block in CIDR notation, or a single address (stored as a /32 or a /128). It is stored masked, for example 203.0.114.17/24 as 203.0.114.0/24. Private, loopback, link-local, multicast, documentation and other special-purpose ranges, and 0.0.0.0/0 and ::/0, are refused. |
| `targetSpec.ipRestrictionsEnabled` | boolean |  | Whether only the addresses of `ipRestrictions` may reach the lakehouse. True needs at least one entry. Defaults to false. |
| `targetSpec.name` | string | yes | Name of the lakehouse, unique in the project: 3 to 63 lowercase letters, digits or underscores, starting with a letter |
| `targetSpec.region` | publicCloud.lakehouse.RegionEnum | yes | Region of the lakehouse: one of the region names listed by the lakehouse region reference. Immutable after creation. — one of `eu-west-par`, `eu-west-poc` |

```json
{
  "targetSpec": {
    "catalog": {
      "description": "string",
      "name": "string"
    },
    "description": "string",
    "ipRestrictions": [
      {
        "description": "string",
        "ip": "192.0.2.0/24"
      }
    ],
    "ipRestrictionsEnabled": true,
    "name": "string",
    "region": "eu-west-par"
  }
}
```

### Responses

| Status | Type | Description |
| --- | --- | --- |
| 200 | publicCloud.lakehouse.Lakehouse | successful operation |
| 400 | object | Error 400 response |
| 409 | object | Error 409 response |

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `checksum` | string | read-only | Hash of the target specification of the lakehouse. Send it back on update to make sure nobody changed the lakehouse in between. |
| `createdAt` | string (date-time) | read-only | Date the lakehouse was created |
| `currentState` | publicCloud.lakehouse.LakehouseCurrentState | read-only | Current state of the lakehouse, computed by the service |
| `currentState.description` | string | read-only | Description of the lakehouse. Null when it has none. |
| `currentState.endpoints` | publicCloud.lakehouse.Endpoint[] | read-only | Endpoints to reach the data of the lakehouse. Empty until the lakehouse is first READY. |
| `currentState.endpoints[].component` | publicCloud.lakehouse.EndpointComponentEnum | read-only | What the endpoint serves: the data console, the Apache Iceberg REST catalog, the OAuth2 token service, S3 storage or SQL — one of `DATA_CONSOLE`, `ICEBERG_REST`, `OAUTH2_TOKEN`, `S3`, `SQL` |
| `currentState.endpoints[].uri` | string | read-only | Address of the endpoint |
| `currentState.name` | string | read-only | Name of the lakehouse |
| `currentState.networkAccess` | publicCloud.lakehouse.NetworkAccess | read-only | Whether the source-address allowlist of the lakehouse is enforced in its region |
| `currentState.networkAccess.checkedAt` | string (date-time) | read-only | Date the region last checked the allowlist. Null when it has not reported it yet. |
| `currentState.networkAccess.message` | string | read-only | Why the allowlist is FAILED or UNSUPPORTED, for people. Null otherwise. It may change. Do not parse it. |
| `currentState.networkAccess.state` | publicCloud.lakehouse.NetworkAccessStateEnum | read-only | `DISABLED`: no filtering, every address may reach the lakehouse (filtering is off or the list is empty). `PENDING`: a change of the allowlist is being applied. `ENFORCED`: only the listed addresses may reach the lakehouse. `FAILED`: the allowlist could not be applied. `UNSUPPORTED`: the region no longer enforces allowlists. Disable or empty the list. — one of `DISABLED`, `ENFORCED`, `FAILED`, `PENDING`, `UNSUPPORTED` |
| `currentState.realm` | string | read-only | Realm of the lakehouse in the Apache Iceberg REST catalog of the region. Send it in the `Polaris-Realm` header of your Iceberg client. Null until the lakehouse is first READY. |
| `currentState.region` | publicCloud.lakehouse.RegionEnum | read-only | Region of the lakehouse: one of the region names listed by the lakehouse region reference — one of `eu-west-par`, `eu-west-poc` |
| `currentState.statusReason` | publicCloud.lakehouse.StatusReason | read-only | Why the lakehouse is in ERROR. Null in any other status. |
| `currentState.statusReason.code` | publicCloud.lakehouse.StatusReasonCodeEnum | read-only | Stable code of the reason, for programs — one of `CANCELED`, `CATALOG_NOT_EMPTY`, `DEDICATED_COMPUTE_POOL_EXISTS`, `DEDICATED_UNAVAILABLE`, `INVALID_SHAPE`, `LAKEHOUSE_NOT_EMPTY`, `OPERATION_FAILED`, `QUOTA_EXCEEDED`, `RECONCILE_FAILED`, `REGION_UNAVAILABLE`, `SCHEMA_NOT_EMPTY`, `TIMED_OUT` |
| `currentState.statusReason.message` | string | read-only | Explanation of the reason, for people. It may change. Do not parse it. |
| `currentTasks` | common.CurrentTask[] | read-only | Tasks in progress on the lakehouse, and its last failed task while the lakehouse is in ERROR. Always an array. Empty when there is none. |
| `currentTasks[].errors` | common.TaskError[] | read-only | Errors that occurred on the task |
| `currentTasks[].errors[].message` | string | read-only | Error description |
| `currentTasks[].id` | string (uuid) | read-only | Identifier of the current task |
| `currentTasks[].link` | string | read-only | Link to the task details |
| `currentTasks[].status` | common.CurrentTaskStatusEnum | read-only | Current global status of the current task — one of `ERROR`, `PENDING`, `RUNNING`, `SCHEDULED`, `WAITING_USER_INPUT` |
| `currentTasks[].type` | string | read-only | Type of the current task |
| `id` | string (uuid) | read-only | Unique identifier of the lakehouse |
| `resourceStatus` | common.ResourceStatusEnum | read-only | Readiness status of the lakehouse. A change is accepted only in READY or ERROR, except after a refused deletion (ERROR with a `*_NOT_EMPTY` status reason code), where only a new deletion is accepted. A deletion is also accepted in CREATING and UPDATING and replaces the change in progress. — one of `CREATING`, `CREATION_PLANNED`, `DELETING`, `ERROR`, `OUT_OF_SYNC`, `READY`, `SUSPENDED`, `UNKNOWN`, `UPDATING` |
| `targetSpec` | publicCloud.lakehouse.LakehouseTargetSpec | read-only | Last requested specification of the lakehouse |
| `targetSpec.description` | string | read-only | Description of the lakehouse. At most 255 characters. |
| `targetSpec.ipRestrictions` | publicCloud.lakehouse.IpRestriction[] | read-only | Source addresses allowed to reach the lakehouse, kept even while filtering is disabled. Empty when there is none. |
| `targetSpec.ipRestrictions[].description` | string |  | Description of the entry. At most 255 characters. |
| `targetSpec.ipRestrictions[].ip` | ipBlock | yes | A public IPv4 or IPv6 block in CIDR notation, or a single address (stored as a /32 or a /128). It is stored masked, for example 203.0.114.17/24 as 203.0.114.0/24. Private, loopback, link-local, multicast, documentation and other special-purpose ranges, and 0.0.0.0/0 and ::/0, are refused. |
| `targetSpec.ipRestrictionsEnabled` | boolean | read-only | Whether only the addresses of `ipRestrictions` may reach the lakehouse. When false, every address may. |
| `targetSpec.name` | string | read-only | Name of the lakehouse, unique in the project |
| `targetSpec.region` | publicCloud.lakehouse.RegionEnum | read-only | Region of the lakehouse: one of the region names listed by the lakehouse region reference. Immutable after creation. Not part of an update. — one of `eu-west-par`, `eu-west-poc` |
| `updatedAt` | string (date-time) | read-only | Date of the last change to the lakehouse |

```json
{
  "checksum": "string",
  "createdAt": "2024-01-01T12:00:00Z",
  "currentState": {
    "description": "string",
    "endpoints": [
      {
        "component": "DATA_CONSOLE",
        "uri": "string"
      }
    ],
    "name": "string",
    "networkAccess": {
      "checkedAt": "2024-01-01T12:00:00Z",
      "message": "string",
      "state": "DISABLED"
    },
    "realm": "string",
    "region": "eu-west-par",
    "statusReason": {
      "code": "CANCELED",
      "message": "string"
    }
  },
  "currentTasks": [
    {
      "errors": [
        {
          "message": "string"
        }
      ],
      "id": "00000000-0000-0000-0000-000000000000",
      "link": "string",
      "status": "ERROR",
      "type": "string"
    }
  ],
  "id": "00000000-0000-0000-0000-000000000000",
  "resourceStatus": "CREATING",
  "targetSpec": {
    "description": "string",
    "ipRestrictions": [
      {
        "description": "string",
        "ip": "192.0.2.0/24"
      }
    ],
    "ipRestrictionsEnabled": true,
    "name": "string",
    "region": "eu-west-par"
  },
  "updatedAt": "2024-01-01T12:00:00Z"
}
```

### Example

```bash
curl -X POST \
  "https://api.eu.ovhcloud.com/v2/publicCloud/project/{projectId}/managedAnalytics/lakehouse" \
  -H "accept: application/json" \
  -H "X-Schemas-Version: 2026-06" \
  -H "authorization: Bearer $OVH_TOKEN" \
  -H "content-type: application/json" \
  -d '{ }'
```

```python
'''
First, install the latest release of Python wrapper: $ pip install ovh
'''
import json
import ovh

# Instantiate an OVH Client.
# You can generate new credentials with full access to your account on
# the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)
client = ovh.Client(
	endpoint='ovh-eu',               # Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)
	application_key='xxxxxxxxxx',    # Application Key
	application_secret='xxxxxxxxxx', # Application Secret
	consumer_key='xxxxxxxxxx',       # Consumer Key
)

# Request body type: publicCloud.lakehouse.LakehouseCreation
result = client.post("/v2/publicCloud/project/{projectId}/managedAnalytics/lakehouse",
	targetSpec = None, # Specification of the lakehouse to create (type: publicCloud.lakehouse.LakehouseCreationTargetSpec)
)

# Pretty print
print(json.dumps(result, indent=4))
```

```php
<?php
/**
 * First, download the latest release of PHP wrapper on github
 * And include this script into the folder with extracted files
 */
require __DIR__ . '/vendor/autoload.php';
use \Ovh\Api;

/**
 * Instantiate an OVH Client.
 * You can generate new credentials with full access to your account on
 * the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)
 */
$ovh = new Api('xxxxxxxxxx',  // Application Key
               'xxxxxxxxxx',  // Application Secret
               'ovh-eu',      // Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)
               'xxxxxxxxxx'); // Consumer Key

// Request body type: publicCloud.lakehouse.LakehouseCreation
$result = $ovh->post("/v2/publicCloud/project/{projectId}/managedAnalytics/lakehouse", array(
	targetSpec => null, // Specification of the lakehouse to create (type: publicCloud.lakehouse.LakehouseCreationTargetSpec)
));

print_r($result);
?>
```

## Delete a lakehouse of your project

`DELETE /v2/publicCloud/project/{projectId}/managedAnalytics/lakehouse/{lakehouseId}`

Link: https://developers.eu.ovhcloud.com/reference/public-cloud/analytics/lakehouse/#deleteLakehouseService

**Status:** Alpha version  
**IAM actions:** `publicCloudProject:apiovh:analytics/lakehouse/delete`

Deletes the lakehouse asynchronously. The response is the lakehouse in DELETING, with the deletion task in `currentTasks`. Once the deletion completes, the lakehouse and every route under it, its tasks included, answer 404. Deleting a lakehouse also deletes its catalogs, schemas, users, groups, members, roles, role assignments, tags and Compute Pools.

A deletion is accepted in READY and ERROR, and also in CREATING and UPDATING, where it replaces the change in progress. A new deletion while one is running is refused with a 409, except a deletion with `force` set to true on a running deletion that keeps the data, which escalates it.

Without `force`, the deletion keeps the data and is refused while the lakehouse still holds data: while it holds schemas, the deletion is refused at once with a 409. When only the region knows about the data (tables and views created through Apache Iceberg or SQL), the refusal shows asynchronously as the lakehouse in ERROR, with the status reason code `LAKEHOUSE_NOT_EMPTY` and the failed task in `currentTasks`. From that state only a new deletion is accepted, typically with `force` set to true. With `force` set to true, the tables, views and data the lakehouse holds are deleted too.

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `force` | query | boolean |  | Also delete the tables, views and data it holds. Without it, the deletion is refused while data remains. |
| `lakehouseId` | path | string (uuid) | yes | Lakehouse ID |
| `projectId` | path | string | yes | Project ID |

### Responses

| Status | Type | Description |
| --- | --- | --- |
| 200 | publicCloud.lakehouse.Lakehouse | successful operation |
| 400 | object | Error 400 response |
| 404 | object | Error 404 response |
| 409 | object | Error 409 response |

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `checksum` | string | read-only | Hash of the target specification of the lakehouse. Send it back on update to make sure nobody changed the lakehouse in between. |
| `createdAt` | string (date-time) | read-only | Date the lakehouse was created |
| `currentState` | publicCloud.lakehouse.LakehouseCurrentState | read-only | Current state of the lakehouse, computed by the service |
| `currentState.description` | string | read-only | Description of the lakehouse. Null when it has none. |
| `currentState.endpoints` | publicCloud.lakehouse.Endpoint[] | read-only | Endpoints to reach the data of the lakehouse. Empty until the lakehouse is first READY. |
| `currentState.endpoints[].component` | publicCloud.lakehouse.EndpointComponentEnum | read-only | What the endpoint serves: the data console, the Apache Iceberg REST catalog, the OAuth2 token service, S3 storage or SQL — one of `DATA_CONSOLE`, `ICEBERG_REST`, `OAUTH2_TOKEN`, `S3`, `SQL` |
| `currentState.endpoints[].uri` | string | read-only | Address of the endpoint |
| `currentState.name` | string | read-only | Name of the lakehouse |
| `currentState.networkAccess` | publicCloud.lakehouse.NetworkAccess | read-only | Whether the source-address allowlist of the lakehouse is enforced in its region |
| `currentState.networkAccess.checkedAt` | string (date-time) | read-only | Date the region last checked the allowlist. Null when it has not reported it yet. |
| `currentState.networkAccess.message` | string | read-only | Why the allowlist is FAILED or UNSUPPORTED, for people. Null otherwise. It may change. Do not parse it. |
| `currentState.networkAccess.state` | publicCloud.lakehouse.NetworkAccessStateEnum | read-only | `DISABLED`: no filtering, every address may reach the lakehouse (filtering is off or the list is empty). `PENDING`: a change of the allowlist is being applied. `ENFORCED`: only the listed addresses may reach the lakehouse. `FAILED`: the allowlist could not be applied. `UNSUPPORTED`: the region no longer enforces allowlists. Disable or empty the list. — one of `DISABLED`, `ENFORCED`, `FAILED`, `PENDING`, `UNSUPPORTED` |
| `currentState.realm` | string | read-only | Realm of the lakehouse in the Apache Iceberg REST catalog of the region. Send it in the `Polaris-Realm` header of your Iceberg client. Null until the lakehouse is first READY. |
| `currentState.region` | publicCloud.lakehouse.RegionEnum | read-only | Region of the lakehouse: one of the region names listed by the lakehouse region reference — one of `eu-west-par`, `eu-west-poc` |
| `currentState.statusReason` | publicCloud.lakehouse.StatusReason | read-only | Why the lakehouse is in ERROR. Null in any other status. |
| `currentState.statusReason.code` | publicCloud.lakehouse.StatusReasonCodeEnum | read-only | Stable code of the reason, for programs — one of `CANCELED`, `CATALOG_NOT_EMPTY`, `DEDICATED_COMPUTE_POOL_EXISTS`, `DEDICATED_UNAVAILABLE`, `INVALID_SHAPE`, `LAKEHOUSE_NOT_EMPTY`, `OPERATION_FAILED`, `QUOTA_EXCEEDED`, `RECONCILE_FAILED`, `REGION_UNAVAILABLE`, `SCHEMA_NOT_EMPTY`, `TIMED_OUT` |
| `currentState.statusReason.message` | string | read-only | Explanation of the reason, for people. It may change. Do not parse it. |
| `currentTasks` | common.CurrentTask[] | read-only | Tasks in progress on the lakehouse, and its last failed task while the lakehouse is in ERROR. Always an array. Empty when there is none. |
| `currentTasks[].errors` | common.TaskError[] | read-only | Errors that occurred on the task |
| `currentTasks[].errors[].message` | string | read-only | Error description |
| `currentTasks[].id` | string (uuid) | read-only | Identifier of the current task |
| `currentTasks[].link` | string | read-only | Link to the task details |
| `currentTasks[].status` | common.CurrentTaskStatusEnum | read-only | Current global status of the current task — one of `ERROR`, `PENDING`, `RUNNING`, `SCHEDULED`, `WAITING_USER_INPUT` |
| `currentTasks[].type` | string | read-only | Type of the current task |
| `id` | string (uuid) | read-only | Unique identifier of the lakehouse |
| `resourceStatus` | common.ResourceStatusEnum | read-only | Readiness status of the lakehouse. A change is accepted only in READY or ERROR, except after a refused deletion (ERROR with a `*_NOT_EMPTY` status reason code), where only a new deletion is accepted. A deletion is also accepted in CREATING and UPDATING and replaces the change in progress. — one of `CREATING`, `CREATION_PLANNED`, `DELETING`, `ERROR`, `OUT_OF_SYNC`, `READY`, `SUSPENDED`, `UNKNOWN`, `UPDATING` |
| `targetSpec` | publicCloud.lakehouse.LakehouseTargetSpec | read-only | Last requested specification of the lakehouse |
| `targetSpec.description` | string | read-only | Description of the lakehouse. At most 255 characters. |
| `targetSpec.ipRestrictions` | publicCloud.lakehouse.IpRestriction[] | read-only | Source addresses allowed to reach the lakehouse, kept even while filtering is disabled. Empty when there is none. |
| `targetSpec.ipRestrictions[].description` | string |  | Description of the entry. At most 255 characters. |
| `targetSpec.ipRestrictions[].ip` | ipBlock | yes | A public IPv4 or IPv6 block in CIDR notation, or a single address (stored as a /32 or a /128). It is stored masked, for example 203.0.114.17/24 as 203.0.114.0/24. Private, loopback, link-local, multicast, documentation and other special-purpose ranges, and 0.0.0.0/0 and ::/0, are refused. |
| `targetSpec.ipRestrictionsEnabled` | boolean | read-only | Whether only the addresses of `ipRestrictions` may reach the lakehouse. When false, every address may. |
| `targetSpec.name` | string | read-only | Name of the lakehouse, unique in the project |
| `targetSpec.region` | publicCloud.lakehouse.RegionEnum | read-only | Region of the lakehouse: one of the region names listed by the lakehouse region reference. Immutable after creation. Not part of an update. — one of `eu-west-par`, `eu-west-poc` |
| `updatedAt` | string (date-time) | read-only | Date of the last change to the lakehouse |

```json
{
  "checksum": "string",
  "createdAt": "2024-01-01T12:00:00Z",
  "currentState": {
    "description": "string",
    "endpoints": [
      {
        "component": "DATA_CONSOLE",
        "uri": "string"
      }
    ],
    "name": "string",
    "networkAccess": {
      "checkedAt": "2024-01-01T12:00:00Z",
      "message": "string",
      "state": "DISABLED"
    },
    "realm": "string",
    "region": "eu-west-par",
    "statusReason": {
      "code": "CANCELED",
      "message": "string"
    }
  },
  "currentTasks": [
    {
      "errors": [
        {
          "message": "string"
        }
      ],
      "id": "00000000-0000-0000-0000-000000000000",
      "link": "string",
      "status": "ERROR",
      "type": "string"
    }
  ],
  "id": "00000000-0000-0000-0000-000000000000",
  "resourceStatus": "CREATING",
  "targetSpec": {
    "description": "string",
    "ipRestrictions": [
      {
        "description": "string",
        "ip": "192.0.2.0/24"
      }
    ],
    "ipRestrictionsEnabled": true,
    "name": "string",
    "region": "eu-west-par"
  },
  "updatedAt": "2024-01-01T12:00:00Z"
}
```

### Example

```bash
curl -X DELETE \
  "https://api.eu.ovhcloud.com/v2/publicCloud/project/{projectId}/managedAnalytics/lakehouse/{lakehouseId}" \
  -H "accept: application/json" \
  -H "X-Schemas-Version: 2026-06" \
  -H "authorization: Bearer $OVH_TOKEN"
```

```python
'''
First, install the latest release of Python wrapper: $ pip install ovh
'''
import json
import ovh

# Instantiate an OVH Client.
# You can generate new credentials with full access to your account on
# the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)
client = ovh.Client(
	endpoint='ovh-eu',               # Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)
	application_key='xxxxxxxxxx',    # Application Key
	application_secret='xxxxxxxxxx', # Application Secret
	consumer_key='xxxxxxxxxx',       # Consumer Key
)

result = client.delete("/v2/publicCloud/project/{projectId}/managedAnalytics/lakehouse/{lakehouseId}")

# Pretty print
print(json.dumps(result, indent=4))
```

```php
<?php
/**
 * First, download the latest release of PHP wrapper on github
 * And include this script into the folder with extracted files
 */
require __DIR__ . '/vendor/autoload.php';
use \Ovh\Api;

/**
 * Instantiate an OVH Client.
 * You can generate new credentials with full access to your account on
 * the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)
 */
$ovh = new Api('xxxxxxxxxx',  // Application Key
               'xxxxxxxxxx',  // Application Secret
               'ovh-eu',      // Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)
               'xxxxxxxxxx'); // Consumer Key

$result = $ovh->delete("/v2/publicCloud/project/{projectId}/managedAnalytics/lakehouse/{lakehouseId}");

print_r($result);
?>
```

## Update a lakehouse of your project

`PUT /v2/publicCloud/project/{projectId}/managedAnalytics/lakehouse/{lakehouseId}`

Link: https://developers.eu.ovhcloud.com/reference/public-cloud/analytics/lakehouse/#editLakehouseService

**Status:** Alpha version  
**IAM actions:** `publicCloudProject:apiovh:analytics/lakehouse/edit`

Replaces the lakehouse's target specification as a whole. The body carries the complete desired state of every field `publicCloud.lakehouse.LakehouseUpdateTargetSpec` exposes — `description`, `ipRestrictions`, `ipRestrictionsEnabled` and `name` — so read the lakehouse first and restate every value you want to keep: a field left out of `targetSpec` is cleared, not carried over from the stored specification. `ipRestrictions` and `ipRestrictionsEnabled` are required, so that a client unaware of them cannot wipe the allowlist by leaving them out: send the current list and switch to keep them.

The create-only fields `catalog` and `region` cannot be changed once the lakehouse exists. They are deliberately absent from the update model, and sending one is rejected with a 400.

A change of `ipRestrictions` or `ipRestrictionsEnabled` is applied asynchronously, since the region must enforce it: the response is 202 with the lakehouse UPDATING and the new task in `currentTasks`, and the lakehouse turns READY once `currentState.networkAccess` reads ENFORCED (or DISABLED). The list is validated as on creation. `ipRestrictionsEnabled` true with an empty list is rejected with a 400. Turning filtering off keeps the entries. Enabling filtering or adding addresses needs a region whose `ipRestrictions` capability is true, otherwise it is refused with a 409. Disabling filtering or removing entries is always accepted.

On a READY lakehouse a change of `name` or `description` alone is applied at once: the response is 200 with the lakehouse READY. On a lakehouse in ERROR the change is applied asynchronously, even when the specification is unchanged, to bring the lakehouse out of ERROR: the response is 202 with the lakehouse UPDATING and the new task in `currentTasks`. The update is refused with a 409 while the lakehouse is CREATING, UPDATING or DELETING, and after a refused deletion, from which only a new deletion is accepted.

The optional `checksum` guards against a lost update: when supplied it must match the lakehouse's current checksum or the request is rejected with a 409 checksum mismatch. Omitting it skips the check and forces the write (last-write-wins).

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `lakehouseId` | path | string (uuid) | yes | Lakehouse ID |
| `projectId` | path | string | yes | Project ID |

### Request body (required)

Type: `publicCloud.lakehouse.LakehouseUpdate`

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `checksum` | string |  | Checksum of the lakehouse as you last read it. When set, the update is refused with a 409 checksum-mismatch conflict if the lakehouse changed since. When omitted or empty, no check is made. |
| `targetSpec` | publicCloud.lakehouse.LakehouseUpdateTargetSpec | yes | New specification of the lakehouse. It replaces the whole current specification: an optional field you omit is reset to its default. Send only the fields of this model: a field that can only be set at creation is refused. |
| `targetSpec.description` | string |  | Description of the lakehouse. At most 255 characters. |
| `targetSpec.ipRestrictions` | publicCloud.lakehouse.IpRestriction[] | yes | The whole list of source addresses allowed to reach the lakehouse. An empty array for none. Restate the current list to keep it: it replaces the stored one. It is kept while filtering is disabled. At most 32 entries. |
| `targetSpec.ipRestrictions[].description` | string |  | Description of the entry. At most 255 characters. |
| `targetSpec.ipRestrictions[].ip` | ipBlock | yes | A public IPv4 or IPv6 block in CIDR notation, or a single address (stored as a /32 or a /128). It is stored masked, for example 203.0.114.17/24 as 203.0.114.0/24. Private, loopback, link-local, multicast, documentation and other special-purpose ranges, and 0.0.0.0/0 and ::/0, are refused. |
| `targetSpec.ipRestrictionsEnabled` | boolean | yes | Whether only the addresses of `ipRestrictions` may reach the lakehouse. true needs at least one entry. Turning it off keeps the entries. |
| `targetSpec.name` | string | yes | New name of the lakehouse, unique in the project |

```json
{
  "checksum": "string",
  "targetSpec": {
    "description": "string",
    "ipRestrictions": [
      {
        "description": "string",
        "ip": "192.0.2.0/24"
      }
    ],
    "ipRestrictionsEnabled": true,
    "name": "string"
  }
}
```

### Responses

| Status | Type | Description |
| --- | --- | --- |
| 200 | publicCloud.lakehouse.Lakehouse | successful operation |
| 400 | object | Error 400 response |
| 404 | object | Error 404 response |
| 409 | object | Error 409 response |

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `checksum` | string | read-only | Hash of the target specification of the lakehouse. Send it back on update to make sure nobody changed the lakehouse in between. |
| `createdAt` | string (date-time) | read-only | Date the lakehouse was created |
| `currentState` | publicCloud.lakehouse.LakehouseCurrentState | read-only | Current state of the lakehouse, computed by the service |
| `currentState.description` | string | read-only | Description of the lakehouse. Null when it has none. |
| `currentState.endpoints` | publicCloud.lakehouse.Endpoint[] | read-only | Endpoints to reach the data of the lakehouse. Empty until the lakehouse is first READY. |
| `currentState.endpoints[].component` | publicCloud.lakehouse.EndpointComponentEnum | read-only | What the endpoint serves: the data console, the Apache Iceberg REST catalog, the OAuth2 token service, S3 storage or SQL — one of `DATA_CONSOLE`, `ICEBERG_REST`, `OAUTH2_TOKEN`, `S3`, `SQL` |
| `currentState.endpoints[].uri` | string | read-only | Address of the endpoint |
| `currentState.name` | string | read-only | Name of the lakehouse |
| `currentState.networkAccess` | publicCloud.lakehouse.NetworkAccess | read-only | Whether the source-address allowlist of the lakehouse is enforced in its region |
| `currentState.networkAccess.checkedAt` | string (date-time) | read-only | Date the region last checked the allowlist. Null when it has not reported it yet. |
| `currentState.networkAccess.message` | string | read-only | Why the allowlist is FAILED or UNSUPPORTED, for people. Null otherwise. It may change. Do not parse it. |
| `currentState.networkAccess.state` | publicCloud.lakehouse.NetworkAccessStateEnum | read-only | `DISABLED`: no filtering, every address may reach the lakehouse (filtering is off or the list is empty). `PENDING`: a change of the allowlist is being applied. `ENFORCED`: only the listed addresses may reach the lakehouse. `FAILED`: the allowlist could not be applied. `UNSUPPORTED`: the region no longer enforces allowlists. Disable or empty the list. — one of `DISABLED`, `ENFORCED`, `FAILED`, `PENDING`, `UNSUPPORTED` |
| `currentState.realm` | string | read-only | Realm of the lakehouse in the Apache Iceberg REST catalog of the region. Send it in the `Polaris-Realm` header of your Iceberg client. Null until the lakehouse is first READY. |
| `currentState.region` | publicCloud.lakehouse.RegionEnum | read-only | Region of the lakehouse: one of the region names listed by the lakehouse region reference — one of `eu-west-par`, `eu-west-poc` |
| `currentState.statusReason` | publicCloud.lakehouse.StatusReason | read-only | Why the lakehouse is in ERROR. Null in any other status. |
| `currentState.statusReason.code` | publicCloud.lakehouse.StatusReasonCodeEnum | read-only | Stable code of the reason, for programs — one of `CANCELED`, `CATALOG_NOT_EMPTY`, `DEDICATED_COMPUTE_POOL_EXISTS`, `DEDICATED_UNAVAILABLE`, `INVALID_SHAPE`, `LAKEHOUSE_NOT_EMPTY`, `OPERATION_FAILED`, `QUOTA_EXCEEDED`, `RECONCILE_FAILED`, `REGION_UNAVAILABLE`, `SCHEMA_NOT_EMPTY`, `TIMED_OUT` |
| `currentState.statusReason.message` | string | read-only | Explanation of the reason, for people. It may change. Do not parse it. |
| `currentTasks` | common.CurrentTask[] | read-only | Tasks in progress on the lakehouse, and its last failed task while the lakehouse is in ERROR. Always an array. Empty when there is none. |
| `currentTasks[].errors` | common.TaskError[] | read-only | Errors that occurred on the task |
| `currentTasks[].errors[].message` | string | read-only | Error description |
| `currentTasks[].id` | string (uuid) | read-only | Identifier of the current task |
| `currentTasks[].link` | string | read-only | Link to the task details |
| `currentTasks[].status` | common.CurrentTaskStatusEnum | read-only | Current global status of the current task — one of `ERROR`, `PENDING`, `RUNNING`, `SCHEDULED`, `WAITING_USER_INPUT` |
| `currentTasks[].type` | string | read-only | Type of the current task |
| `id` | string (uuid) | read-only | Unique identifier of the lakehouse |
| `resourceStatus` | common.ResourceStatusEnum | read-only | Readiness status of the lakehouse. A change is accepted only in READY or ERROR, except after a refused deletion (ERROR with a `*_NOT_EMPTY` status reason code), where only a new deletion is accepted. A deletion is also accepted in CREATING and UPDATING and replaces the change in progress. — one of `CREATING`, `CREATION_PLANNED`, `DELETING`, `ERROR`, `OUT_OF_SYNC`, `READY`, `SUSPENDED`, `UNKNOWN`, `UPDATING` |
| `targetSpec` | publicCloud.lakehouse.LakehouseTargetSpec | read-only | Last requested specification of the lakehouse |
| `targetSpec.description` | string | read-only | Description of the lakehouse. At most 255 characters. |
| `targetSpec.ipRestrictions` | publicCloud.lakehouse.IpRestriction[] | read-only | Source addresses allowed to reach the lakehouse, kept even while filtering is disabled. Empty when there is none. |
| `targetSpec.ipRestrictions[].description` | string |  | Description of the entry. At most 255 characters. |
| `targetSpec.ipRestrictions[].ip` | ipBlock | yes | A public IPv4 or IPv6 block in CIDR notation, or a single address (stored as a /32 or a /128). It is stored masked, for example 203.0.114.17/24 as 203.0.114.0/24. Private, loopback, link-local, multicast, documentation and other special-purpose ranges, and 0.0.0.0/0 and ::/0, are refused. |
| `targetSpec.ipRestrictionsEnabled` | boolean | read-only | Whether only the addresses of `ipRestrictions` may reach the lakehouse. When false, every address may. |
| `targetSpec.name` | string | read-only | Name of the lakehouse, unique in the project |
| `targetSpec.region` | publicCloud.lakehouse.RegionEnum | read-only | Region of the lakehouse: one of the region names listed by the lakehouse region reference. Immutable after creation. Not part of an update. — one of `eu-west-par`, `eu-west-poc` |
| `updatedAt` | string (date-time) | read-only | Date of the last change to the lakehouse |

```json
{
  "checksum": "string",
  "createdAt": "2024-01-01T12:00:00Z",
  "currentState": {
    "description": "string",
    "endpoints": [
      {
        "component": "DATA_CONSOLE",
        "uri": "string"
      }
    ],
    "name": "string",
    "networkAccess": {
      "checkedAt": "2024-01-01T12:00:00Z",
      "message": "string",
      "state": "DISABLED"
    },
    "realm": "string",
    "region": "eu-west-par",
    "statusReason": {
      "code": "CANCELED",
      "message": "string"
    }
  },
  "currentTasks": [
    {
      "errors": [
        {
          "message": "string"
        }
      ],
      "id": "00000000-0000-0000-0000-000000000000",
      "link": "string",
      "status": "ERROR",
      "type": "string"
    }
  ],
  "id": "00000000-0000-0000-0000-000000000000",
  "resourceStatus": "CREATING",
  "targetSpec": {
    "description": "string",
    "ipRestrictions": [
      {
        "description": "string",
        "ip": "192.0.2.0/24"
      }
    ],
    "ipRestrictionsEnabled": true,
    "name": "string",
    "region": "eu-west-par"
  },
  "updatedAt": "2024-01-01T12:00:00Z"
}
```

### Example

```bash
curl -X PUT \
  "https://api.eu.ovhcloud.com/v2/publicCloud/project/{projectId}/managedAnalytics/lakehouse/{lakehouseId}" \
  -H "accept: application/json" \
  -H "X-Schemas-Version: 2026-06" \
  -H "authorization: Bearer $OVH_TOKEN" \
  -H "content-type: application/json" \
  -d '{ }'
```

```python
'''
First, install the latest release of Python wrapper: $ pip install ovh
'''
import json
import ovh

# Instantiate an OVH Client.
# You can generate new credentials with full access to your account on
# the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)
client = ovh.Client(
	endpoint='ovh-eu',               # Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)
	application_key='xxxxxxxxxx',    # Application Key
	application_secret='xxxxxxxxxx', # Application Secret
	consumer_key='xxxxxxxxxx',       # Consumer Key
)

# Request body type: publicCloud.lakehouse.LakehouseUpdate
result = client.put("/v2/publicCloud/project/{projectId}/managedAnalytics/lakehouse/{lakehouseId}",
	checksum = None, # Checksum of the lakehouse as you last read it. When set, the update is refused with a 409 checksum-mismatch conflict if the lakehouse changed since. When omitted or empty, no check is made. (type: string, nullable)
	targetSpec = None, # New specification of the lakehouse. It replaces the whole current specification: an optional field you omit is reset to its default. Send only the fields of this model: a field that can only be set at creation is refused. (type: publicCloud.lakehouse.LakehouseUpdateTargetSpec)
)

# Pretty print
print(json.dumps(result, indent=4))
```

```php
<?php
/**
 * First, download the latest release of PHP wrapper on github
 * And include this script into the folder with extracted files
 */
require __DIR__ . '/vendor/autoload.php';
use \Ovh\Api;

/**
 * Instantiate an OVH Client.
 * You can generate new credentials with full access to your account on
 * the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)
 */
$ovh = new Api('xxxxxxxxxx',  // Application Key
               'xxxxxxxxxx',  // Application Secret
               'ovh-eu',      // Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)
               'xxxxxxxxxx'); // Consumer Key

// Request body type: publicCloud.lakehouse.LakehouseUpdate
$result = $ovh->put("/v2/publicCloud/project/{projectId}/managedAnalytics/lakehouse/{lakehouseId}", array(
	checksum => null, // Checksum of the lakehouse as you last read it. When set, the update is refused with a 409 checksum-mismatch conflict if the lakehouse changed since. When omitted or empty, no check is made. (type: string, nullable)
	targetSpec => null, // New specification of the lakehouse. It replaces the whole current specification: an optional field you omit is reset to its default. Send only the fields of this model: a field that can only be set at creation is refused. (type: publicCloud.lakehouse.LakehouseUpdateTargetSpec)
));

print_r($result);
?>
```

## List the events of your lakehouse

`GET /v2/publicCloud/project/{projectId}/managedAnalytics/lakehouse/{lakehouseId}/event`

Link: https://developers.eu.ovhcloud.com/reference/public-cloud/analytics/lakehouse/#getLakehouseEvents

**Status:** Alpha version  
**IAM actions:** `publicCloudProject:apiovh:analytics/lakehouse/event/get`

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `X-Pagination-Cursor` | header | string |  | Pagination cursor |
| `X-Pagination-Size` | header | integer |  | Pagination size |
| `lakehouseId` | path | string (uuid) | yes | Lakehouse ID |
| `projectId` | path | string | yes | Project ID |
| `taskId` | query | string (uuid) |  | Return only the events of this task |

### Responses

| Status | Type | Description |
| --- | --- | --- |
| 200 | common.Event[] | successful operation |
| 400 | object | Error 400 response |
| 404 | object | Error 404 response |

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `createdAt` | string (date-time) | read-only | Creation date of the event |
| `kind` | string | read-only | Nature of the event |
| `link` | string | read-only | Link to the event related resource |
| `message` | string | read-only | Description of what happened on the event |
| `type` | common.EventTypeEnum | read-only | Type of the event — one of `TARGET_SPEC_UPDATE`, `TASK_ERROR`, `TASK_START`, `TASK_SUCCESS` |

```json
[
  {
    "createdAt": "2024-01-01T12:00:00Z",
    "kind": "string",
    "link": "string",
    "message": "string",
    "type": "TARGET_SPEC_UPDATE"
  }
]
```

### Example

```bash
curl -X GET \
  "https://api.eu.ovhcloud.com/v2/publicCloud/project/{projectId}/managedAnalytics/lakehouse/{lakehouseId}/event" \
  -H "accept: application/json" \
  -H "X-Schemas-Version: 2026-06" \
  -H "authorization: Bearer $OVH_TOKEN"
```

```python
'''
First, install the latest release of Python wrapper: $ pip install ovh
'''
import json
import ovh

# Instantiate an OVH Client.
# You can generate new credentials with full access to your account on
# the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)
client = ovh.Client(
	endpoint='ovh-eu',               # Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)
	application_key='xxxxxxxxxx',    # Application Key
	application_secret='xxxxxxxxxx', # Application Secret
	consumer_key='xxxxxxxxxx',       # Consumer Key
)

result = client.get("/v2/publicCloud/project/{projectId}/managedAnalytics/lakehouse/{lakehouseId}/event")

# Pretty print
print(json.dumps(result, indent=4))
```

```php
<?php
/**
 * First, download the latest release of PHP wrapper on github
 * And include this script into the folder with extracted files
 */
require __DIR__ . '/vendor/autoload.php';
use \Ovh\Api;

/**
 * Instantiate an OVH Client.
 * You can generate new credentials with full access to your account on
 * the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)
 */
$ovh = new Api('xxxxxxxxxx',  // Application Key
               'xxxxxxxxxx',  // Application Secret
               'ovh-eu',      // Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)
               'xxxxxxxxxx'); // Consumer Key

$result = $ovh->get("/v2/publicCloud/project/{projectId}/managedAnalytics/lakehouse/{lakehouseId}/event");

print_r($result);
?>
```

## List the tasks of your lakehouse

`GET /v2/publicCloud/project/{projectId}/managedAnalytics/lakehouse/{lakehouseId}/task`

Link: https://developers.eu.ovhcloud.com/reference/public-cloud/analytics/lakehouse/#getAllLakehouseTasks

**Status:** Alpha version  
**IAM actions:** `publicCloudProject:apiovh:analytics/lakehouse/task/get`

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `X-Pagination-Cursor` | header | string |  | Pagination cursor |
| `X-Pagination-Size` | header | integer |  | Pagination size |
| `lakehouseId` | path | string (uuid) | yes | Lakehouse ID |
| `projectId` | path | string | yes | Project ID |

### Responses

| Status | Type | Description |
| --- | --- | --- |
| 200 | common.Task[] | successful operation |
| 400 | object | Error 400 response |
| 404 | object | Error 404 response |

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `createdAt` | string (date-time) | read-only | Creation date of the task |
| `errors` | common.TaskError[] | read-only | Errors that occurred on the task |
| `errors[].message` | string | read-only | Error description |
| `finishedAt` | string (date-time) | read-only | Ending date of the task |
| `id` | string (uuid) | read-only | Unique identifier of the task |
| `link` | string | read-only | Link to the related resource |
| `message` | string | read-only | Description of the task |
| `progress` | common.TaskProgress[] | read-only | Progress steps of the asynchronous operation |
| `progress[].name` | string | read-only | Progress step name |
| `progress[].status` | common.TaskStatusEnum | read-only | Current status of the progress step — one of `DONE`, `ERROR`, `PENDING`, `RUNNING`, `SCHEDULED`, `WAITING_USER_INPUT` |
| `startedAt` | string (date-time) | read-only | Starting date of the task |
| `status` | common.TaskStatusEnum | read-only | Current global status of the task — one of `DONE`, `ERROR`, `PENDING`, `RUNNING`, `SCHEDULED`, `WAITING_USER_INPUT` |
| `type` | string | read-only | Type of the task |
| `updatedAt` | string (date-time) | read-only | Last update of the task |

```json
[
  {
    "createdAt": "2024-01-01T12:00:00Z",
    "errors": [
      {
        "message": "string"
      }
    ],
    "finishedAt": "2024-01-01T12:00:00Z",
    "id": "00000000-0000-0000-0000-000000000000",
    "link": "string",
    "message": "string",
    "progress": [
      {
        "name": "string",
        "status": "DONE"
      }
    ],
    "startedAt": "2024-01-01T12:00:00Z",
    "status": "DONE",
    "type": "string",
    "updatedAt": "2024-01-01T12:00:00Z"
  }
]
```

### Example

```bash
curl -X GET \
  "https://api.eu.ovhcloud.com/v2/publicCloud/project/{projectId}/managedAnalytics/lakehouse/{lakehouseId}/task" \
  -H "accept: application/json" \
  -H "X-Schemas-Version: 2026-06" \
  -H "authorization: Bearer $OVH_TOKEN"
```

```python
'''
First, install the latest release of Python wrapper: $ pip install ovh
'''
import json
import ovh

# Instantiate an OVH Client.
# You can generate new credentials with full access to your account on
# the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)
client = ovh.Client(
	endpoint='ovh-eu',               # Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)
	application_key='xxxxxxxxxx',    # Application Key
	application_secret='xxxxxxxxxx', # Application Secret
	consumer_key='xxxxxxxxxx',       # Consumer Key
)

result = client.get("/v2/publicCloud/project/{projectId}/managedAnalytics/lakehouse/{lakehouseId}/task")

# Pretty print
print(json.dumps(result, indent=4))
```

```php
<?php
/**
 * First, download the latest release of PHP wrapper on github
 * And include this script into the folder with extracted files
 */
require __DIR__ . '/vendor/autoload.php';
use \Ovh\Api;

/**
 * Instantiate an OVH Client.
 * You can generate new credentials with full access to your account on
 * the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)
 */
$ovh = new Api('xxxxxxxxxx',  // Application Key
               'xxxxxxxxxx',  // Application Secret
               'ovh-eu',      // Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)
               'xxxxxxxxxx'); // Consumer Key

$result = $ovh->get("/v2/publicCloud/project/{projectId}/managedAnalytics/lakehouse/{lakehouseId}/task");

print_r($result);
?>
```

## Get a task of your lakehouse

`GET /v2/publicCloud/project/{projectId}/managedAnalytics/lakehouse/{lakehouseId}/task/{taskId}`

Link: https://developers.eu.ovhcloud.com/reference/public-cloud/analytics/lakehouse/#getLakehouseTask

**Status:** Alpha version  
**IAM actions:** `publicCloudProject:apiovh:analytics/lakehouse/task/get`

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `lakehouseId` | path | string (uuid) | yes | Lakehouse ID |
| `projectId` | path | string | yes | Project ID |
| `taskId` | path | string (uuid) | yes | Task ID |

### Responses

| Status | Type | Description |
| --- | --- | --- |
| 200 | common.Task | successful operation |
| 400 | object | Error 400 response |
| 404 | object | Error 404 response |

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `createdAt` | string (date-time) | read-only | Creation date of the task |
| `errors` | common.TaskError[] | read-only | Errors that occurred on the task |
| `errors[].message` | string | read-only | Error description |
| `finishedAt` | string (date-time) | read-only | Ending date of the task |
| `id` | string (uuid) | read-only | Unique identifier of the task |
| `link` | string | read-only | Link to the related resource |
| `message` | string | read-only | Description of the task |
| `progress` | common.TaskProgress[] | read-only | Progress steps of the asynchronous operation |
| `progress[].name` | string | read-only | Progress step name |
| `progress[].status` | common.TaskStatusEnum | read-only | Current status of the progress step — one of `DONE`, `ERROR`, `PENDING`, `RUNNING`, `SCHEDULED`, `WAITING_USER_INPUT` |
| `startedAt` | string (date-time) | read-only | Starting date of the task |
| `status` | common.TaskStatusEnum | read-only | Current global status of the task — one of `DONE`, `ERROR`, `PENDING`, `RUNNING`, `SCHEDULED`, `WAITING_USER_INPUT` |
| `type` | string | read-only | Type of the task |
| `updatedAt` | string (date-time) | read-only | Last update of the task |

```json
{
  "createdAt": "2024-01-01T12:00:00Z",
  "errors": [
    {
      "message": "string"
    }
  ],
  "finishedAt": "2024-01-01T12:00:00Z",
  "id": "00000000-0000-0000-0000-000000000000",
  "link": "string",
  "message": "string",
  "progress": [
    {
      "name": "string",
      "status": "DONE"
    }
  ],
  "startedAt": "2024-01-01T12:00:00Z",
  "status": "DONE",
  "type": "string",
  "updatedAt": "2024-01-01T12:00:00Z"
}
```

### Example

```bash
curl -X GET \
  "https://api.eu.ovhcloud.com/v2/publicCloud/project/{projectId}/managedAnalytics/lakehouse/{lakehouseId}/task/{taskId}" \
  -H "accept: application/json" \
  -H "X-Schemas-Version: 2026-06" \
  -H "authorization: Bearer $OVH_TOKEN"
```

```python
'''
First, install the latest release of Python wrapper: $ pip install ovh
'''
import json
import ovh

# Instantiate an OVH Client.
# You can generate new credentials with full access to your account on
# the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)
client = ovh.Client(
	endpoint='ovh-eu',               # Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)
	application_key='xxxxxxxxxx',    # Application Key
	application_secret='xxxxxxxxxx', # Application Secret
	consumer_key='xxxxxxxxxx',       # Consumer Key
)

result = client.get("/v2/publicCloud/project/{projectId}/managedAnalytics/lakehouse/{lakehouseId}/task/{taskId}")

# Pretty print
print(json.dumps(result, indent=4))
```

```php
<?php
/**
 * First, download the latest release of PHP wrapper on github
 * And include this script into the folder with extracted files
 */
require __DIR__ . '/vendor/autoload.php';
use \Ovh\Api;

/**
 * Instantiate an OVH Client.
 * You can generate new credentials with full access to your account on
 * the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)
 */
$ovh = new Api('xxxxxxxxxx',  // Application Key
               'xxxxxxxxxx',  // Application Secret
               'ovh-eu',      // Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)
               'xxxxxxxxxx'); // Consumer Key

$result = $ovh->get("/v2/publicCloud/project/{projectId}/managedAnalytics/lakehouse/{lakehouseId}/task/{taskId}");

print_r($result);
?>
```
