Dispatch

All Sections

Domains API Reference

Content

    Endpoints

    dispatch.all.readdispatch.all.readwrite

    Find all Domains.

    Query parameters

    pageTokenOptional
    string

    Specifies the page to read. Use a value provided by earlier responses in pageToken and nextPageToken.

    Example: eyJmaXJzdCI6InBhZ2UifQ==

    limitOptional
    integer
    1 - 100 (Default: 50)

    Limit the return page size to the specified count.

    Example: 1

    Responses

    200application/json

    A PagedList of Domains

    Example response body
    {
    "count": 1,
    "pageToken": "eyJmaXJzdCI6InBhZ2UifQ==",
    "nextPageToken": "eyJzZWNvbmQiOiJwYWdlIn0=",
    "items": [
    {
    "id": "DI-D-3f0d067002",
    "domainName": "www.example.com",
    "verificationCode": "0adb28c65ae14a1586a8e98525bb0896",
    "verificationStatus": "VERIFIED",
    "createdAt": "2020-04-26T09:44:23.065Z"
    }
    ]
    }
    <<No Content

    dispatch.all.readwrite

    Add a Domain. Domains need to be verified in order to be used by webhook targets.

    Request body

    domainNameRequired
    string

    The name of the Domain

    Example: www.example.com

    Responses

    200application/json

    A Domain

    Example response body
    {
    "id": "DI-D-3f0d067002,",
    "domainName": "www.example.com,",
    "verificationCode": "0adb28c65ae14a1586a8e98525bb0896,",
    "verificationStatus": "NOT_VERIFIED",
    "createdAt": "2020-04-26T09:44:23.065Z"
    }
    <<No Content

    Error codes

    E-DI-4002

    Domain name already in use

    dispatch.all.readdispatch.all.readwrite

    Path parameters

    domainId
    string

    A Domain ID

    Example: DI-D-3f0d067002

    Responses

    200application/json

    A Domain

    Example response body
    {
    "id": "DI-D-3f0d067002,",
    "domainName": "www.example.com,",
    "verificationCode": "0adb28c65ae14a1586a8e98525bb0896,",
    "verificationStatus": "VERIFIED",
    "createdAt": "2020-04-26T09:44:23.065Z"
    }
    404No Content

    The Domain was not found.

    <<No Content

    dispatch.all.readwrite

    Path parameters

    domainId
    string

    A Domain ID

    Example: DI-D-3f0d067002

    Responses

    200No Content

    The domain was deleted succesfully

    404No Content

    The Domain was not found.

    <<No Content

    Error codes

    E-DI-4004

    Domain has been marked as deleted

    E-DI-4005

    The domain is still in use by targets

    dispatch.all.readwrite

    Verify the ownership of a domain Domain. You can read more about the domain verification process in Configuring Webhook targets.

    Path parameters

    domainId
    string

    A Domain ID

    Example: DI-D-3f0d067002

    Responses

    200application/json

    The Domain was verified sucessfully

    Example response body
    {
    "id": "DI-D-3f0d067002,",
    "domainName": "www.example.com,",
    "verificationCode": "0adb28c65ae14a1586a8e98525bb0896,",
    "verificationStatus": "VERIFIED",
    "createdAt": "2020-04-26T09:44:23.065Z"
    }
    <<No Content

    Error codes

    E-DI-4011

    Unable to resolve domain

    E-DI-4012

    Unable to find matching TXT record on domain

    E-DI-4020

    Unknown error

    E-DI-4021

    The file content did not match the expected value

    E-DI-4022

    Unexpected HTTP status

    E-DI-4023

    Unable to connect to the host

    Models

    A paged list of items. Use the nextPageToken in follow-up requests to step through all available items. nextPageToken will be null on the last page.

    items
    array

    A list of items

    count
    integer

    The number of items in the list

    pageToken
    string

    The token for the current page

    nextPageToken
    string | NULL

    The token for the next page

    A domain

    id
    string

    The Domain ID

    domainName
    string

    The name of the Domain

    createdAt
    string
    ISO-8601 Date & Time

    The time the Domain was created

    verificationCode
    string

    The code used to verify the Domain

    verificationStatus
    string
    VERIFIED
    NOT_VERIFIED

    A container for a list of Error objects

    errors
    array

    An array of Error objects

    An error object

    code
    string

    The error code

    message
    string

    A descriptive error message