400
invalid_requestThe request did not satisfy the documented contract.
Beladed Marketing API
Update Segment through the reviewed Beladed Marketing contract.
/api/marketing/segment/updatecurl --request POST 'https://api.beladed.dev/api/marketing/segment/update' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'X-Beladed-API-Key: BELADED_SECRET_KEY' \
--data '{
"segmentId": "id_demo_001",
"updates": {
"name": "Premium Enterprise Leads - Updated",
"description": "Enhanced targeting for premium enterprise prospects with updated criteria",
"criteria": {
"conditions": [
{
"field": "leadScore",
"operator": "greater_than",
"value": 85
},
{
"field": "company.size",
"operator": "in",
"value": [
"enterprise"
]
}
],
"logic": "AND"
},
"automation": {
"refreshFrequency": "hourly"
}
}
}'const response = await fetch("https://api.beladed.dev/api/marketing/segment/update", {
method: "POST",
headers: {
"Accept": "application/json",
"Content-Type": "application/json",
"X-Beladed-API-Key": "BELADED_SECRET_KEY"
},
body: JSON.stringify({
"segmentId": "id_demo_001",
"updates": {
"name": "Premium Enterprise Leads - Updated",
"description": "Enhanced targeting for premium enterprise prospects with updated criteria",
"criteria": {
"conditions": [
{
"field": "leadScore",
"operator": "greater_than",
"value": 85
},
{
"field": "company.size",
"operator": "in",
"value": [
"enterprise"
]
}
],
"logic": "AND"
},
"automation": {
"refreshFrequency": "hourly"
}
}
})
});
const data = await response.json();import requests
response = requests.request(
"POST",
"https://api.beladed.dev/api/marketing/segment/update",
headers={"Accept":"application/json","Content-Type":"application/json","X-Beladed-API-Key":"BELADED_SECRET_KEY"},
json={
"segmentId": "id_demo_001",
"updates": {
"name": "Premium Enterprise Leads - Updated",
"description": "Enhanced targeting for premium enterprise prospects with updated criteria",
"criteria": {
"conditions": [
{
"field": "leadScore",
"operator": "greater_than",
"value": 85
},
{
"field": "company.size",
"operator": "in",
"value": [
"enterprise"
]
}
],
"logic": "AND"
},
"automation": {
"refreshFrequency": "hourly"
}
}
},
timeout=30,
)
response.raise_for_status()
data = response.json()<?php
$client = curl_init("https://api.beladed.dev/api/marketing/segment/update");
curl_setopt_array($client, [
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => ["Accept: application/json","Content-Type: application/json","X-Beladed-API-Key: BELADED_SECRET_KEY"],
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POSTFIELDS => json_encode({
"segmentId": "id_demo_001",
"updates": {
"name": "Premium Enterprise Leads - Updated",
"description": "Enhanced targeting for premium enterprise prospects with updated criteria",
"criteria": {
"conditions": [
{
"field": "leadScore",
"operator": "greater_than",
"value": 85
},
{
"field": "company.size",
"operator": "in",
"value": [
"enterprise"
]
}
],
"logic": "AND"
},
"automation": {
"refreshFrequency": "hourly"
}
}
}),
]);
$response = curl_exec($client);require "net/http"
require "json"
uri = URI("https://api.beladed.dev/api/marketing/segment/update")
request = Net::HTTP::Post.new(uri)
request["Accept"] = "application/json"
request["Content-Type"] = "application/json"
request["X-Beladed-API-Key"] = "BELADED_SECRET_KEY"
request.body = "{\n \"segmentId\": \"id_demo_001\",\n \"updates\": {\n \"name\": \"Premium Enterprise Leads - Updated\",\n \"description\": \"Enhanced targeting for premium enterprise prospects with updated criteria\",\n \"criteria\": {\n \"conditions\": [\n {\n \"field\": \"leadScore\",\n \"operator\": \"greater_than\",\n \"value\": 85\n },\n {\n \"field\": \"company.size\",\n \"operator\": \"in\",\n \"value\": [\n \"enterprise\"\n ]\n }\n ],\n \"logic\": \"AND\"\n },\n \"automation\": {\n \"refreshFrequency\": \"hourly\"\n }\n }\n}"
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }var request = java.net.http.HttpRequest.newBuilder()
.uri(java.net.URI.create("https://api.beladed.dev/api/marketing/segment/update"))
.header("Accept", "application/json")
.header("Content-Type", "application/json")
.header("X-Beladed-API-Key", "BELADED_SECRET_KEY")
.method("POST", java.net.http.HttpRequest.BodyPublishers.ofString("{\n \"segmentId\": \"id_demo_001\",\n \"updates\": {\n \"name\": \"Premium Enterprise Leads - Updated\",\n \"description\": \"Enhanced targeting for premium enterprise prospects with updated criteria\",\n \"criteria\": {\n \"conditions\": [\n {\n \"field\": \"leadScore\",\n \"operator\": \"greater_than\",\n \"value\": 85\n },\n {\n \"field\": \"company.size\",\n \"operator\": \"in\",\n \"value\": [\n \"enterprise\"\n ]\n }\n ],\n \"logic\": \"AND\"\n },\n \"automation\": {\n \"refreshFrequency\": \"hourly\"\n }\n }\n}"))
.build();
var response = java.net.http.HttpClient.newHttpClient().send(request, java.net.http.HttpResponse.BodyHandlers.ofString());package main
import (
"bytes"
"net/http"
)
func callBeladed() (*http.Response, error) {
body := []byte("{\n \"segmentId\": \"id_demo_001\",\n \"updates\": {\n \"name\": \"Premium Enterprise Leads - Updated\",\n \"description\": \"Enhanced targeting for premium enterprise prospects with updated criteria\",\n \"criteria\": {\n \"conditions\": [\n {\n \"field\": \"leadScore\",\n \"operator\": \"greater_than\",\n \"value\": 85\n },\n {\n \"field\": \"company.size\",\n \"operator\": \"in\",\n \"value\": [\n \"enterprise\"\n ]\n }\n ],\n \"logic\": \"AND\"\n },\n \"automation\": {\n \"refreshFrequency\": \"hourly\"\n }\n }\n}")
request, err := http.NewRequest("POST", "https://api.beladed.dev/api/marketing/segment/update", bytes.NewReader(body))
if err != nil { return nil, err }
request.Header.Set("Accept", "application/json")
request.Header.Set("Content-Type", "application/json")
request.Header.Set("X-Beladed-API-Key", "BELADED_SECRET_KEY")
return http.DefaultClient.Do(request)
}using var client = new HttpClient();
using var request = new HttpRequestMessage(new HttpMethod("POST"), "https://api.beladed.dev/api/marketing/segment/update");
request.Headers.TryAddWithoutValidation("Accept", "application/json");
request.Headers.TryAddWithoutValidation("Content-Type", "application/json");
request.Headers.TryAddWithoutValidation("X-Beladed-API-Key", "BELADED_SECRET_KEY");
request.Content = new StringContent("{\n \"segmentId\": \"id_demo_001\",\n \"updates\": {\n \"name\": \"Premium Enterprise Leads - Updated\",\n \"description\": \"Enhanced targeting for premium enterprise prospects with updated criteria\",\n \"criteria\": {\n \"conditions\": [\n {\n \"field\": \"leadScore\",\n \"operator\": \"greater_than\",\n \"value\": 85\n },\n {\n \"field\": \"company.size\",\n \"operator\": \"in\",\n \"value\": [\n \"enterprise\"\n ]\n }\n ],\n \"logic\": \"AND\"\n },\n \"automation\": {\n \"refreshFrequency\": \"hourly\"\n }\n }\n}", System.Text.Encoding.UTF8, "application/json");
using var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();var request = URLRequest(url: URL(string: "https://api.beladed.dev/api/marketing/segment/update")!)
request.httpMethod = "POST"
request.setValue("application/json", forHTTPHeaderField: "Accept")
request.setValue("application/json", forHTTPHeaderField: "Content-Type")
request.setValue("BELADED_SECRET_KEY", forHTTPHeaderField: "X-Beladed-API-Key")
request.httpBody = "{\n \"segmentId\": \"id_demo_001\",\n \"updates\": {\n \"name\": \"Premium Enterprise Leads - Updated\",\n \"description\": \"Enhanced targeting for premium enterprise prospects with updated criteria\",\n \"criteria\": {\n \"conditions\": [\n {\n \"field\": \"leadScore\",\n \"operator\": \"greater_than\",\n \"value\": 85\n },\n {\n \"field\": \"company.size\",\n \"operator\": \"in\",\n \"value\": [\n \"enterprise\"\n ]\n }\n ],\n \"logic\": \"AND\"\n },\n \"automation\": {\n \"refreshFrequency\": \"hourly\"\n }\n }\n}".data(using: .utf8)
let (data, response) = try await URLSession.shared.data(for: request)val request = okhttp3.Request.Builder()
.url("https://api.beladed.dev/api/marketing/segment/update")
.addHeader("Accept", "application/json")
.addHeader("Content-Type", "application/json")
.addHeader("X-Beladed-API-Key", "BELADED_SECRET_KEY")
.method("POST", okhttp3.RequestBody.create(okhttp3.MediaType.get("application/json"), "{\n \"segmentId\": \"id_demo_001\",\n \"updates\": {\n \"name\": \"Premium Enterprise Leads - Updated\",\n \"description\": \"Enhanced targeting for premium enterprise prospects with updated criteria\",\n \"criteria\": {\n \"conditions\": [\n {\n \"field\": \"leadScore\",\n \"operator\": \"greater_than\",\n \"value\": 85\n },\n {\n \"field\": \"company.size\",\n \"operator\": \"in\",\n \"value\": [\n \"enterprise\"\n ]\n }\n ],\n \"logic\": \"AND\"\n },\n \"automation\": {\n \"refreshFrequency\": \"hourly\"\n }\n }\n}"))
.build()
val response = okhttp3.OkHttpClient().newCall(request).execute()
This operation has no documented parameters.
{
"type": "object",
"properties": {
"segmentId": {
"type": "string"
},
"updates": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"description": {
"type": "string"
},
"criteria": {
"type": "object",
"properties": {
"conditions": {
"type": "array",
"items": {
"type": "object",
"properties": {
"field": {
"type": "string"
},
"operator": {
"type": "string"
},
"value": {
"type": "integer"
}
}
}
},
"logic": {
"type": "string"
}
}
},
"automation": {
"type": "object",
"properties": {
"refreshFrequency": {
"type": "string"
}
}
}
}
}
}
}{
"segmentId": "id_demo_001",
"updates": {
"name": "Premium Enterprise Leads - Updated",
"description": "Enhanced targeting for premium enterprise prospects with updated criteria",
"criteria": {
"conditions": [
{
"field": "leadScore",
"operator": "greater_than",
"value": 85
},
{
"field": "company.size",
"operator": "in",
"value": [
"enterprise"
]
}
],
"logic": "AND"
},
"automation": {
"refreshFrequency": "hourly"
}
}
}
{
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"status": {
"type": "string"
}
}
},
"requestId": {
"type": "string"
}
}
}{
"data": {
"id": "id_demo_001",
"status": "available"
},
"requestId": "req_demo_001"
}
invalid_requestThe request did not satisfy the documented contract.
authentication_requiredThe credential is missing or invalid.
not_authorizedThe account, product scope, permission, or origin is not eligible.
not_foundThe requested public or account-owned resource was not found.
rate_limitedRetry after the current product limit resets.
This operation is published from reviewed repository contracts. Source metadata is included for traceability without exposing internal implementation details.