/api/v1/executions/nestings

GET

const url = 'https://api.endless.zaia.app/api/v1/executions/nestings';
const options = {method: 'GET'};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://api.endless.zaia.app/api/v1/executions/nestings

Retrieves an execution with its children.

Parameters

Query Parameters

chatMessageId

A UUID v4 string that identifies an entity.

string format: uuid

A UUID v4 string that identifies an entity.

executionId

A UUID v4 string that identifies an entity.

string format: uuid

A UUID v4 string that identifies an entity.

Responses

200

Retrieves an execution with its children.

application/json

object

createdAt

required

string format: date-time

required

A UUID v4 string that identifies an entity.

string format: uuid

updatedAt

required

string format: date-time

creditsUsed

required

The total number of credits used by this execution.

number

detail

required

Any of:

object

input

required

The input data for this execution.

object

key

additional properties

nullable

output

required

The output data for this execution.

object

key

additional properties

nullable

agentId

required

The agent identifier.

string

events

required

The events that occurred during this agent execution.

Array

Any of:

object
object

object

creditsUsed

required

The number of credits used by this event.

number

endedAt

required

When this event ended.

string format: date-time

nullable

required

The event identifier.

string

input

Any of:

unknown
object

The input data for this event.

nullable

label

required

The label for this event.

string

>= 3 characters <= 50 characters

llmUsages

The custom-provider LLM usages recorded for this event.

Array<object>

object

inputTokens

required

The input token count reported by the LLM provider.

integer

nullable

model

required

The model key used for this LLM usage.

string

outputTokens

required

The output token count reported by the LLM provider.

integer

nullable

provider

required

The provider metadata associated with this LLM usage.

object

required

The provider ID associated with the LLM usage, when one exists.

string

nullable

name

required

The display name of the provider associated with the LLM usage.

string

>= 3 characters <= 50 characters

output

required

The output data for this event.

object

key

additional properties

nullable

startedAt

required

When this event started.

string format: date-time

status

required

The status of the event.

string

Allowed values: running completed failed skipped

llm

required

The model key used during the iteration event.

string

llmProvider

required

The provider metadata associated with the iteration event.

object

required

The provider ID associated with the LLM usage, when one exists.

string

nullable

name

required

The display name of the provider associated with the LLM usage.

string

>= 3 characters <= 50 characters

type

required

The event subtype represented by this payload.

string

Allowed values: iteration

origin

required

Any of:

object

apiKeyId

required

The API key identifier.

string

type

required

The execution origin subtype represented by this payload.

string

Allowed values: api

type

required

The execution detail subtype represented by this payload.

string

Allowed values: agent-execution

endedAt

required

When this execution ended.

string format: date-time

nullable

isAgentic

required

Whether this execution is agentic.

boolean

isFailedAttempt

required

Whether this execution belongs to a failed retry attempt.

boolean

isPurged

required

Whether this execution has been purged.

boolean

parentId

required

The parent execution ID of this execution.

string format: uuid

nullable

responderId

required

The responder ID of this execution.

string

startedAt

required

When this execution started.

string format: date-time

status

required

The status of the execution.

string

Allowed values: running completed failed cancelled

workspaceId

required

The workspace ID of this execution.

string

children

required

The direct children associated with this execution node.

Array<object>

object

createdAt

required

string format: date-time

required

A UUID v4 string that identifies an entity.

string format: uuid

updatedAt

required

string format: date-time

creditsUsed

required

The total number of credits used by this execution.

number

detail

required

Any of:

object

input

required

The input data for this execution.

object

key

additional properties

nullable

output

required

The output data for this execution.

object

key

additional properties

nullable

agentId

required

The agent identifier.

string

events

required

The events that occurred during this agent execution.

Array

Any of:

object
object

object

creditsUsed

required

The number of credits used by this event.

number

endedAt

required

When this event ended.

string format: date-time

nullable

required

The event identifier.

string

input

Any of:

unknown
object

The input data for this event.

nullable

label

required

The label for this event.

string

>= 3 characters <= 50 characters

llmUsages

The custom-provider LLM usages recorded for this event.

Array<object>

object

inputTokens

required

