Sign in
Graph Workflow

Execute Graph Workflow

Execute a graph workflow with directed agent nodes and edges. Enables complex multi-agent collaboration with parallel execution, automatic compilation, and comprehensive workflow orchestration.

post/v1/graph-workflow/completions

Headers

x-api-keystring required

Request body

namestring nullable

The name of the graph workflow.

descriptionstring nullable

The description of the graph workflow.

entry_pointsstring[] nullable

List of node IDs that serve as starting points for the workflow.

end_pointsstring[] nullable

List of node IDs that serve as ending points for the workflow.

max_loopsinteger nullable

The maximum number of execution loops for the workflow.

taskstring nullable

The task to be executed by the workflow.

imgstring nullable

Optional image path for vision-enabled agents.

auto_compileboolean nullable

Whether to automatically compile the workflow for optimization.

verboseboolean nullable

Whether to enable detailed logging.

Response

Successful Response

job_idstring required

The job ID of the graph workflow.

namestring nullable

The name of the graph workflow.

descriptionstring nullable

The description of the graph workflow.

statusstring required

The status of the graph workflow.

{"stackTrail":"components:schemas:GraphWorkflowOutput:properties:outputs","oasType":"schema","type":"unknown","title":"Outputs","description":"The outputs of the graph workflow."}
timestampstring required

The timestamp of the graph workflow execution.

Changes

Changed in 9 of the 80 revisions of this API.4347

  • e05df8f412ad1See the full diff
    • ○

      added the new None enum value to the request property ////

      request-property-enum-value-added

  • 2f1c2f28613911See the full diff
    • ▲

      removed the required property / from the response with the status

      response-required-property-removed

    • ○

      added the required property / to the response with the status

      response-required-property-added

    This revision also has 3 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 0882a16375db14See the full diff
    • ▲

      removed from the /// request property anyOf list

      request-property-any-of-removed

    • ○

      added the new optional request property ///

      new-optional-request-property

    • ○

      added subschema #3 to the /// request property anyOf list

      request-property-any-of-added

    • ○

      added subschema #1 to the /// request property anyOf list

      request-property-any-of-added

    • ○

      added subschema #2 to the /// request property anyOf list

      request-property-any-of-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • dd6e1de072c711See the full diff
    • ●

      the //// request property's min was set to 1.00

      request-property-min-set

    • ○

      the request property default value medium was removed

      request-property-default-value-removed

  • 74ed1cde0bfc2See the full diff
    • ○

      added the new optional request property ///

      new-optional-request-property

    • ○

      added the new optional request property ///

      new-optional-request-property

  • dcbc7787aed73See the full diff
    • ○

      added the new optional request property ///

      new-optional-request-property

    • ○

      the request property default value changed from true to false

      request-property-default-value-changed

    • ○

      the request property default value changed from gpt-4.1 to claude-sonnet-5

      request-property-default-value-changed

  • 90f1182a9c4d26See the full diff
    • ○

      added the new optional request property /////

      new-optional-request-property

    • ○

      added the new optional request property /////

      new-optional-request-property

    • ○

      added the new optional request property /////

      new-optional-request-property

    • ○

      added the new optional request property /////

      new-optional-request-property

    • ○

      added the new optional request property /////

      new-optional-request-property

    • ○

      added the new optional request property /////

      new-optional-request-property

    • ○

      added the new optional request property /////

      new-optional-request-property

    • ○

      added the new optional request property /////

      new-optional-request-property

    • ○

      added the new optional request property /////

      new-optional-request-property

    • ○

      added the new optional request property /////

      new-optional-request-property

    • ○

      added the new optional request property /////

      new-optional-request-property

    • ○

      added the new optional request property ///////

      new-optional-request-property

    • ○

      added the new optional request property ///////

      new-optional-request-property

    • ○

      added the new optional request property ///////

      new-optional-request-property

    • ○

      added the new optional request property ///////

      new-optional-request-property

    • ○

      added the new optional request property ///////

      new-optional-request-property

    • ○

      added the new optional request property ///////

      new-optional-request-property

    • ○

      added the new optional request property ///////

      new-optional-request-property

    • ○

      added the new optional request property ///////

      new-optional-request-property

    • ○

      added the new optional request property ///////

      new-optional-request-property

    • ○

      added the new optional request property ///////

      new-optional-request-property

    • ○

      added the new optional request property ///////

      new-optional-request-property

    • ○

      the request property default value changed from 10 to 30

      request-property-default-value-changed

    • ○

      the request property default value changed from 10 to 30

      request-property-default-value-changed

    • ○

      added the new minimal enum value to the request property ////

      request-property-enum-value-added

    • ○

      added the new none enum value to the request property ////

      request-property-enum-value-added

  • a4b2639c845e15See the full diff
    • ▲

      removed the enum value minimal of the request property ////

      request-property-enum-value-removed

    • ○

      the request property default value changed from 8192 to 16000

      request-property-default-value-changed

    • ○

      the request property default value changed from low to medium

      request-property-default-value-changed

    • ○

      added the new max enum value to the request property ////

      request-property-enum-value-added

    • ○

      added the new ultra enum value to the request property ////

      request-property-enum-value-added

    • ○

      added the new xhigh enum value to the request property ////

      request-property-enum-value-added

  • 9666c890823b124See the full diff
    • ▲

      request property //// was restricted to a list of enum values

      request-property-became-enum

    • ●

      the //// request property's max was set to 2.00

      request-property-max-set

    • ●

      the //// request property's min was set to 0.00

      request-property-min-set

    • ○

      added the new high enum value to the request property ////

      request-property-enum-value-added

    • ○

      added the new low enum value to the request property ////

      request-property-enum-value-added

    • ○

      added the new medium enum value to the request property ////

      request-property-enum-value-added

    • ○

      added the new minimal enum value to the request property ////

      request-property-enum-value-added