{
  "id": null,
  "code": 400,
  "error": "bad_request",
  "detail": "Unknown content type path: 'fake:path'",
  "doc_url": "https://developers.lighton.ai/errors#bad_request"
}

{
  "id": null,
  "code": 422,
  "error": "validation_error",
  "detail": "One or more fields failed validation.",
  "doc_url": "https://developers.lighton.ai/errors#validation_error",
  "fields": {
    "name": [
      {"error": "required", "detail": "Field required"}
    ],
    "attribute_type": [
      {"error": "invalid_choice", "detail": "Input should be 'text', 'number', 'date', 'boolean', 'select' or 'multi-select'"}
    ]
  }
}

{
  "id": null,
  "code": 400,
  "error": "content_type_unknown",
  "detail": "Unknown content type path: 'fake:path'.",
  "doc_url": "https://developers.lighton.ai/errors#content_type_unknown",
  "index": 2
}

{"error": "bad_request", "detail": "Unknown content type path: 'fake:path'"}

{"error": "unauthorized", "detail": "Authentication credentials were not provided."}

{"error": "email_verification_required", "detail": "Please verify your email address to access this feature."}

{"error": "insufficient_permissions", "detail": "You do not have permission to perform this action."}

{"error": "not_found", "detail": "Document not found."}

{"error": "conflict", "detail": "A resource with this name already exists."}

{"error": "payload_too_large", "detail": "File size (157286400 bytes) exceeds the 100MB async limit."}

{
  "error": "content_filtered",
  "fields": {
    "query": [{"error": "content_filtered", "detail": "The model refused to generate an answer or a safety filter was triggered."}]
  }
}

{
  "error": "context_length_exceeded",
  "fields": {
    "query": [{"error": "context_length_exceeded", "detail": "Query + retrieved context exceeds the model's context window."}]
  }
}

{
  "error": "validation_error",
  "fields": {
    "content_type_path": [{"error": "required", "detail": "Field required"}],
    "choices": [{"error": "invalid", "detail": "'choices' must be a non-empty list for select/multi-select attributes."}]
  }
}

{"error": "too_many_requests", "detail": "Too many requests. Please try again later."}

{"error": "internal_server_error", "detail": "An unexpected error occurred. Please try again later."}

{"error": "model_unavailable", "detail": "The requested model is currently unavailable."}

{"error": "model_timeout", "detail": "The model did not respond within the allowed time."}

import requests

try:
    response = requests.post(
        "https://your-instance.lighton.ai/api/v3/content-types",
        headers={"Authorization": f"Bearer {api_key}"},
        json={"action": "define_attribute"},
    )

    if not response.ok:
        error = response.json()

        # Batch requests include the 0-based action index that failed
        if "index" in error:
            print(f"  Failed at batch action #{error['index']}")

        if error["error"] == "validation_error" and "fields" in error:
            # Per-field errors — collect for form display or logging
            for field, errors in error["fields"].items():
                for entry in errors:
                    print(f"  {field}: [{entry['error']}] {entry['detail']}")
        else:
            # Domain error (e.g. attribute_type_immutable, content_type_not_found)
            print(f"Error {error['code']}: [{error['error']}] {error['detail']}")
except requests.RequestException as exc:
    print(f"Network error: {exc}")