cURL
curl --request PATCH \
--url https://api.nekt.ai/api/v1/destinations/{slug}/ \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"draft": true,
"active": true,
"description": "<string>",
"connector_config": "<unknown>",
"input_tables": [
{
"table": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"fields": [
"<string>"
],
"primary_keys": [],
"name_alias": "<string>",
"field_mapping": "<unknown>"
}
],
"python_execution_cpu": 123,
"python_execution_memory": 123,
"trigger": null,
"settings_number_of_retries": 123,
"settings_retry_delay_seconds": 123,
"settings_max_consecutive_failures": 123
}
'import requests
url = "https://api.nekt.ai/api/v1/destinations/{slug}/"
payload = {
"draft": True,
"active": True,
"description": "<string>",
"connector_config": "<unknown>",
"input_tables": [
{
"table": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"fields": ["<string>"],
"primary_keys": [],
"name_alias": "<string>",
"field_mapping": "<unknown>"
}
],
"python_execution_cpu": 123,
"python_execution_memory": 123,
"trigger": None,
"settings_number_of_retries": 123,
"settings_retry_delay_seconds": 123,
"settings_max_consecutive_failures": 123
}
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
draft: true,
active: true,
description: '<string>',
connector_config: '<unknown>',
input_tables: [
{
table: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
fields: ['<string>'],
primary_keys: [],
name_alias: '<string>',
field_mapping: '<unknown>'
}
],
python_execution_cpu: 123,
python_execution_memory: 123,
trigger: null,
settings_number_of_retries: 123,
settings_retry_delay_seconds: 123,
settings_max_consecutive_failures: 123
})
};
fetch('https://api.nekt.ai/api/v1/destinations/{slug}/', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.nekt.ai/api/v1/destinations/{slug}/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'draft' => true,
'active' => true,
'description' => '<string>',
'connector_config' => '<unknown>',
'input_tables' => [
[
'table' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'fields' => [
'<string>'
],
'primary_keys' => [
],
'name_alias' => '<string>',
'field_mapping' => '<unknown>'
]
],
'python_execution_cpu' => 123,
'python_execution_memory' => 123,
'trigger' => null,
'settings_number_of_retries' => 123,
'settings_retry_delay_seconds' => 123,
'settings_max_consecutive_failures' => 123
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.nekt.ai/api/v1/destinations/{slug}/"
payload := strings.NewReader("{\n \"draft\": true,\n \"active\": true,\n \"description\": \"<string>\",\n \"connector_config\": \"<unknown>\",\n \"input_tables\": [\n {\n \"table\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"fields\": [\n \"<string>\"\n ],\n \"primary_keys\": [],\n \"name_alias\": \"<string>\",\n \"field_mapping\": \"<unknown>\"\n }\n ],\n \"python_execution_cpu\": 123,\n \"python_execution_memory\": 123,\n \"trigger\": null,\n \"settings_number_of_retries\": 123,\n \"settings_retry_delay_seconds\": 123,\n \"settings_max_consecutive_failures\": 123\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("x-api-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.patch("https://api.nekt.ai/api/v1/destinations/{slug}/")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"draft\": true,\n \"active\": true,\n \"description\": \"<string>\",\n \"connector_config\": \"<unknown>\",\n \"input_tables\": [\n {\n \"table\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"fields\": [\n \"<string>\"\n ],\n \"primary_keys\": [],\n \"name_alias\": \"<string>\",\n \"field_mapping\": \"<unknown>\"\n }\n ],\n \"python_execution_cpu\": 123,\n \"python_execution_memory\": 123,\n \"trigger\": null,\n \"settings_number_of_retries\": 123,\n \"settings_retry_delay_seconds\": 123,\n \"settings_max_consecutive_failures\": 123\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.nekt.ai/api/v1/destinations/{slug}/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"draft\": true,\n \"active\": true,\n \"description\": \"<string>\",\n \"connector_config\": \"<unknown>\",\n \"input_tables\": [\n {\n \"table\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"fields\": [\n \"<string>\"\n ],\n \"primary_keys\": [],\n \"name_alias\": \"<string>\",\n \"field_mapping\": \"<unknown>\"\n }\n ],\n \"python_execution_cpu\": 123,\n \"python_execution_memory\": 123,\n \"trigger\": null,\n \"settings_number_of_retries\": 123,\n \"settings_retry_delay_seconds\": 123,\n \"settings_max_consecutive_failures\": 123\n}"
response = http.request(request)
puts response.read_body{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"is_ml_ai_connector": true,
"slug": "<string>",
"archived": true,
"deleted": true,
"draft": true,
"active": true,
"status": "<string>",
"deploy_failed": true,
"deploy_failed_reason": "<string>",
"connector_config": "<unknown>",
"oauth_type": "<string>",
"pending_reauthorization": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"deadline": "2023-11-07T05:31:56Z",
"overdue": true,
"target_version": "<string>",
"oauth_type": "<string>"
},
"description": "<string>",
"input_tables": [
"<unknown>"
],
"input_volumes": [
"<unknown>"
],
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"python_execution_cpu": 123,
"python_execution_memory": 123,
"settings_number_of_retries": 123,
"settings_retry_delay_seconds": 123,
"settings_max_consecutive_failures": 123,
"connector_version": "<string>",
"last_run": "<string>",
"created_by": 123
}Destinations
Update Destination
Opt-in visibility of soft-deleted rows on the list action, for admins/owners only.
Views combine include_deleted_requested() with their own get_manager() to start the
list queryset from all_objects when the caller passes ?include_deleted=true. The opt-in
is intentionally scoped to list — update/trigger/destroy keep using the default (deleted-
excluding) manager, so they can never operate on a soft-deleted resource.
Only Owners/Admins may see deleted items; a non-admin caller (including token principals with
role=None, e.g. scoped MCP tokens) asking for them gets a 403.
PATCH
/
api
/
v1
/
destinations
/
{slug}
/
cURL
curl --request PATCH \
--url https://api.nekt.ai/api/v1/destinations/{slug}/ \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"draft": true,
"active": true,
"description": "<string>",
"connector_config": "<unknown>",
"input_tables": [
{
"table": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"fields": [
"<string>"
],
"primary_keys": [],
"name_alias": "<string>",
"field_mapping": "<unknown>"
}
],
"python_execution_cpu": 123,
"python_execution_memory": 123,
"trigger": null,
"settings_number_of_retries": 123,
"settings_retry_delay_seconds": 123,
"settings_max_consecutive_failures": 123
}
'import requests
url = "https://api.nekt.ai/api/v1/destinations/{slug}/"
payload = {
"draft": True,
"active": True,
"description": "<string>",
"connector_config": "<unknown>",
"input_tables": [
{
"table": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"fields": ["<string>"],
"primary_keys": [],
"name_alias": "<string>",
"field_mapping": "<unknown>"
}
],
"python_execution_cpu": 123,
"python_execution_memory": 123,
"trigger": None,
"settings_number_of_retries": 123,
"settings_retry_delay_seconds": 123,
"settings_max_consecutive_failures": 123
}
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
draft: true,
active: true,
description: '<string>',
connector_config: '<unknown>',
input_tables: [
{
table: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
fields: ['<string>'],
primary_keys: [],
name_alias: '<string>',
field_mapping: '<unknown>'
}
],
python_execution_cpu: 123,
python_execution_memory: 123,
trigger: null,
settings_number_of_retries: 123,
settings_retry_delay_seconds: 123,
settings_max_consecutive_failures: 123
})
};
fetch('https://api.nekt.ai/api/v1/destinations/{slug}/', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.nekt.ai/api/v1/destinations/{slug}/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'draft' => true,
'active' => true,
'description' => '<string>',
'connector_config' => '<unknown>',
'input_tables' => [
[
'table' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'fields' => [
'<string>'
],
'primary_keys' => [
],
'name_alias' => '<string>',
'field_mapping' => '<unknown>'
]
],
'python_execution_cpu' => 123,
'python_execution_memory' => 123,
'trigger' => null,
'settings_number_of_retries' => 123,
'settings_retry_delay_seconds' => 123,
'settings_max_consecutive_failures' => 123
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.nekt.ai/api/v1/destinations/{slug}/"
payload := strings.NewReader("{\n \"draft\": true,\n \"active\": true,\n \"description\": \"<string>\",\n \"connector_config\": \"<unknown>\",\n \"input_tables\": [\n {\n \"table\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"fields\": [\n \"<string>\"\n ],\n \"primary_keys\": [],\n \"name_alias\": \"<string>\",\n \"field_mapping\": \"<unknown>\"\n }\n ],\n \"python_execution_cpu\": 123,\n \"python_execution_memory\": 123,\n \"trigger\": null,\n \"settings_number_of_retries\": 123,\n \"settings_retry_delay_seconds\": 123,\n \"settings_max_consecutive_failures\": 123\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("x-api-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.patch("https://api.nekt.ai/api/v1/destinations/{slug}/")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"draft\": true,\n \"active\": true,\n \"description\": \"<string>\",\n \"connector_config\": \"<unknown>\",\n \"input_tables\": [\n {\n \"table\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"fields\": [\n \"<string>\"\n ],\n \"primary_keys\": [],\n \"name_alias\": \"<string>\",\n \"field_mapping\": \"<unknown>\"\n }\n ],\n \"python_execution_cpu\": 123,\n \"python_execution_memory\": 123,\n \"trigger\": null,\n \"settings_number_of_retries\": 123,\n \"settings_retry_delay_seconds\": 123,\n \"settings_max_consecutive_failures\": 123\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.nekt.ai/api/v1/destinations/{slug}/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"draft\": true,\n \"active\": true,\n \"description\": \"<string>\",\n \"connector_config\": \"<unknown>\",\n \"input_tables\": [\n {\n \"table\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"fields\": [\n \"<string>\"\n ],\n \"primary_keys\": [],\n \"name_alias\": \"<string>\",\n \"field_mapping\": \"<unknown>\"\n }\n ],\n \"python_execution_cpu\": 123,\n \"python_execution_memory\": 123,\n \"trigger\": null,\n \"settings_number_of_retries\": 123,\n \"settings_retry_delay_seconds\": 123,\n \"settings_max_consecutive_failures\": 123\n}"
response = http.request(request)
puts response.read_body{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"is_ml_ai_connector": true,
"slug": "<string>",
"archived": true,
"deleted": true,
"draft": true,
"active": true,
"status": "<string>",
"deploy_failed": true,
"deploy_failed_reason": "<string>",
"connector_config": "<unknown>",
"oauth_type": "<string>",
"pending_reauthorization": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"deadline": "2023-11-07T05:31:56Z",
"overdue": true,
"target_version": "<string>",
"oauth_type": "<string>"
},
"description": "<string>",
"input_tables": [
"<unknown>"
],
"input_volumes": [
"<unknown>"
],
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"python_execution_cpu": 123,
"python_execution_memory": 123,
"settings_number_of_retries": 123,
"settings_retry_delay_seconds": 123,
"settings_max_consecutive_failures": 123,
"connector_version": "<string>",
"last_run": "<string>",
"created_by": 123
}Authorizations
API Key authentication. Format: 'x-api-key: api_key'
Path Parameters
Body
application/jsonapplication/x-www-form-urlencodedmultipart/form-data
Response
200 - application/json
Pattern:
^[-a-zA-Z0-9_]+$OAuth application to re-authorize this destination with — resolved from the version it is pinned to.
Set when an update of the connector version changes its OAuth application: the customer has until deadline to re-authorize against oauth_type (the NEW application), submitting the config to POST .../version-migration/reauthorize/. Past the deadline (overdue) the destination was moved anyway and re-authorizing is a normal edit. Only on /api/v1/destinations/ itself; null where a destination is nested in another resource.
Show child attributes
Show child attributes
The number of times to retry a task in the settings if it fails
The number of seconds to retry a task in the settings if it fails
The maximum number of consecutive failures allowed before the settings is paused
Connector version used by this destination (Expandable)
Last Run from this destination (Expandable)
User that created this destination (Expandable)
Was this page helpful?