The input token count reported by the LLM provider.

integer

nullable

model

required

The model key used for this LLM usage.

string

outputTokens

required

The output token count reported by the LLM provider.

integer

nullable

provider

required

The provider metadata associated with this LLM usage.

object

required

The provider ID associated with the LLM usage, when one exists.

string

nullable

name

required

The display name of the provider associated with the LLM usage.

string

>= 3 characters <= 50 characters

output

required

The output data for this event.

object

key

additional properties

nullable

startedAt

required

When this event started.

string format: date-time

status

required

The status of the event.

string

Allowed values: running completed failed skipped

llm

required

The model key used during the iteration event.

string

llmProvider

required

The provider metadata associated with the iteration event.

object

required

The provider ID associated with the LLM usage, when one exists.

string

nullable

name

required

The display name of the provider associated with the LLM usage.

string

>= 3 characters <= 50 characters

type

required

The event subtype represented by this payload.

string

Allowed values: iteration

origin

required

Any of:

object

apiKeyId

required

The API key identifier.

string

type

required

The execution origin subtype represented by this payload.

string

Allowed values: api

type

required

The execution detail subtype represented by this payload.

string

Allowed values: agent-execution

endedAt

required

When this execution ended.

string format: date-time

nullable

isAgentic

required

Whether this execution is agentic.

boolean

isFailedAttempt

required

Whether this execution belongs to a failed retry attempt.

boolean

isPurged

required

Whether this execution has been purged.

boolean

parentId

required

The parent execution ID of this execution.

string format: uuid

nullable

responderId

required

The responder ID of this execution.

string

startedAt

required

When this execution started.

string format: date-time

status

required

The status of the execution.

string

Allowed values: running completed failed cancelled

workspaceId

required

The workspace ID of this execution.

string

children

required

The nested children associated with this execution node.

Array<object>

object

createdAt

required

string format: date-time

required

A UUID v4 string that identifies an entity.

string format: uuid

updatedAt

required

string format: date-time

creditsUsed

required

The total number of credits used by this execution.

number

detail

required

Any of:

object

input

required

The input data for this execution.

object

key

additional properties

nullable

output

required

The output data for this execution.

object

key

additional properties

nullable

agentId

required

The agent identifier.

string

events

required

The events that occurred during this agent execution.

Array

Any of:

object
object

object

creditsUsed

required

The number of credits used by this event.

number

endedAt

required

When this event ended.

string format: date-time

nullable

required

The event identifier.

string

input

Any of:

unknown
object

The input data for this event.

nullable

label

required

The label for this event.

string

>= 3 characters <= 50 characters

llmUsages

The custom-provider LLM usages recorded for this event.

Array<object>

object

inputTokens

required

The input token count reported by the LLM provider.

integer

nullable

model

required

The model key used for this LLM usage.

string

outputTokens

required

The output token count reported by the LLM provider.

integer

nullable

provider

required

The provider metadata associated with this LLM usage.

object

required

The provider ID associated with the LLM usage, when one exists.

string

nullable

name

required

The display name of the provider associated with the LLM usage.

string

>= 3 characters <= 50 characters

output

required

The output data for this event.

object

key

additional properties

nullable

startedAt

required

When this event started.

string format: date-time

status

required

The status of the event.

string

Allowed values: running completed failed skipped

llm

required

The model key used during the iteration event.

string

llmProvider

required

The provider metadata associated with the iteration event.

object

required

The provider ID associated with the LLM usage, when one exists.

string

nullable

name

required

The display name of the provider associated with the LLM usage.

string

>= 3 characters <= 50 characters

type

required

The event subtype represented by this payload.

string

Allowed values: iteration

origin

required

Any of:

object

apiKeyId

required

The API key identifier.

string

type

required

The execution origin subtype represented by this payload.

string

Allowed values: api

type

required

The execution detail subtype represented by this payload.

string

Allowed values: agent-execution

endedAt

required

When this execution ended.

string format: date-time

nullable

isAgentic

required

Whether this execution is agentic.

boolean

isFailedAttempt

required

Whether this execution belongs to a failed retry attempt.

boolean

isPurged

required

Whether this execution has been purged.

boolean

