Skip to content
Updawg

`GET /v1/orgs/{org}/enrollment-tokens`.

GET
/v1/orgs/{org}/enrollment-tokens
curl --request GET \
  --url https://api.updawg.net/v1/orgs/example/enrollment-tokens

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
org
required
string

Organization slug.

Responses

Section titled “Responses”

200

Section titled “200”

Every token, newest first, revoked and used-up ones included — the list is also the answer to “what could have enrolled that host”.

Media typeapplication/json
Array<object>

A token as a list shows it: everything but the value.

object
created_at
required
string format: date-time
expires_at
string | null format: date-time
id
required

etk_…. The record, not the credential.

string
labels
required
object
key
additional properties
string
max_uses
integer | null format: int32
name
required
string
revoked_at
string | null format: date-time
usable
required

Whether an agent presenting it now would be let in: not revoked, not expired, not used up. The same three conditions the gateway checks, so the portal does not have to know them.

boolean
uses
required

Hosts that enrolled with it and then checked in. A use is charged on the first check-in, not when the certificate is issued, so an attempt the agent refused costs nothing (DAWG-224).

integer format: int32
Examplegenerated
[
  {
    "created_at": "2026-04-15T12:00:00Z",
    "expires_at": "2026-04-15T12:00:00Z",
    "id": "example",
    "labels": {
      "additionalProperty": "example"
    },
    "max_uses": 1,
    "name": "example",
    "revoked_at": "2026-04-15T12:00:00Z",
    "usable": true,
    "uses": 1
  }
]

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 for this role.

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 organization, or not yours — one answer for both.

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"
}