Sign in
v1
schedules

Create execution schedule

post/api/graphs/{graph_id}/schedules

Path parameters

graph_idstring required

ID of the graph to schedule

ID of the graph to schedule

Request body

graph_versioninteger nullable
namestring required
cronstring required
inputsobject required
credentialsobject
timezonestring nullable

User's timezone for scheduling (e.g., 'America/New_York'). If not provided, will use user's saved timezone or UTC.

expert_idstring nullable

Attribute this schedule (and every run it fires) to a hired expert owned by the caller. If omitted, resolved automatically when exactly one active hired expert has this graph installed as a workflow.

Response

Successful Response

kind'graph'
schedule_idstring nullable
user_idstring required
graph_idstring required
graph_versioninteger required
agent_namestring nullable
cronstring required
input_dataobject required
input_credentialsobject
organization_idstring
team_idstring nullable
expert_idstring nullable
idstring required
namestring required
next_run_timestring required
timezonestring

Timezone used for scheduling

Changes

Changed in 5 of the 92 revisions of this API.46

  • ae1be5efc67a11See 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

  • 3dfd3128358f2See the full diff
    • ○

      added the new optional request property

      new-optional-request-property

    • ○

      added the optional property to the response with the status

      response-optional-property-added

  • 183f82172fec2See 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

  • 9238e6f78f701See the full diff
    • ○

      added the optional property to the response with the status

      response-optional-property-added

  • 8c84efcb3afb3See the full diff
    • ●

      removed the optional property from the response with the status

      response-optional-property-removed

    • ●

      removed the optional property from the response with the status

      response-optional-property-removed

    • ●

      removed the optional property from the response with the status

      response-optional-property-removed

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