Creating Forecast and Scenarios for projects via API

Hey guys!

I would like to know if it’s possible to create a forecast or scenario for a project using the API only, without the UI

Looking at the API docs seems like I can update and get the values of the forecast/scenario but I’m not being able to see how to create it without using the UI. Without that, seems like I need to ask the user to create the forecast/scenario and only after that I can ingest our data to forecast (b factor, q start, di eff, d sw-eff)

Our goal is to create a workflow where we create a project and populate it with all the data we have and in the end, give our team a ready-to-analyze project

Our goal is to create a workflow where we create a project and populate it with all the data we have and in the end, give our team a ready-to-analyze project

You are correct in regards to the forecast

  • As of today, you can create a new project with the POST v1/projects endpoint.

  • The next step would be to create a new forecast which is not supported by the API.

  • you can get the output of the forecast with /v1/projects/:projectId/forecasts/:forecastId/outputs

  • you can add wells to the forecast with the API using the POST /v1/projects/:projectId/forecasts/:id/wells.

  • You can insert, upsert, or delete the forecast parameters (b factor, q start, di eff, d sw-eff) with the /v1/projects/:projectId/forecasts/:forecastId/parameters/:wellId/:phase/:series endpoint.

The good news is that in an upcoming release, we will be adding several endpoints that should assist you with the scenario portion.

You will be able to :

  • Create a new project with the POST v1/projects endpoint.

  • (Awaiting release) Create a new scenario with the /v1/projects/:projectId/scenarios endpoint.

  • Create new economic models with v1/projects/:projectId/econ-models/<pick a model to add/update> In the same release we should have support for all models.

  • (Awaiting release) Assign the econ models to a scenario with v1/projects/:projectId/econ-models/:econName/:econModelId/assignments

  • (Awaiting release) Add qualifiers with v1/projects/:projectId/scenarios/:scenarioId/qualifiers

So in conclusion, it seems that the only thing that will be missing would be creating new forecasts via the API. As far as a timeline goes I believe we will be doing a small release with some config changes this week and depending on how that goes maybe a week or two from now we will do the release with all of the new scenario endpoints mentioned above.

If adding a forecast via the API is a feature that you feel would add significant value to your company I can talk to the API product manager and let them know that this is something you’d like to have.

hey @HGantz , thanks for all the explanation.

Looking forward to the release of this next version.

I have a follow-up question. I’m watching some of the videos inside the Knowledge base and just found out about “Lookup Tables”

Is this available in the API? I’m not seeing any info about it in the docs. Is there any plan to include it too?

thanks

Glad to help @willjosefi!

So lookup tables are not available in the API and they aren’t on our roadmap either. If lookup tables are a feature you’re interested in you can always reach out to your account representative at ComboCurve and let them know. I will let the product manager know you mentioned it as well.

hey @HGantz
do you guys have a timeline for the release of those new features?

is it possible for us to start testing even not released? like a canary channel or something?

thank you

If you are referring to the econ features I mentioned previously, they were released yesterday evening.

Edit:
Here are the qualifiers docs

Here are the well assignment docs

Here are the econ assignment docs

and if you open the econ-models folder in the documentation you will see that we now support all econ models.