400
invalid_requestThe request did not satisfy the documented contract.
Beladed Pages API
Create Community Challenge through the reviewed Beladed Pages contract.
/api/pages/general/createcurl --request POST 'https://api.beladed.dev/api/pages/general/create' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'X-Beladed-API-Key: BELADED_SECRET_KEY' \
--data '{
"title": "Beladed Challenge Hub",
"name": "Beladed Challenge Hub",
"headline": "Vote for your side",
"description": "A test Pages payload for community voting and signup.",
"pageType": "Community",
"pageSubType": "Challenge",
"status": "published",
"visibility": "public",
"templateId": "challenge-starter",
"sections": [
{
"id": "id_demo_001",
"type": "hero",
"title": "Challenge accepted"
},
{
"id": "id_demo_001",
"type": "cta",
"title": "Join the challenge"
}
],
"leadCapture": {
"enabled": true,
"email": {
"enabled": true,
"label": "Email address",
"placeholder": "Enter your email",
"consentText": "By subscribing you agree to receive updates."
},
"sms": {
"enabled": true,
"label": "Mobile number",
"placeholder": "Enter your mobile number",
"consentText": "I agree to receive SMS updates related to this page."
},
"social": {
"enabled": true,
"label": "Social handle",
"placeholder": "Instagram @handle"
}
},
"audienceChoice": {
"enabled": true,
"options": [
"Blue Team",
"Gold Team"
],
"collectEmail": "developer@example.invalid",
"showResults": false
}
}'const response = await fetch("https://api.beladed.dev/api/pages/general/create", {
method: "POST",
headers: {
"Accept": "application/json",
"Content-Type": "application/json",
"X-Beladed-API-Key": "BELADED_SECRET_KEY"
},
body: JSON.stringify({
"title": "Beladed Challenge Hub",
"name": "Beladed Challenge Hub",
"headline": "Vote for your side",
"description": "A test Pages payload for community voting and signup.",
"pageType": "Community",
"pageSubType": "Challenge",
"status": "published",
"visibility": "public",
"templateId": "challenge-starter",
"sections": [
{
"id": "id_demo_001",
"type": "hero",
"title": "Challenge accepted"
},
{
"id": "id_demo_001",
"type": "cta",
"title": "Join the challenge"
}
],
"leadCapture": {
"enabled": true,
"email": {
"enabled": true,
"label": "Email address",
"placeholder": "Enter your email",
"consentText": "By subscribing you agree to receive updates."
},
"sms": {
"enabled": true,
"label": "Mobile number",
"placeholder": "Enter your mobile number",
"consentText": "I agree to receive SMS updates related to this page."
},
"social": {
"enabled": true,
"label": "Social handle",
"placeholder": "Instagram @handle"
}
},
"audienceChoice": {
"enabled": true,
"options": [
"Blue Team",
"Gold Team"
],
"collectEmail": "developer@example.invalid",
"showResults": false
}
})
});
const data = await response.json();import requests
response = requests.request(
"POST",
"https://api.beladed.dev/api/pages/general/create",
headers={"Accept":"application/json","Content-Type":"application/json","X-Beladed-API-Key":"BELADED_SECRET_KEY"},
json={
"title": "Beladed Challenge Hub",
"name": "Beladed Challenge Hub",
"headline": "Vote for your side",
"description": "A test Pages payload for community voting and signup.",
"pageType": "Community",
"pageSubType": "Challenge",
"status": "published",
"visibility": "public",
"templateId": "challenge-starter",
"sections": [
{
"id": "id_demo_001",
"type": "hero",
"title": "Challenge accepted"
},
{
"id": "id_demo_001",
"type": "cta",
"title": "Join the challenge"
}
],
"leadCapture": {
"enabled": true,
"email": {
"enabled": true,
"label": "Email address",
"placeholder": "Enter your email",
"consentText": "By subscribing you agree to receive updates."
},
"sms": {
"enabled": true,
"label": "Mobile number",
"placeholder": "Enter your mobile number",
"consentText": "I agree to receive SMS updates related to this page."
},
"social": {
"enabled": true,
"label": "Social handle",
"placeholder": "Instagram @handle"
}
},
"audienceChoice": {
"enabled": true,
"options": [
"Blue Team",
"Gold Team"
],
"collectEmail": "developer@example.invalid",
"showResults": false
}
},
timeout=30,
)
response.raise_for_status()
data = response.json()<?php
$client = curl_init("https://api.beladed.dev/api/pages/general/create");
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({
"title": "Beladed Challenge Hub",
"name": "Beladed Challenge Hub",
"headline": "Vote for your side",
"description": "A test Pages payload for community voting and signup.",
"pageType": "Community",
"pageSubType": "Challenge",
"status": "published",
"visibility": "public",
"templateId": "challenge-starter",
"sections": [
{
"id": "id_demo_001",
"type": "hero",
"title": "Challenge accepted"
},
{
"id": "id_demo_001",
"type": "cta",
"title": "Join the challenge"
}
],
"leadCapture": {
"enabled": true,
"email": {
"enabled": true,
"label": "Email address",
"placeholder": "Enter your email",
"consentText": "By subscribing you agree to receive updates."
},
"sms": {
"enabled": true,
"label": "Mobile number",
"placeholder": "Enter your mobile number",
"consentText": "I agree to receive SMS updates related to this page."
},
"social": {
"enabled": true,
"label": "Social handle",
"placeholder": "Instagram @handle"
}
},
"audienceChoice": {
"enabled": true,
"options": [
"Blue Team",
"Gold Team"
],
"collectEmail": "developer@example.invalid",
"showResults": false
}
}),
]);
$response = curl_exec($client);require "net/http"
require "json"
uri = URI("https://api.beladed.dev/api/pages/general/create")
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 \"title\": \"Beladed Challenge Hub\",\n \"name\": \"Beladed Challenge Hub\",\n \"headline\": \"Vote for your side\",\n \"description\": \"A test Pages payload for community voting and signup.\",\n \"pageType\": \"Community\",\n \"pageSubType\": \"Challenge\",\n \"status\": \"published\",\n \"visibility\": \"public\",\n \"templateId\": \"challenge-starter\",\n \"sections\": [\n {\n \"id\": \"id_demo_001\",\n \"type\": \"hero\",\n \"title\": \"Challenge accepted\"\n },\n {\n \"id\": \"id_demo_001\",\n \"type\": \"cta\",\n \"title\": \"Join the challenge\"\n }\n ],\n \"leadCapture\": {\n \"enabled\": true,\n \"email\": {\n \"enabled\": true,\n \"label\": \"Email address\",\n \"placeholder\": \"Enter your email\",\n \"consentText\": \"By subscribing you agree to receive updates.\"\n },\n \"sms\": {\n \"enabled\": true,\n \"label\": \"Mobile number\",\n \"placeholder\": \"Enter your mobile number\",\n \"consentText\": \"I agree to receive SMS updates related to this page.\"\n },\n \"social\": {\n \"enabled\": true,\n \"label\": \"Social handle\",\n \"placeholder\": \"Instagram @handle\"\n }\n },\n \"audienceChoice\": {\n \"enabled\": true,\n \"options\": [\n \"Blue Team\",\n \"Gold Team\"\n ],\n \"collectEmail\": \"developer@example.invalid\",\n \"showResults\": false\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/pages/general/create"))
.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 \"title\": \"Beladed Challenge Hub\",\n \"name\": \"Beladed Challenge Hub\",\n \"headline\": \"Vote for your side\",\n \"description\": \"A test Pages payload for community voting and signup.\",\n \"pageType\": \"Community\",\n \"pageSubType\": \"Challenge\",\n \"status\": \"published\",\n \"visibility\": \"public\",\n \"templateId\": \"challenge-starter\",\n \"sections\": [\n {\n \"id\": \"id_demo_001\",\n \"type\": \"hero\",\n \"title\": \"Challenge accepted\"\n },\n {\n \"id\": \"id_demo_001\",\n \"type\": \"cta\",\n \"title\": \"Join the challenge\"\n }\n ],\n \"leadCapture\": {\n \"enabled\": true,\n \"email\": {\n \"enabled\": true,\n \"label\": \"Email address\",\n \"placeholder\": \"Enter your email\",\n \"consentText\": \"By subscribing you agree to receive updates.\"\n },\n \"sms\": {\n \"enabled\": true,\n \"label\": \"Mobile number\",\n \"placeholder\": \"Enter your mobile number\",\n \"consentText\": \"I agree to receive SMS updates related to this page.\"\n },\n \"social\": {\n \"enabled\": true,\n \"label\": \"Social handle\",\n \"placeholder\": \"Instagram @handle\"\n }\n },\n \"audienceChoice\": {\n \"enabled\": true,\n \"options\": [\n \"Blue Team\",\n \"Gold Team\"\n ],\n \"collectEmail\": \"developer@example.invalid\",\n \"showResults\": false\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 \"title\": \"Beladed Challenge Hub\",\n \"name\": \"Beladed Challenge Hub\",\n \"headline\": \"Vote for your side\",\n \"description\": \"A test Pages payload for community voting and signup.\",\n \"pageType\": \"Community\",\n \"pageSubType\": \"Challenge\",\n \"status\": \"published\",\n \"visibility\": \"public\",\n \"templateId\": \"challenge-starter\",\n \"sections\": [\n {\n \"id\": \"id_demo_001\",\n \"type\": \"hero\",\n \"title\": \"Challenge accepted\"\n },\n {\n \"id\": \"id_demo_001\",\n \"type\": \"cta\",\n \"title\": \"Join the challenge\"\n }\n ],\n \"leadCapture\": {\n \"enabled\": true,\n \"email\": {\n \"enabled\": true,\n \"label\": \"Email address\",\n \"placeholder\": \"Enter your email\",\n \"consentText\": \"By subscribing you agree to receive updates.\"\n },\n \"sms\": {\n \"enabled\": true,\n \"label\": \"Mobile number\",\n \"placeholder\": \"Enter your mobile number\",\n \"consentText\": \"I agree to receive SMS updates related to this page.\"\n },\n \"social\": {\n \"enabled\": true,\n \"label\": \"Social handle\",\n \"placeholder\": \"Instagram @handle\"\n }\n },\n \"audienceChoice\": {\n \"enabled\": true,\n \"options\": [\n \"Blue Team\",\n \"Gold Team\"\n ],\n \"collectEmail\": \"developer@example.invalid\",\n \"showResults\": false\n }\n}")
request, err := http.NewRequest("POST", "https://api.beladed.dev/api/pages/general/create", 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/pages/general/create");
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 \"title\": \"Beladed Challenge Hub\",\n \"name\": \"Beladed Challenge Hub\",\n \"headline\": \"Vote for your side\",\n \"description\": \"A test Pages payload for community voting and signup.\",\n \"pageType\": \"Community\",\n \"pageSubType\": \"Challenge\",\n \"status\": \"published\",\n \"visibility\": \"public\",\n \"templateId\": \"challenge-starter\",\n \"sections\": [\n {\n \"id\": \"id_demo_001\",\n \"type\": \"hero\",\n \"title\": \"Challenge accepted\"\n },\n {\n \"id\": \"id_demo_001\",\n \"type\": \"cta\",\n \"title\": \"Join the challenge\"\n }\n ],\n \"leadCapture\": {\n \"enabled\": true,\n \"email\": {\n \"enabled\": true,\n \"label\": \"Email address\",\n \"placeholder\": \"Enter your email\",\n \"consentText\": \"By subscribing you agree to receive updates.\"\n },\n \"sms\": {\n \"enabled\": true,\n \"label\": \"Mobile number\",\n \"placeholder\": \"Enter your mobile number\",\n \"consentText\": \"I agree to receive SMS updates related to this page.\"\n },\n \"social\": {\n \"enabled\": true,\n \"label\": \"Social handle\",\n \"placeholder\": \"Instagram @handle\"\n }\n },\n \"audienceChoice\": {\n \"enabled\": true,\n \"options\": [\n \"Blue Team\",\n \"Gold Team\"\n ],\n \"collectEmail\": \"developer@example.invalid\",\n \"showResults\": false\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/pages/general/create")!)
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 \"title\": \"Beladed Challenge Hub\",\n \"name\": \"Beladed Challenge Hub\",\n \"headline\": \"Vote for your side\",\n \"description\": \"A test Pages payload for community voting and signup.\",\n \"pageType\": \"Community\",\n \"pageSubType\": \"Challenge\",\n \"status\": \"published\",\n \"visibility\": \"public\",\n \"templateId\": \"challenge-starter\",\n \"sections\": [\n {\n \"id\": \"id_demo_001\",\n \"type\": \"hero\",\n \"title\": \"Challenge accepted\"\n },\n {\n \"id\": \"id_demo_001\",\n \"type\": \"cta\",\n \"title\": \"Join the challenge\"\n }\n ],\n \"leadCapture\": {\n \"enabled\": true,\n \"email\": {\n \"enabled\": true,\n \"label\": \"Email address\",\n \"placeholder\": \"Enter your email\",\n \"consentText\": \"By subscribing you agree to receive updates.\"\n },\n \"sms\": {\n \"enabled\": true,\n \"label\": \"Mobile number\",\n \"placeholder\": \"Enter your mobile number\",\n \"consentText\": \"I agree to receive SMS updates related to this page.\"\n },\n \"social\": {\n \"enabled\": true,\n \"label\": \"Social handle\",\n \"placeholder\": \"Instagram @handle\"\n }\n },\n \"audienceChoice\": {\n \"enabled\": true,\n \"options\": [\n \"Blue Team\",\n \"Gold Team\"\n ],\n \"collectEmail\": \"developer@example.invalid\",\n \"showResults\": false\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/pages/general/create")
.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 \"title\": \"Beladed Challenge Hub\",\n \"name\": \"Beladed Challenge Hub\",\n \"headline\": \"Vote for your side\",\n \"description\": \"A test Pages payload for community voting and signup.\",\n \"pageType\": \"Community\",\n \"pageSubType\": \"Challenge\",\n \"status\": \"published\",\n \"visibility\": \"public\",\n \"templateId\": \"challenge-starter\",\n \"sections\": [\n {\n \"id\": \"id_demo_001\",\n \"type\": \"hero\",\n \"title\": \"Challenge accepted\"\n },\n {\n \"id\": \"id_demo_001\",\n \"type\": \"cta\",\n \"title\": \"Join the challenge\"\n }\n ],\n \"leadCapture\": {\n \"enabled\": true,\n \"email\": {\n \"enabled\": true,\n \"label\": \"Email address\",\n \"placeholder\": \"Enter your email\",\n \"consentText\": \"By subscribing you agree to receive updates.\"\n },\n \"sms\": {\n \"enabled\": true,\n \"label\": \"Mobile number\",\n \"placeholder\": \"Enter your mobile number\",\n \"consentText\": \"I agree to receive SMS updates related to this page.\"\n },\n \"social\": {\n \"enabled\": true,\n \"label\": \"Social handle\",\n \"placeholder\": \"Instagram @handle\"\n }\n },\n \"audienceChoice\": {\n \"enabled\": true,\n \"options\": [\n \"Blue Team\",\n \"Gold Team\"\n ],\n \"collectEmail\": \"developer@example.invalid\",\n \"showResults\": false\n }\n}"))
.build()
val response = okhttp3.OkHttpClient().newCall(request).execute()
This operation has no documented parameters.
{
"type": "object",
"properties": {
"title": {
"type": "string"
},
"name": {
"type": "string"
},
"headline": {
"type": "string"
},
"description": {
"type": "string"
},
"pageType": {
"type": "string"
},
"pageSubType": {
"type": "string"
},
"status": {
"type": "string"
},
"visibility": {
"type": "string"
},
"templateId": {
"type": "string"
},
"sections": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string"
},
"title": {
"type": "string"
}
}
}
},
"leadCapture": {
"type": "object",
"properties": {
"enabled": {
"type": "boolean"
},
"email": {
"type": "object",
"properties": {
"enabled": {
"type": "boolean"
},
"label": {
"type": "string"
},
"placeholder": {
"type": "string"
},
"consentText": {
"type": "string"
}
}
},
"sms": {
"type": "object",
"properties": {
"enabled": {
"type": "boolean"
},
"label": {
"type": "string"
},
"placeholder": {
"type": "string"
},
"consentText": {
"type": "string"
}
}
},
"social": {
"type": "object",
"properties": {
"enabled": {
"type": "boolean"
},
"label": {
"type": "string"
},
"placeholder": {
"type": "string"
}
}
}
}
},
"audienceChoice": {
"type": "object",
"properties": {
"enabled": {
"type": "boolean"
},
"options": {
"type": "array",
"items": {
"type": "string"
}
},
"collectEmail": {
"type": "string"
},
"showResults": {
"type": "boolean"
}
}
}
}
}{
"title": "Beladed Challenge Hub",
"name": "Beladed Challenge Hub",
"headline": "Vote for your side",
"description": "A test Pages payload for community voting and signup.",
"pageType": "Community",
"pageSubType": "Challenge",
"status": "published",
"visibility": "public",
"templateId": "challenge-starter",
"sections": [
{
"id": "id_demo_001",
"type": "hero",
"title": "Challenge accepted"
},
{
"id": "id_demo_001",
"type": "cta",
"title": "Join the challenge"
}
],
"leadCapture": {
"enabled": true,
"email": {
"enabled": true,
"label": "Email address",
"placeholder": "Enter your email",
"consentText": "By subscribing you agree to receive updates."
},
"sms": {
"enabled": true,
"label": "Mobile number",
"placeholder": "Enter your mobile number",
"consentText": "I agree to receive SMS updates related to this page."
},
"social": {
"enabled": true,
"label": "Social handle",
"placeholder": "Instagram @handle"
}
},
"audienceChoice": {
"enabled": true,
"options": [
"Blue Team",
"Gold Team"
],
"collectEmail": "developer@example.invalid",
"showResults": false
}
}
{
"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.