Whitelisted sources

List whitelist sources

get

Get a list of whitelist resources

Query parameters

offsetintegerOptional

Pagination offset

limitinteger · min: 1 · max: 100Optional

Pagination limit

orderBystringOptional

Order the results by this field, in this direction

Example: createdAt:descPattern: ^[a-zA-Z0-9\_]+(:(asc|desc))?$

Responses

200

OK

application/json

get

/whitelisted-sources

HTTPcURLJavaScriptPython

GET /api/whitelisted-sources HTTP/1.1
Host: app.seedata.io
Accept: */*

200

OK

{
  "metadata": {
    "totalCount": 1,
    "offset": 1,
    "limit": 1
  },
  "items": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "type": "domain",
      "name": "text",
      "description": "text",
      "trustedDays": 1,
      "createdAt": "2025-12-14T07:00:23.295Z",
      "updatedAt": "2025-12-14T07:00:23.295Z",
      "createdByType": "text",
      "createdById": "text",
      "updatedByType": "text",
      "updatedById": "text",
      "settings": {
        "email": "[email protected]"
      }
    }
  ]
}

Create whitelist

post

Create a whitelist (trusted resource)

Body

application/json

A trusted resource (e.g. email, domain, IP)

idstring · uuidRead-onlyOptional

typestring · enumRequired

Type of trusted resource

Possible values:

namestringRequired

Friendly name of trusted resource

descriptionstring | nullableOptional

Freetext description of trusted resource

trustedDaysnumber | nullableOptional

Consider this resource trusted for this duration of time since the seed has been planted

createdAtstring · date-timeRead-onlyOptional

updatedAtstring · date-timeRead-onlyOptional

createdByTypestring | nullableRead-onlyOptional

createdByIdstring | nullableRead-onlyOptional

updatedByTypestring | nullableRead-onlyOptional

updatedByIdstring | nullableRead-onlyOptional

settingsany ofRequired

or

or

or

Responses

201

Created

application/json

post

/whitelisted-sources

HTTPcURLJavaScriptPython

POST /api/whitelisted-sources HTTP/1.1
Host: app.seedata.io
Content-Type: application/json
Accept: */*
Content-Length: 106

{
  "type": "domain",
  "name": "text",
  "description": "text",
  "trustedDays": 1,
  "settings": {
    "email": "[email protected]"
  }
}

201

Created

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "type": "domain",
  "name": "text",
  "description": "text",
  "trustedDays": 1,
  "createdAt": "2025-12-14T07:00:23.295Z",
  "updatedAt": "2025-12-14T07:00:23.295Z",
  "createdByType": "text",
  "createdById": "text",
  "updatedByType": "text",
  "updatedById": "text",
  "settings": {
    "email": "[email protected]"
  }
}

Get whitelist

get

Get a single whitelisted-source

Path parameters

whitelistIdstring · uuidRequired

Responses

200

OK

application/json

get

/whitelisted-sources/{whitelistId}

HTTPcURLJavaScriptPython

GET /api/whitelisted-sources/{whitelistId} HTTP/1.1
Host: app.seedata.io
Accept: */*

200

OK

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "type": "domain",
  "name": "text",
  "description": "text",
  "trustedDays": 1,
  "createdAt": "2025-12-14T07:00:23.295Z",
  "updatedAt": "2025-12-14T07:00:23.295Z",
  "createdByType": "text",
  "createdById": "text",
  "updatedByType": "text",
  "updatedById": "text",
  "settings": {
    "email": "[email protected]"
  }
}

Delete whitelist

delete

Delete a whitelist resource

Path parameters

whitelistIdstring · uuidRequired

Responses

204

No Content

delete

/whitelisted-sources/{whitelistId}

HTTPcURLJavaScriptPython

DELETE /api/whitelisted-sources/{whitelistId} HTTP/1.1
Host: app.seedata.io
Accept: */*

204

No Content

No content

Update whitelist

patch

Update a whitelisted-source

Path parameters

whitelistIdstring · uuidRequired

Body

application/json

statusstringOptional

Whitelisted-source description

trustedDaysnumberOptional

Number of days which this source will be whitelisted for

Responses

200

OK

application/json

patch

/whitelisted-sources/{whitelistId}

HTTPcURLJavaScriptPython

PATCH /api/whitelisted-sources/{whitelistId} HTTP/1.1
Host: app.seedata.io
Content-Type: application/json
Accept: */*
Content-Length: 33

{
  "status": "text",
  "trustedDays": 1
}

200

OK

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "type": "domain",
  "name": "text",
  "description": "text",
  "trustedDays": 1,
  "createdAt": "2025-12-14T07:00:23.295Z",
  "updatedAt": "2025-12-14T07:00:23.295Z",
  "createdByType": "text",
  "createdById": "text",
  "updatedByType": "text",
  "updatedById": "text",
  "settings": {
    "email": "[email protected]"
  }
}