RevoEngine Documentation

POST

/

api

/

v1

/

assistant

/

threads

/

preflight

Create attachment preflight thread.

curl --request POST \
  --url https://api.revoengine.com/api/v1/assistant/threads/preflight \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "version": "v2",
  "model": "<string>",
  "executionMode": "interactive",
  "planningPolicy": "standard",
  "permissions": "default",
  "toolNames": [
    "<string>"
  ],
  "pluginIds": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ]
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    version: 'v2',
    model: '<string>',
    executionMode: 'interactive',
    planningPolicy: 'standard',
    permissions: 'default',
    toolNames: ['<string>'],
    pluginIds: ['3c90c3cc-0d44-4b50-8888-8dd25736052a']
  })
};

fetch('https://api.revoengine.com/api/v1/assistant/threads/preflight', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.revoengine.com/api/v1/assistant/threads/preflight"

payload = {
    "version": "v2",
    "model": "<string>",
    "executionMode": "interactive",
    "planningPolicy": "standard",
    "permissions": "default",
    "toolNames": ["<string>"],
    "pluginIds": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

Authorizations

Authorization

string

header

required

Bearer JWT token or API Key (sk-*).

Body

application/json

version

enum<string>

default:v2

Optional assistant runtime selector. v2 routes the draft thread through agent-gateway. v1 is expired and rejected.

Available options:

v1,

v2

model

string

Optional execution model identifier enabled for this instance.

reasoningEffort

enum<string>

Optional assistant reasoning effort for the draft thread: low, medium, high, or xhigh. Defaults to low.

Available options:

low,

medium,

high,

xhigh

reasoning

enum<string>

Alias for reasoningEffort used by assistant preferences. Prefer reasoningEffort for new clients.

Available options:

low,

medium,

high,

xhigh

executionMode

enum<string>

default:interactive

Execution mode to persist on the draft thread.

Available options:

interactive,

execute,

background,

automation

planningPolicy

enum<string>

default:standard

Planning policy to persist on the draft thread.

Available options:

standard,

review_required

permissions

enum<string>

default:default

Per-turn approval policy for the eventual first turn. default requires approval for side-effecting tool calls, auto_review uses conditional safe auto-review, and full skips normal approval gates.

Available options:

default,

auto_review,

full

toolNames

string[]

Optional allowlist of operational tool names for the eventual first turn. Omit to allow the gateway default surface; pass an empty array to admit no tools for direct-answer turns.

pluginIds

string<uuid>[]

Optional registry plugin ids attached to the draft thread and inherited by the first send when omitted there.

Response

Draft thread and hidden draft message created.

Last modified on September 5, 2026

Create attachment preflight thread.

curl --request POST \
  --url https://api.revoengine.com/api/v1/assistant/threads/preflight \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "version": "v2",
  "model": "<string>",
  "executionMode": "interactive",
  "planningPolicy": "standard",
  "permissions": "default",
  "toolNames": [
    "<string>"
  ],
  "pluginIds": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ]
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    version: 'v2',
    model: '<string>',
    executionMode: 'interactive',
    planningPolicy: 'standard',
    permissions: 'default',
    toolNames: ['<string>'],
    pluginIds: ['3c90c3cc-0d44-4b50-8888-8dd25736052a']
  })
};

fetch('https://api.revoengine.com/api/v1/assistant/threads/preflight', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.revoengine.com/api/v1/assistant/threads/preflight"

payload = {
    "version": "v2",
    "model": "<string>",
    "executionMode": "interactive",
    "planningPolicy": "standard",
    "permissions": "default",
    "toolNames": ["<string>"],
    "pluginIds": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)