Skip to content
Updawg

The host's timeline, newest first: jobs finishing, refused or expiring, and the host going stale and coming back. What a person did *to* the host — relabelling, decommissioning — is the audit log's, filtered by target.

GET
/v1/orgs/{org}/hosts/{host_id}/events
curl --request GET \
  --url https://api.updawg.net/v1/orgs/example/hosts/example/events

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
org
required
string

Organization slug.

host_id
required
string

The hst_… id.

Query Parameters

Section titled “Query Parameters”
after
string

The next of the previous page.

Responses

Section titled “Responses”

200

Section titled “200”

A page of the timeline, newest first.

Media typeapplication/json
object
events
required
Array<object>
object
at
required
string format: date-time
data
required

What the event recorded. A job’s events carry job (job_…); a finished one also status, changes and error.

object
key
additional properties
One of:
string
id
required
string
kind
required

job_finished, rejected_by_host, job_expired, went_stale, recovered — or something newer, passed through as stored.

string
next

Pass as ?after= for the next page. Absent at the end. Opaque.

string | null
Examplegenerated
{
  "events": [
    {
      "at": "2026-04-15T12:00:00Z",
      "data": {
        "additionalProperty": {
          "additionalProperty": {}
        }
      },
      "id": "example",
      "kind": "example"
    }
  ],
  "next": "example"
}

400

Section titled “400”

An unknown parameter, a repeated one, or a cursor that does not parse.

Media typeapplication/json
object
detail
string | null
status
required
integer format: int32
title
required
string
type
required
string
Examplegenerated
{
  "detail": "example",
  "status": 1,
  "title": "example",
  "type": "example"
}

401

Section titled “401”

No session.

Media typeapplication/json
object
detail
string | null
status
required
integer format: int32
title
required
string
type
required
string
Examplegenerated
{
  "detail": "example",
  "status": 1,
  "title": "example",
  "type": "example"
}

403

Section titled “403”

Not permitted.

Media typeapplication/json
object
detail
string | null
status
required
integer format: int32
title
required
string
type
required
string
Examplegenerated
{
  "detail": "example",
  "status": 1,
  "title": "example",
  "type": "example"
}

404

Section titled “404”

No such host, or not yours.

Media typeapplication/json
object
detail
string | null
status
required
integer format: int32
title
required
string
type
required
string
Examplegenerated
{
  "detail": "example",
  "status": 1,
  "title": "example",
  "type": "example"
}

429

Section titled “429”

Over the organization’s request limit. Retry-After says when to try again; RateLimit-Limit is the burst.

Media typeapplication/json
object
detail
string | null
status
required
integer format: int32
title
required
string
type
required
string
Examplegenerated
{
  "detail": "example",
  "status": 1,
  "title": "example",
  "type": "example"
}