Retrieve Connection Warnings

Retrieve all active warnings for a connection, grouped by destination table. Each warning includes a code, message, error details, and creation timestamp.

Request schema

Path parameters

connectionId

stringrequired

The unique identifier of the connection. Retrieve it from the id field in the List All Connections response, or from the id field returned when you Create a Connection.

example:

4107c213907114059a5544ad8fa66c52

Header parameters

Authorization

stringrequired

HTTP: basicAuth

HTTP AuthorizationScheme: basic

string

default:

application/json;version=2

example:

application/json;version=2

Http + 1.1

GET

https://api.fivetran.com/v1/connections/4107c213907114059a5544ad8fa66c52/warnings

GET /v1/connections/4107c213907114059a5544ad8fa66c52/warnings HTTP/1.1
Accept: application/json;version=2
Authorization: Basic 
Host: api.fivetran.com

Responses

200

Successful response

401

Unauthorized error

404

Connection not found error

405

Method not allowed error

406

Not acceptable error

`200`

code

stringrequired

Response status code

example:

Success

message

string

Response status text

example:

Connection warnings retrieved successfully

data

objectrequired

items

arrayrequired

Array of warnings grouped by destination table

schema

string

The destination schema name. Omitted for warnings that are not scoped to a specific table.

example:

my_schema

table

string

The destination table name. Omitted for warnings that are not scoped to a specific table.

example:

my_table

warnings

arrayrequired

List of warnings for this table

code

stringrequired

A machine-readable identifier for the condition type. Use this value to programmatically detect and respond to specific connection conditions.

message

stringrequired

A human-readable label describing the condition. For example: Reconnect, Resync Table Warning.

error_message

string

Additional error details extracted from the warning

example:

Connection refused

created_at

stringrequired

ISO 8601 timestamp when the warning was created

format:

date-time

example:

2024-03-17T12:31:40.870504Z

next_cursor

string

Pagination cursor for the next page of results

example:

next_cursor_value

{
  "code": "Success",
  "message": "Connection warnings retrieved successfully",
  "data": {
    "items": [
      {
        "schema": "my_schema",
        "table": "my_table",
        "warnings": [
          {
            "code": "string",
            "message": "string",
            "error_message": "Connection refused",
            "created_at": "2024-03-17T12:31:40.870504Z"
          }
        ]
      }
    ],
    "next_cursor": "next_cursor_value"
  }
}