graphs

Execute graph agent

post/api/graphs/{graph_id}/execute/{graph_version}

Path parameters

graph_idstring required

graph_versioninteger nullable required

Query parameters

preset_idstring nullable

Request body

inputsobject

credentials_inputsobject

source'builder' | 'library' | 'onboarding' nullable

dry_runboolean

Response

Successful Response

idstring required

user_idstring required

graph_idstring required

graph_versioninteger required

inputsobject nullable required

credential_inputsobject nullable required

nodes_input_masksobject nullable required

preset_idstring nullable required

started_atstring date-time nullable

When execution started running. Null if not yet started (QUEUED).

ended_atstring date-time nullable

When execution finished. Null if not yet completed (QUEUED, RUNNING, INCOMPLETE, REVIEW).

is_sharedboolean

share_tokenstring nullable

is_dry_runboolean

organization_idstring nullable

team_idstring nullable

expert_idstring nullable

trigger_sourcestring nullable

trigger_refstring nullable

schedule_idstring nullable

webhook_idstring nullable

Changes

Changed in 11 of the 165 revisions of this API.417

Sep 12, 20263c4e43d8215a2See the full diff
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
Sep 7, 2026d3946c727d242See the full diff
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
Aug 20, 20262f82328f51841See the full diff
- ●
  added the new entitlement_required enum value to the /// response property for the response status
  response-property-enum-value-added
Aug 20, 2026ae1be5efc67a11See the full diff
- ●
  added the new device_code enum value to the /// response property for the response status
  response-property-enum-value-added
- ○
  added the new device_code enum value to the request property //
  request-property-enum-value-added
Aug 18, 202648316e19b6fd1See the full diff
- ○
  added the optional property // to the response with the status
  response-optional-property-added
Aug 6, 20263dfd3128358f1See the full diff
- ○
  added the optional property to the response with the status
  response-optional-property-added
Jul 9, 2026183f82172fec2See the full diff
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
May 9, 2026f3fe325e083c2See the full diff
- ○
  added the non-success response with the status
  response-non-success-status-added
- ○
  added the non-success response with the status
  response-non-success-status-added
May 9, 2026e90a755fa9e12See the full diff
- ○
  removed the non-success response with the status
  response-non-success-status-removed
- ○
  removed the non-success response with the status
  response-non-success-status-removed
This revision also has 5 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
May 8, 20269b85f454ac382See the full diff
- ○
  added the non-success response with the status
  response-non-success-status-added
- ○
  added the non-success response with the status
  response-non-success-status-added

Full history (11 revisions)