Create a task

POST {{baseUrl}}/api/v2/databases/:database/schemas/:schema/tasks?createMode=errorIfExists

Create a task, with standard create modifiers as query parameters. See the Task component definition for what is required to be provided in the request body.

Request Params

KeyDatatypeRequiredDescription
createModestringQuery parameter allowing support for different modes of resource creation. Possible values include:
  • errorIfExists: Throws an error if you try to create a resource that already exists.
  • orReplace: Automatically replaces the existing resource with the current one.
  • ifNotExists: Creates a new resource when an alter is requested for a non-existent resource. |

Request Body

{"name"=>"l", "definition"=>"<string>", "warehouse"=>"bBzuom", "schedule"=>{"schedule_type"=>"<string>"}, "comment"=>"<string>", "finalize"=>"<string>", "task_auto_retry_attempts"=>"<integer>", "config"=>{"nostrud2_9"=>-65835073}, "session_parameters"=>{"voluptate6a2"=>27785958}, "predecessors"=>["<string>", "<string>"], "task_relations"=>"<string>", "user_task_managed_initial_warehouse_size"=>"<string>", "user_task_timeout_ms"=>"<integer>", "suspend_task_after_num_failures"=>"<integer>", "condition"=>"<string>", "allow_overlapping_execution"=>"<boolean>", "error_integration"=>"<string>", "created_on"=>"<dateTime>", "id"=>"<string>", "owner"=>"<string>", "owner_role_type"=>"<string>", "state"=>"suspended", "last_committed_on"=>"<dateTime>", "last_suspended_on"=>"<dateTime>", "database_name"=>"<string>", "schema_name"=>"<string>"}

HEADERS

KeyDatatypeRequiredDescription
Content-Typestring
Acceptstring

RESPONSES

status: OK

{&quot;status&quot;:&quot;\u003cstring\u003e&quot;}