Errors

The neuroflash API uses standard HTTP status codes and returns structured error responses.

HTTP Status Codes

Status Code	Meaning
200	OK — Request succeeded
201	Created — Resource was created
204	No Content — Request succeeded with no response body
400	Bad Request — Invalid request parameters or body
401	Unauthorized — Missing or invalid access token
403	Forbidden — Insufficient permissions or limit reached
404	Not Found — Resource does not exist
422	Unprocessable Entity — Validation error
429	Too Many Requests — Rate limit or quota exceeded
500	Internal Server Error — Something went wrong on our end

Error Response Format

Error responses include an error field with a human-readable message and, where applicable, a code field for programmatic error handling:

{
  "error": "Target audience limit reached for this workspace",
  "code": "TARGET_AUDIENCE_LIMIT_REACHED"
}

Validation Errors

Some endpoints return detailed validation errors with field-level information:

{
  "errors": [
    {
      "field": "name",
      "message": "must be between 3 and 100 characters",
      "type": "validation"
    }
  ]
}

Common Error Codes

Code	Description
TARGET_AUDIENCE_LIMIT_REACHED	Workspace has reached its target audience creation limit
MAX_BRAND_VOICES_REACHED	Workspace has reached its brand voice creation limit

Handling Errors

cURL

# Example: handle error responses
response=$(curl -s -w "\n%{http_code}" -X POST \
  "https://app.neuroflash.com/api/audience-service/v1/workspaces/{workspace_id}/target-audiences" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "My Audience"}')

http_code=$(echo "$response" | tail -1)
body=$(echo "$response" | sed '$d')

if [ "$http_code" -eq 201 ]; then
  echo "Created: $body"
else
  echo "Error $http_code: $body"
fi

Python

import requests

response = requests.post(
    "https://app.neuroflash.com/api/audience-service/v1/workspaces/{workspace_id}/target-audiences",
    headers={"Authorization": f"Bearer {token}"},
    json=payload,
)

if response.status_code == 201:
    audience = response.json()
    print(f"Created audience: {audience['id']}")
elif response.status_code == 403:
    error = response.json()
    if error.get("code") == "TARGET_AUDIENCE_LIMIT_REACHED":
        print("Upgrade your plan to create more audiences")
    else:
        print(f"Forbidden: {error['error']}")
else:
    print(f"Error {response.status_code}: {response.text}")

Node.js

const response = await fetch(
  `https://app.neuroflash.com/api/audience-service/v1/workspaces/${workspaceId}/target-audiences`,
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${token}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify(payload),
  }
);

if (response.ok) {
  const audience = await response.json();
  console.log(`Created audience: ${audience.id}`);
} else {
  const error = await response.json();
  console.error(`Error ${response.status}: ${error.error}`);
}

Go

req, _ := http.NewRequest("POST",
	"https://app.neuroflash.com/api/audience-service/v1/workspaces/"+workspaceID+"/target-audiences",
	bytes.NewReader(payload))
req.Header.Set("Authorization", "Bearer "+token)
req.Header.Set("Content-Type", "application/json")

resp, _ := http.DefaultClient.Do(req)
defer resp.Body.Close()

if resp.StatusCode == 201 {
	var audience struct {
		ID string `json:"id"`
	}
	json.NewDecoder(resp.Body).Decode(&audience)
	fmt.Printf("Created audience: %s\n", audience.ID)
} else {
	var apiErr struct {
		Error string `json:"error"`
		Code  string `json:"code"`
	}
	json.NewDecoder(resp.Body).Decode(&apiErr)
	fmt.Printf("Error %d: %s\n", resp.StatusCode, apiErr.Error)
}