Skip to main content

Send a Job

POST 

/api/workspaces/:workspace_id/entities/:id/jobs/

Sends a job request. If the poll_result post parameter is true then the BE polls for job completion for a short period before responding.

  • 201 response means poll is not or could not be completed within a specific time, so the job should be polled through the job polling endpoint.
  • 200 response means job returned with full response.

Request

Path Parameters

    workspace_id stringrequired
    id integerrequired

    A unique integer value identifying this entity.

Body

required

    poll_result boolean

    Default value: false

    Let the endpoint temporarily poll for the result.

    method_name string

    Possible values: non-empty

    Name to the method to run the App Job.

    method_type string

    Possible values: non-empty

    Type to the method to run the App Job.

    editor_session uuid

    UUID of the current editor session. This field is required when called under public endpoints.

    params objectnullable

    Default value: [object Object]

    (Optional) params as input for App Job.

    events string[]

    Default value: ``

    (Optional) events as input for App Job.

    arguments objectnullable

    Default value: [object Object]

    (deprecated) replaced with params.

    method string

    Possible values: non-empty

    (deprecated) replaced with method_name.

Responses

Schema

    uid integer

    The uid of the AppJob.

    message string

    Possible values: non-empty

    Progress message when app runner is still processing the job.

    kind string

    Possible values: non-empty

    The result payload kind.

    status string

    Possible values: non-empty

    Status of the AppJob. 'success' | 'error' | 'error_user' | 'stopped' | 'message'.

    error_message string

    Possible values: non-empty

    If error is raised, the error message returned.

    error_stack_trace object

    If error is raised, the stack trace is returned.

    invalid_fields object

    Any invalid fields that were found during the Job.

    content object

    The actual result content.

Loading...