> ## Documentation Index
> Fetch the complete documentation index at: https://docs.liftx.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Update an order template
> Use the query id and a complete reviewed template.
Preview contract. Production availability remains subject to activation and release qualification. Examples are synthetic; the documentation cannot submit requests.
## Authorization
`templates:write`; account template authority.
## Behavior
Use the query id and a complete reviewed template. The server enforces account ownership. Success is 204 with no body. This endpoint has no trading-command idempotency key; reconcile after transport ambiguity.
## JSON body example
The following shows the request shape, not live credentials or executable market defaults. Replace timestamps only when creating a new reviewed intent; never mutate them on a command retry.
```json theme={null}
{
"id": "44444444-4444-4444-8444-444444444444",
"user_id": 0,
"name": "Illustrative derivative limit",
"instrument_type": 2,
"position_side": 1,
"margin_mode": 1,
"leverage": 2,
"order_grid_enabled": false,
"open_price_deltas": [],
"open_quantity_percent": [
1000000
],
"sl_enabled": false,
"sl_price_rearrangement": false,
"slx_enabled": false,
"slx_tp_trailing_enabled": false,
"slx_each_tp_trailing": false,
"slx_sl_trailing_breakeven_enabled": false,
"slx_sl_trigger_price_trailing_enabled": false,
"tp_enabled": false,
"tp_price_rearrangement": false,
"tp_grid_enabled": false,
"tp_pnls": [],
"tp_quantity_percent": [],
"open_order_type": 1,
"sl_order_type": 2,
"tp_order_type": 1,
"created_at": 0,
"updated_at": 0
}
```
## Response and errors
The generated response schema below is the wire contract. A successful response has no body; do not attempt JSON decoding. Inspect HTTP status and Content-Type before decoding failures; reused trading routes may return JSON or plain text. Authentication, entitlement and exact link/instrument restrictions apply in addition to endpoint validation. See [errors and recovery](/api/errors-and-limits).
Do not automatically repeat a mutation after transport ambiguity. Trading commands reuse the exact immutable identity; credential issuance and template writes require their documented metadata/read reconciliation.
Read the [related guide](/api/templates-and-history) for lifecycle, units and recovery semantics.
## OpenAPI
````yaml api/openapi.json PUT /v1/templates/update
openapi: 3.1.0
info:
title: Liftx integrations
version: 1.0.0
description: >-
Preview contract for the Liftx API, TradingView webhook and session-owned
integration settings. Production availability is pending activation and
release qualification. External access requires Pro or trial entitlement and
is unmetered within bounded resource limits. Receipt acceptance does not
confirm execution completion. MCP is not active.
servers:
- url: https://api.liftx.io
security: []
paths:
/v1/templates/update:
put:
summary: Canonical template update
operationId: put_v1_templates_update
parameters:
- name: id
in: query
required: true
schema:
type: string
format: uuid
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/OrderTemplate'
responses:
'204':
description: Success
default:
description: >-
Integration errors use Error; existing trading handlers retain their
own JSON or text/plain error codec. Inspect status and content type.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
text/plain:
schema:
type: string
security:
- ApiKey: []
components:
schemas:
OrderTemplate:
type: object
properties:
id:
type: string
format: uuid
user_id:
type: integer
format: int64
name:
type: string
instrument_type:
type: integer
format: int64
position_side:
type: integer
format: int64
margin_mode:
anyOf:
- type: integer
format: int64
- type: 'null'
leverage:
anyOf:
- type: integer
format: int64
- type: 'null'
order_grid_enabled:
type: boolean
num_open_orders:
anyOf:
- type: integer
format: int64
- type: 'null'
open_orders_step:
anyOf:
- type: integer
format: int64
- type: 'null'
open_orders_factor:
anyOf:
- type: integer
format: int64
- type: 'null'
open_price_deltas:
type: array
items:
type: integer
format: int64
open_quantity_percent:
type: array
items:
type: integer
format: int64
sl_enabled:
type: boolean
sl_type:
anyOf:
- type: integer
format: int64
- type: 'null'
sl_step_percent:
anyOf:
- type: integer
format: int64
- type: 'null'
sl_price_rearrangement:
type: boolean
slx_enabled:
type: boolean
slx_tp_trailing_enabled:
type: boolean
slx_tp_breakeven:
anyOf:
- type: integer
format: int64
- type: 'null'
slx_each_tp_trailing:
type: boolean
slx_sl_trailing_breakeven_enabled:
type: boolean
slx_sl_trailing_breakeven_indent_percent:
anyOf:
- type: integer
format: int64
- type: 'null'
slx_sl_trigger_price_trailing_enabled:
type: boolean
slx_sl_trigger_price_trailing_pl_percent_activation:
anyOf:
- type: integer
format: int64
- type: 'null'
slx_sl_trigger_price_trailing_indent_percent:
anyOf:
- type: integer
format: int64
- type: 'null'
slx_sl_trigger_price_trailing_step:
anyOf:
- type: integer
format: int64
- type: 'null'
tp_enabled:
type: boolean
tp_price_rearrangement:
type: boolean
tp_grid_enabled:
type: boolean
num_tp_orders:
anyOf:
- type: integer
format: int64
- type: 'null'
tp_orders_step:
anyOf:
- type: integer
format: int64
- type: 'null'
tp_orders_factor:
anyOf:
- type: integer
format: int64
- type: 'null'
tp_pnls:
type: array
items:
type: integer
format: int64
tp_quantity_percent:
type: array
items:
type: integer
format: int64
open_order_type:
type: integer
format: int64
sl_order_type:
type: integer
format: int64
tp_order_type:
type: integer
format: int64
created_at:
type: integer
format: int64
updated_at:
type: integer
format: int64
required:
- id
- user_id
- name
- instrument_type
- position_side
- order_grid_enabled
- open_price_deltas
- open_quantity_percent
- sl_enabled
- sl_price_rearrangement
- slx_enabled
- slx_tp_trailing_enabled
- slx_each_tp_trailing
- slx_sl_trailing_breakeven_enabled
- slx_sl_trigger_price_trailing_enabled
- tp_enabled
- tp_price_rearrangement
- tp_grid_enabled
- tp_pnls
- tp_quantity_percent
- open_order_type
- sl_order_type
- tp_order_type
- created_at
- updated_at
additionalProperties: false
Error:
type: object
properties:
success:
const: false
error:
type: object
properties:
code:
type: string
message:
type: string
required:
- code
- message
additionalProperties: false
required:
- success
- error
additionalProperties: false
securitySchemes:
ApiKey:
type: http
scheme: bearer
bearerFormat: lx_api_.<256-bit secret>
````
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.