API reference

Log export

Send a project's or team's logs to your endpoint over HTTPS or syslog over TLS. Pro feature.

GET/v1/drains

The team's log exports#

Credential: An API key or a dashboard session
Roles: owner, admin, developer

Parameters

projectstringquery
only this project's

Response

200object

drainsDrain[]
- idstring (uuid)
- namestring
- kindstring
  one of https, syslog
- urlstring
- projectobject | null
- sourcesstring[]
- levelsstring[]
- sampling_pctinteger
- gzipboolean
- header_namesstring[]
- signing_secret_hintstring | null
- enabledboolean
- disabled_reasonstring | null
- created_atstring (date-time)
- healthobject
limitinteger
planstring
sourcesstring[]
levelsstring[]

Errors

Status	Description
401	`unauthorized`: missing, invalid, expired or revoked credential
403	Not allowed: `forbidden`
500	`internal`: an unexpected failure

Example

curl "https://api.ibel.ai/v1/drains" \
  -H "Authorization: Bearer $KEY"

POST/v1/drains

Create a log export (the signing secret is shown once)#

Credential: An API key or a dashboard session
Roles: owner, admin

Request body`application/json`

namestringrequired
kindstringrequired
one of https, syslog
urlstringrequired
https://… or syslog+tls://host:port
projectstring
sourcesstring[]
levelsstring[]
sampling_pctinteger
1–100
gzipboolean
headersmap of string
up to 5 custom headers (https only); values are never shown again

Response

200Drain

idstring (uuid)
namestring
kindstring
one of https, syslog
urlstring
projectobject | null
- namestring
- kindstring
sourcesstring[]
levelsstring[]
sampling_pctinteger
gzipboolean
header_namesstring[]
signing_secret_hintstring | null
enabledboolean
disabled_reasonstring | null
created_atstring (date-time)
healthobject
- statestring
  one of waiting, healthy, failing, disabled
- lines_sentinteger
- batches_sentinteger
- bytes_sentinteger
- last_success_atstring (date-time) | null
- last_errorstring | null
- last_error_atstring (date-time) | null
- consecutive_failuresinteger
signing_secretstring

Errors

Status	Description
400	Bad request: `bad_name`, `bad_kind`, `bad_url`, `bad_sources`, `bad_levels`, `bad_sampling`, `bad_headers`, `bad_gzip`
401	`unauthorized`: missing, invalid, expired or revoked credential
403	Not allowed: `forbidden`, `plan_required` (Pro), `limit_reached`
404	Not found: `not_found`
500	`internal`: an unexpected failure

Example

curl -X POST "https://api.ibel.ai/v1/drains" \
  -H "Authorization: Bearer $KEY" \
  -d '{"name":"my-api","kind":"https","url":"…"}'

GET/v1/drains/{id}

One log export#

Credential: An API key or a dashboard session
Roles: owner, admin, developer

Parameters

idstringpathrequired
log export id

Response

200Drain

idstring (uuid)
namestring
kindstring
one of https, syslog
urlstring
projectobject | null
- namestring
- kindstring
sourcesstring[]
levelsstring[]
sampling_pctinteger
gzipboolean
header_namesstring[]
signing_secret_hintstring | null
enabledboolean
disabled_reasonstring | null
created_atstring (date-time)
healthobject
- statestring
  one of waiting, healthy, failing, disabled
- lines_sentinteger
- batches_sentinteger
- bytes_sentinteger
- last_success_atstring (date-time) | null
- last_errorstring | null
- last_error_atstring (date-time) | null
- consecutive_failuresinteger

Errors

Status	Description
401	`unauthorized`: missing, invalid, expired or revoked credential
403	Not allowed: `forbidden`
404	Not found: `not_found`
500	`internal`: an unexpected failure

Example

curl "https://api.ibel.ai/v1/drains/88e2fe1d-6d75-4de5-8c8f-27380ec66903" \
  -H "Authorization: Bearer $KEY"

DELETE/v1/drains/{id}

Delete a log export#

Credential: An API key or a dashboard session
Roles: owner, admin

Parameters

idstringpathrequired
log export id

Response

200object

deletedboolean

Errors

Status	Description
401	`unauthorized`: missing, invalid, expired or revoked credential
403	Not allowed: `forbidden`
404	Not found: `not_found`
500	`internal`: an unexpected failure

Example

curl -X DELETE "https://api.ibel.ai/v1/drains/88e2fe1d-6d75-4de5-8c8f-27380ec66903" \
  -H "Authorization: Bearer $KEY"

PATCH/v1/drains/{id}

Change a log export or re-enable it#

Credential: An API key or a dashboard session
Roles: owner, admin

Parameters

idstringpathrequired
log export id

Request body`application/json`

namestring
urlstring
sourcesstring[]
levelsstring[]
sampling_pctinteger
gzipboolean
headersmap of string
enabledboolean

Response

200Drain

idstring (uuid)
namestring
kindstring
one of https, syslog
urlstring
projectobject | null
- namestring
- kindstring
sourcesstring[]
levelsstring[]
sampling_pctinteger
gzipboolean
header_namesstring[]
signing_secret_hintstring | null
enabledboolean
disabled_reasonstring | null
created_atstring (date-time)
healthobject
- statestring
  one of waiting, healthy, failing, disabled
