Skip to main content
Function calls represent asynchronous executions of a Cognite Function. When you call a function, CDF creates a call object that tracks the execution. You can list calls, retrieve their status, view logs, and get the response data.

​
What function calls are

A function call is created each time a function is invoked—either manually via the API or triggered by a schedule. The call object tracks the lifecycle of the execution: queued, running, succeeded, or failed. You use the call API to poll for status and retrieve results when the execution completes.

​
Monitoring and debugging

  • List calls: Filter by function, status, or time range to find relevant executions.
  • Retrieve status: Check whether a call is still running or has completed.
  • View logs: Access execution logs for debugging and troubleshooting.
  • Get response: Retrieve the return value or output data from successful calls.
Calls are asynchronous. Poll the call status until the execution completes before fetching the response.

​
Call input

Pass input in the data object. The function receives it as the data argument. Runtime details are available as function_call_info when the handler accepts that argument.
Do not put secrets in data. Store secrets on the function, in the secrets object used when you create the function.

​
Execution limits

Each call has a maximum execution time of 15 minutes. If a call exceeds this limit, it is terminated and marked as failed. Plan your function logic to complete within this window or split work across multiple calls.
Last modified on November 2, 2026