parentId

required

The parent execution ID of this execution.

string format: uuid

nullable

responderId

required

The responder ID of this execution.

string

startedAt

required

When this execution started.

string format: date-time

status

required

The status of the execution.

string

Allowed values: running completed failed cancelled

workspaceId

required

The workspace ID of this execution.

string

children

required

The nested child executions associated with this execution node.

Array

costEstimation

required

The custom-provider cost estimation for the inspected execution.

object

estimatedTotalCostUsd

required

Any of:

number
string

number

inputTokens

required

The aggregated input token count for the inspected execution.

integer

nullable

iterations

required

The custom-provider LLM usages that compose this estimate.

Array<object>

object

estimatedCostUsd

required

Any of:

number
string

number

eventId

required

The event identifier that recorded this LLM usage.

string

eventType

required

The event type that recorded this LLM usage.

string

Allowed values: iteration tool-call workflow-node

executionId

required

The execution identifier that recorded this LLM usage.

string

inputTokens

required

The input token count for this LLM usage.

integer

nullable

label

required

The label of the event that recorded this LLM usage.

string

>= 3 characters <= 50 characters

model

required

The model key used for this LLM usage.

string

outputTokens

required

The output token count for this LLM usage.

integer

nullable

provider

required

The provider metadata associated with this LLM usage.

object

required

The provider ID associated with the LLM usage, when one exists.

string

nullable

name

required

The display name of the provider associated with the LLM usage.

string

>= 3 characters <= 50 characters

outputTokens

required

The aggregated output token count for the inspected execution.

integer

nullable

Example

{
  "detail": {
    "events": [
      {
        "status": "running",
        "type": "iteration"
      }
    ],
    "origin": {
      "type": "api"
    },
    "type": "agent-execution"
  },
  "status": "running",
  "children": [
    {
      "detail": {
        "events": [
          {
            "status": "running",
            "type": "iteration"
          }
        ],
        "origin": {
          "type": "api"
        },
        "type": "agent-execution"
      },
      "status": "running",
      "children": [
        {
          "detail": {
            "events": [
              {
                "status": "running",
                "type": "iteration"
              }
            ],
            "origin": {
              "type": "api"
            },
            "type": "agent-execution"
          },
          "status": "running"
        }
      ]
    }
  ],
  "costEstimation": {
    "estimatedTotalCostUsd": "N/A",
    "iterations": [
      {
        "estimatedCostUsd": "N/A",
        "eventType": "iteration"
      }
    ]
  }
}

400

At least one of executionId or chatMessageId must be provided.

application/json

The description of a known exception.

object

code

The error code.

string

cta

The error call-to-action.

object

type

required

string

Allowed values: support-contact

url

required

string format: uri

feedback

required

The error feedback.

object

enUs

string

esEs

string

ptBr

string

message

required

The error message.

string

name

required

The error name.

string

Example

{
  "cta": {
    "type": "support-contact"
  }
}

401

Unauthorized.

application/json

The description of a known exception.

object

code

The error code.

string

cta

The error call-to-action.

object

type

required

string

Allowed values: support-contact

url

required

string format: uri

feedback

required

The error feedback.

object

enUs

string

esEs

string

ptBr

string

message

required

The error message.

string

name

required

The error name.

string

Example

{
  "cta": {
    "type": "support-contact"
  }
}

404

Execution not found.

application/json

The description of a known exception.

object

code

The error code.

string

cta

The error call-to-action.

object

type

required

string

Allowed values: support-contact

url

required

string format: uri

feedback

required

The error feedback.

object

enUs

string

esEs

string

ptBr

string

message

required

The error message.

string

name

required

The error name.

string

Example

{
  "cta": {
    "type": "support-contact"
  }
}

412

The chat message is a follow-up response without executions; use the trigger chat message.

application/json

The description of a known exception.

object

code

The error code.

string

cta

The error call-to-action.

object

type

required

string

Allowed values: support-contact

url

required

string format: uri

feedback

required

The error feedback.

object

enUs

string

esEs

string

ptBr

string

message

required

The error message.

string

name

required

The error name.

string

Example

{
  "cta": {
    "type": "support-contact"
  }
}