- lines_sentinteger
- batches_sentinteger
- bytes_sentinteger
- last_success_atstring (date-time) | null
- last_errorstring | null
- last_error_atstring (date-time) | null
- consecutive_failuresinteger

Errors

Status	Description
400	Bad request: `bad_url`, `bad_sources`, `bad_levels`, `bad_sampling`, `bad_headers`, `bad_enabled`, `nothing_to_change`
401	`unauthorized`: missing, invalid, expired or revoked credential
403	Not allowed: `forbidden`
404	Not found: `not_found`
500	`internal`: an unexpected failure

Example

curl -X PATCH "https://api.ibel.ai/v1/drains/88e2fe1d-6d75-4de5-8c8f-27380ec66903" \
  -H "Authorization: Bearer $KEY" \
  -d '{"name":"my-api","url":"…","sources":["…"],"levels":["…"],"sampling_pct":1,"gzip":true,"headers":{"KEY":"s3cr3t"},"enabled":true}'

POST/v1/drains/{id}/rotate-secret

A new signing secret (https, shown once)#

Credential: An API key or a dashboard session
Roles: owner, admin

Parameters

idstringpathrequired
log export id

Response

200Drain

idstring (uuid)
namestring
kindstring
one of https, syslog
urlstring
projectobject | null
- namestring
- kindstring
sourcesstring[]
levelsstring[]
sampling_pctinteger
gzipboolean
header_namesstring[]
signing_secret_hintstring | null
enabledboolean
disabled_reasonstring | null
created_atstring (date-time)
healthobject
- statestring
  one of waiting, healthy, failing, disabled
- lines_sentinteger
- batches_sentinteger
- bytes_sentinteger
- last_success_atstring (date-time) | null
- last_errorstring | null
- last_error_atstring (date-time) | null
- consecutive_failuresinteger
signing_secretstring

Errors

Status	Description
401	`unauthorized`: missing, invalid, expired or revoked credential
403	Not allowed: `forbidden`
404	Not found: `not_found`
500	`internal`: an unexpected failure

Example

curl -X POST "https://api.ibel.ai/v1/drains/88e2fe1d-6d75-4de5-8c8f-27380ec66903/rotate-secret" \
  -H "Authorization: Bearer $KEY"

POST/v1/drains/{id}/test

Send one sample line now#

Credential: An API key or a dashboard session
Roles: owner, admin

Parameters

idstringpathrequired
log export id

Response

200object

okboolean
statusinteger | null
duration_msinteger
errorstring

Errors

Status	Description
401	`unauthorized`: missing, invalid, expired or revoked credential
403	Not allowed: `forbidden`
404	Not found: `not_found`
500	`internal`: an unexpected failure

Example

curl -X POST "https://api.ibel.ai/v1/drains/88e2fe1d-6d75-4de5-8c8f-27380ec66903/test" \
  -H "Authorization: Bearer $KEY"

GET/v1/drains/{id}/health

Delivery health and the newest sends#

Credential: An API key or a dashboard session
Roles: owner, admin, developer

Parameters

idstringpathrequired
log export id
limitintegerquery
1 to 200

Response

200Drain

idstring (uuid)
namestring
kindstring
one of https, syslog
urlstring
projectobject | null
- namestring
- kindstring
sourcesstring[]
levelsstring[]
sampling_pctinteger
gzipboolean
header_namesstring[]
signing_secret_hintstring | null
enabledboolean
disabled_reasonstring | null
created_atstring (date-time)
healthobject
- statestring
  one of waiting, healthy, failing, disabled
- lines_sentinteger
- batches_sentinteger
- bytes_sentinteger
- last_success_atstring (date-time) | null
- last_errorstring | null
- last_error_atstring (date-time) | null
- consecutive_failuresinteger
last_24hobject
- batches_okinteger
- batches_failedinteger
- linesinteger
batchesobject[]
- idinteger
- atstring (date-time)
- linesinteger
- bytesinteger
- okboolean
- http_statusinteger | null
- errorstring | null
- msinteger | null

Errors

Status	Description
401	`unauthorized`: missing, invalid, expired or revoked credential
403	Not allowed: `forbidden`
404	Not found: `not_found`
500	`internal`: an unexpected failure

Example

curl "https://api.ibel.ai/v1/drains/88e2fe1d-6d75-4de5-8c8f-27380ec66903/health" \
  -H "Authorization: Bearer $KEY"

The team's log exports#

Parameters

Response

Errors

Example

Create a log export (the signing secret is shown once)#

Request bodyapplication/json

Response

Errors

Example

One log export#

Parameters

Response

Errors

Example

Delete a log export#

Parameters

Response

Errors

Example

Change a log export or re-enable it#

Parameters

Request bodyapplication/json

Response

Errors

Example

A new signing secret (https, shown once)#

Parameters

Response

Errors

Example

Send one sample line now#

Parameters

Response

Errors

Example

Delivery health and the newest sends#

Parameters

Response

Errors

Example

Request body`application/json`

Request body`application/json`