For AI agents: the complete documentation index is available at https://docs.dataplatform.ovh.net/llms.txt, the full documentation bundle is available at https://docs.dataplatform.ovh.net/llms-full.txt, and this page is available as Markdown at https://docs.dataplatform.ovh.net/legacy/api-reference.md.
  • 🇬🇧 English
  • ForePaaS APIs

    Warning

    This page describes the ForePaaS Legacy Platform, which no longer accepts new signups. If you are using OVHcloud Data Platform, see the Data Platform APIs.

    In addition to the graphical user interface (GUI), you can also interact with your ForePaaS Project through the endpoints in the ForePaaS APIs. It provides a developer alternative to the GUI for building and managing ForePaaS Projects.

    Below are the API references for each component.

    API reference forMain context of use
    BucketsInteract with the buckets of your Lakehouse Manager.
    Query BuilderInteract with your Query Builder and its metadata.
    Identity Access ManagerInteract with your Identity Access Manager (IAM), typically to manage authentication.
    ForePaaS StoreInteract with the ForePaaS Store, typically to manage your application's modules or application's templates.

    General formats

    Response format

    • Data format: JSON see http://www.json.org
    • Character set: UTF-8
    • All non-empty responses are sent with the header: Content-Type: application/json; charset=utf-8

    HTTP response codes

    CodeMessageSignification
    200OKDefault response for successful GET or POST requests with non-empty content
    400Bad RequestInvalid value for GET or POST parameters
    401UnauthorizedInvalid Credentials or Rights
    403ForbiddenAuthentication error
    404Not FoundAction or request not found
    500Internal ServerA server-side error occurred

    Error handling

    In case of client-side (HTTP status code 4xx) or server-side (HTTP status code 5xx) error, the response body may contain a JSON object describing the error:

    {
       "error": "Invalid parameter", // code 400, 403, 500
       "warning": "Action not found" // code 404
    }

    Timestamp

    All data endpoints return the timestamp associated with the data provided.

    {
        "timestamp": 1435929960
    }

    Duration

    All data endpoints return the duration attribute. It represents the effective time taken by the system to execute a request in seconds.

    {
        "duration": 0.056
    }