Article Ingestion Report

Use this endpoint to check whether specific CMS-supplied articles were successfully ingested and published on Nextdoor.

Request

FieldTypeDescription
guidsarray of stringOne or more GUIDs previously provided in the guid field when you created raw articles.
{
  "guids": [
    "abc-123",
    "def-456",
    "... more GUID strings ..."
  ]
}

Successful Response – 200 OK

ElementTypeMeaning
guidstringThe GUID you asked about
successbooleantrue if the article’s post_id exists (i.e. the article is live); false otherwise
error_msgsarray of stringHuman-readable descriptions of validation errors when success is false (empty when success is true)
{
  "results": [
    {
      "guid": "abc-123",
      "success": true,
      "error_msgs": []
    },
    {
      "guid": "def-456",
      "success": false,
      "error_msgs": [
        "Title is missing",
        "Content failed validation"
      ]
    }
  ]
}

Error Responses

StatusWhen it happensBody
400 Bad Request• JSON cannot be parsed<br>• Body is not an object<br>• guids key missing or empty<br>• Endpoint has been temporarily disabled via kill-switch{"error": "bad_request", "error_description": "…details…" }
401 UnauthorizedThe caller’s access token is missing the openid scope (or token not supplied){"error": "unauthenticated", "error_description": "…details…" }
403 ForbiddenCaller lacks one of the required CMS API scopes{"error": "forbidden", "error_description": "insufficient_scope" }
429 Too Many RequestsRate limit exceeded (standard for all external APIs)Empty body or rate-limit message
5xx Server ErrorUnexpected server failureStandard JSON error envelope
Language
Credentials
OAuth2
Click Try It! to start a request and see the response here!