API documentation

Bulk create protection resources

Processes up to 100 items independently. Every item receives `created`, `already_exists`, `invalid`, `not_found`, `limit_reached` or `failed`.

POST/v1/protection-resources/bulk
POSTBulk create protection resources
curl -X POST "https://api.darkradar.com/api/public/v1/protection-resources/bulk" \
  -H "x-api-key: $DARKRADAR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"resources":[{"groupId":"64b1f0c2a9e4d21f8c3b9a10","resourceType":"domain","targetValue":"darkradar.com"}]}'
Response

Success

{
  "success": true,
  "message": "OK",
  "data": {
    "results": [
      {
        "index": 0,
        "status": "created",
        "resource": {
          "_id": "64b1f0c2a9e4d21f8c3b9a11",
          "resourceType": "domain",
          "targetValue": "darkradar.com"
        }
      }
    ],
    "summary": {
      "created": 1
    }
  }
}

Access

Scopeprotection-resources:write
Plan entitlementapi_access

Request body

FieldsValues
resources · object[] · required1–100 protection resources; same fields as single create

Responses

200Success
400Invalid request (malformed id, missing or invalid field)
401Key missing, invalid, expired or revoked
403Insufficient scope, no API access in plan, or product not enabled
404Record not found or not owned by this key’s firm
408The request exceeded its maximum response time
429Rate limit exceeded; retry after a minute

Response limits

Rate limit500 requests per 15 min · per IP

Was this page helpful?