POST/destinations/{id}/test

Test a destination connection

Requires Bearer authentication. See Authentication.

Request body

No fields.

Responses

200 200

Field	Type	Description
`success`required	boolean	—
`httpStatusCode`required	number	—
`responseExcerpt`required	string	—
`errorMessage`required	string	—
`latencyMs`required	number	—

404 404

Field Type Description

errorrequired object —

`code`required	string	—
`message`required	string	—
`details`	any	—

Errors

Errors use the standard envelope. See Errors for codes, status mappings, and retry semantics.

Request

curl -X POST https://api.pushrail.io/destinations/{id}/test \
  -H "Authorization: Bearer pk_live_..." \
  -H "Content-Type: application/json" \
  -d '  {}'

Response · 200200

{
  "success": true,
  "httpStatusCode": 0,
  "responseExcerpt": "string",
  "errorMessage": "string",
  "latencyMs": 0
}

Response · 404404

{
  "error": {
    "code": "string",
    "message": "string",
    "details": null
  }
}