curl --request POST \
--url https://code.deepline.com/api/v2/integrations/{toolId}/execute \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data @- <<EOF
{
"payload": {
"sql": "SELECT company_name, normalized_domain FROM companies WHERE normalized_domain = 'openai.com' LIMIT 1"
}
}
EOFconst options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
payload: {
sql: 'SELECT company_name, normalized_domain FROM companies WHERE normalized_domain = \'openai.com\' LIMIT 1'
}
})
};
fetch('https://code.deepline.com/api/v2/integrations/{toolId}/execute', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://code.deepline.com/api/v2/integrations/{toolId}/execute"
payload = { "payload": { "sql": "SELECT company_name, normalized_domain FROM companies WHERE normalized_domain = 'openai.com' LIMIT 1" } }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"status": "<string>",
"toolResponse": {
"rawV2": "<unknown>",
"view": "data",
"responseMeta": {}
},
"job_id": "<string>",
"meta": {},
"extractedLists": {},
"extractedValues": {},
"billing": {
"credits_charged": 123,
"cost_usd": 123,
"pricing_status": "final",
"settlement_status": "pending",
"estimated_credits": 123,
"estimated_cost_usd": 123
}
}{
"error": "Unauthorized"
}{
"error": "Unauthorized"
}{
"error": "Unauthorized"
}{
"error": "Unauthorized"
}{
"error": "Unauthorized"
}{
"error": "Unauthorized"
}{
"error": "Unauthorized"
}{
"error": "Unauthorized"
}{
"error": "Unauthorized"
}Execute one provider-backed tool
Executes the named tool with a JSON payload. Authenticate with a Deepline workspace API key and inspect the tool description first. Optional Idempotency-Key binds one workspace-scoped execution to this request and caller identity; repeat the same key and input to recover or replay it. New keys authorize new executions. Keyed async calls require a declared recoverable lifecycle and completion-waiting mode; unsupported launch-only modes return 422 before dispatch.
curl --request POST \
--url https://code.deepline.com/api/v2/integrations/{toolId}/execute \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data @- <<EOF
{
"payload": {
"sql": "SELECT company_name, normalized_domain FROM companies WHERE normalized_domain = 'openai.com' LIMIT 1"
}
}
EOFconst options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
payload: {
sql: 'SELECT company_name, normalized_domain FROM companies WHERE normalized_domain = \'openai.com\' LIMIT 1'
}
})
};
fetch('https://code.deepline.com/api/v2/integrations/{toolId}/execute', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://code.deepline.com/api/v2/integrations/{toolId}/execute"
payload = { "payload": { "sql": "SELECT company_name, normalized_domain FROM companies WHERE normalized_domain = 'openai.com' LIMIT 1" } }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"status": "<string>",
"toolResponse": {
"rawV2": "<unknown>",
"view": "data",
"responseMeta": {}
},
"job_id": "<string>",
"meta": {},
"extractedLists": {},
"extractedValues": {},
"billing": {
"credits_charged": 123,
"cost_usd": 123,
"pricing_status": "final",
"settlement_status": "pending",
"estimated_credits": 123,
"estimated_cost_usd": 123
}
}{
"error": "Unauthorized"
}{
"error": "Unauthorized"
}{
"error": "Unauthorized"
}{
"error": "Unauthorized"
}{
"error": "Unauthorized"
}{
"error": "Unauthorized"
}{
"error": "Unauthorized"
}{
"error": "Unauthorized"
}{
"error": "Unauthorized"
}Authorization: Bearer <key>.
The request example uses toolId=free_simple_company_search. Replace both the tool ID and payload for another action. Read its tool contract first.
URL-encode path values, including / characters inside Play references and run IDs.
Errors
| Status | Meaning |
|---|---|
| 400 | The request conflicts with current state or a retained request identity. |
| 401 | The request conflicts with current state or a retained request identity. |
| 402 | The request conflicts with current state or a retained request identity. |
| 404 | The request conflicts with current state or a retained request identity. |
| 409 | The request conflicts with current state or a retained request identity. |
| 410 | The request conflicts with current state or a retained request identity. |
| 422 | The request conflicts with current state or a retained request identity. |
| 429 | The request conflicts with current state or a retained request identity. |
| 500 | The request conflicts with current state or a retained request identity. |
Authorizations
Create a workspace API key in the Deepline dashboard before calling authenticated endpoints.
Headers
Optional caller-owned execution key. Case-sensitive, 1–200 ASCII letters, digits, period, underscore, colon, or hyphen. Persist before dispatch. Changed input conflicts; expired keys cannot be reused.
1 - 200^[A-Za-z0-9._:-]+$Path Parameters
The toolId returned by the related Deepline API call.
1Body
Input matching the selected tool input schema.
Input matching the selected tool input schema.