API Errors

{
  "id": null,
  "code": 400,
  "error": "bad_request",
  "detail": "file_id cannot be combined with workspace_id or tag_id.",
  "doc_url": "https://developers.context212.com/errors#bad_request"
}

{
  "id": null,
  "code": 422,
  "error": "validation_error",
  "detail": "One or more fields failed validation.",
  "doc_url": "https://developers.context212.com/errors#validation_error",
  "fields": {
    "name": [
      {"error": "required", "detail": "Field required"}
    ],
    "max_results": [
      {"error": "too_large", "detail": "Input should be less than or equal to 50"}
    ]
  }
}

{
  "id": null,
  "code": 400,
  "error": "bad_request",
  "detail": "The requested action is invalid.",
  "doc_url": "https://developers.context212.com/errors#bad_request",
  "index": 2
}

try {
  const response = await fetch(
    "https://your-instance.context212.com/api/v1/search",
    {
      method: "POST",
      headers: {
        Authorization: `Bearer ${apiKey}`,
        "Content-Type": "application/json",
      },
      body: JSON.stringify({ query: "quarterly revenue" }),
    },
  );

  if (!response.ok) {
    const error = await response.json();

    // Batch requests include the 0-based action index that failed
    if ("index" in error) {
      console.log(`  Failed at batch action #${error.index}`);
    }

    if (error.error === "validation_error" && error.fields) {
      // Per-field errors — collect for form display or logging
      for (const [field, errors] of Object.entries(error.fields) as [string, { error: string; detail: string }[]][]) {
        for (const entry of errors) {
          console.log(`  ${field}: [${entry.error}] ${entry.detail}`);
        }
      }
    } else {
      // Domain error (e.g. bad_request, not_found)
      console.log(`Error ${error.code}: [${error.error}] ${error.detail}`);
    }
  }
} catch (exc) {
  console.log(`Network error: ${exc}`);
}