POST
/
v2
/
push
curl --request POST \
  --url https://mango.sievedata.com/v2/push \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '{
  "function": "sieve/retalker",
  "id": "43d7add5-61cf-44ad-aac8-c5d14c642bb4",
  "inputs": {
    "input1": "a",
    "input2": "b"
  },
  "webhooks": [
    {
      "type": "job.start",
      "url": "<string>"
    }
  ],
  "env": {
    "OPENAI_API_KEY": "..."
  }
}'
{
  "id": "<string>",
  "run_id": "<string>",
  "stream_output": true,
  "status": "<string>",
  "organization_id": "<string>",
  "model_id": "<string>",
  "workflow_id": "<string>"
}

This endpoint triggers either a function or a model with a given set of inputs. The structure of the inputs should match the inputs types specified in the function or model definition.

​
Example

A function that takes in a sieve.File named video and a sieve.File named image would be triggered with the following request:

{
  "function": "sieve/sample_function",
  "inputs": {
    "video": {
      "url": "{SOME_VIDEO_URL}"
    },
    "image": {
      "url": "{SOME_IMAGE_URL}"
    }
  }
}

A function that takes in a string named prompt would be triggered with the following request:

{
  "function": "sieve/some_function",
  "inputs": {
    "prompt": "some string"
  }
}

​
Webhooks

Webhooks provide a way for notifications to be delivered to an external web server when various events related Sieve jobs occur.

The following is a full list of all webhook event types. Click the events to see the exact response payload.

EventDescription
job.startOccurs when a job starts.
job.completeOccurs when a job completes, errors, or is cancelled.
job.complete.no_outputOccurs when a job completes, errors, or is cancelled — excludes the output payload from the response.
job.new_outputOccurs when a job produces a new output.

See the webhooks guide for more information on webhook integration.

Authorizations

​
X-API-Key
string
header
required

The Sieve API key to authenticate with.

Body

application/json

Input schema for /v2/push.

Response

200
application/json
Successful Response

Output schema for /v2/push.