Auth

Poll device login

Changed on Jul 3, 2026

Polls a CLI device login until complete, pending, or expired.

get/v1/login/device/{device_code}

Request

Base URL
https://api.tovuk.com
Auth
HTTP bearer

Path parameters

device_codestring required

Example:zdev_0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef

Opaque device code returned by login start.

Response

Device login poll result.

status'pending' | 'complete' | 'expired' required

intervalSecondsinteger required

accountIdstring nullable required

emailstring email nullable required

provider'google' | 'github' | 'null' nullable required

tokenstring nullable required

expiresAtstring date-time nullable required

Example response

{
  "status": "pending",
  "intervalSeconds": 5,
  "accountId": null,
  "email": null,
  "provider": null,
  "token": "example",
  "expiresAt": "2026-06-23T12:00:00Z"
}

Changes

Jul 3, 20263f7925dc651d Revision changes
- breaking
  removed the required property from the response with the status
- warning
  added the new complete enum value to the response property for the response status
- info
  removed the authorized enum value from the response property for the response status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
Jun 5, 20263985c6090c91 Revision changes
- breaking
  for the path request parameter device_code, the maxLength was decreased from 512 to 128
- breaking
  for the path request parameter device_code, the minLength was increased from 0 to 1
- breaking
  the response property became nullable for the status
- breaking
  the response property became nullable for the status
- breaking
  the response property became nullable for the status
- breaking
  the response property became nullable for the status
- breaking
  the response property became optional for the status
- breaking
  the response property became optional for the status
- breaking
  the response property became optional for the status
- breaking
  the response property became optional for the status
- breaking
  the response property's maxLength was unset from 1000 for the response status
- breaking
  the response property's maxLength was unset from 1000 for the response status
- breaking
  the response property's maxLength was unset from 1000 for the response status
- breaking
  the response property's maxLength was unset from 1000 for the response status
- breaking
  the response property's maxLength was unset from 240 for the response status
- breaking
  the response property's maxLength was unset from 240 for the response status
- breaking
  the response property's maxLength was unset from 240 for the response status
- breaking
  the response property's maxLength was unset from 240 for the response status
- breaking
  the response property's maxLength was unset from 512 for the response status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- warning
  the optional response header Retry-After removed for the status 200
- warning
  the optional response header Retry-After removed for the status 400
- warning
  the optional response header Retry-After removed for the status 401
- warning
  the optional response header Retry-After removed for the status 500
- warning
  added the new authorized enum value to the response property for the response status
- info
  removed the complete enum value from the response property for the response status
- info
  removed the database_unavailable enum value from the response property for the response status
- info
  removed the database_unavailable enum value from the response property for the response status
- info
  removed the database_unavailable enum value from the response property for the response status
- info
  removed the database_unavailable enum value from the response property for the response status
- info
  removed the invalid_cpu_limit enum value from the response property for the response status
- info
  removed the invalid_cpu_limit enum value from the response property for the response status
- info
  removed the invalid_cpu_limit enum value from the response property for the response status
- info
  removed the invalid_cpu_limit enum value from the response property for the response status
- info
  removed the invalid_health_endpoint enum value from the response property for the response status
- info
  removed the invalid_health_endpoint enum value from the response property for the response status
- info
  removed the invalid_health_endpoint enum value from the response property for the response status
- info
  removed the invalid_health_endpoint enum value from the response property for the response status
- info
  removed the invalid_memory_limit enum value from the response property for the response status
- info
  removed the invalid_memory_limit enum value from the response property for the response status
- info
  removed the invalid_memory_limit enum value from the response property for the response status
- info
  removed the invalid_memory_limit enum value from the response property for the response status
- info
  removed the invalid_port enum value from the response property for the response status
- info
  removed the invalid_port enum value from the response property for the response status
- info
  removed the invalid_port enum value from the response property for the response status
- info
  removed the invalid_port enum value from the response property for the response status
- info
  removed the invalid_service_name enum value from the response property for the response status
- info
  removed the invalid_service_name enum value from the response property for the response status
- info
  removed the invalid_service_name enum value from the response property for the response status
- info
  removed the invalid_service_name enum value from the response property for the response status
- info
  removed the invalid_toml enum value from the response property for the response status
- info
  removed the invalid_toml enum value from the response property for the response status
- info
  removed the invalid_toml enum value from the response property for the response status
- info
  removed the invalid_toml enum value from the response property for the response status
- info
  removed the missing_command enum value from the response property for the response status
- info
  removed the missing_command enum value from the response property for the response status
- info
  removed the missing_command enum value from the response property for the response status
- info
  removed the missing_command enum value from the response property for the response status
- info
  removed the missing_config enum value from the response property for the response status
- info
  removed the missing_config enum value from the response property for the response status
- info
  removed the missing_config enum value from the response property for the response status
- info
  removed the missing_config enum value from the response property for the response status
- info
  removed the missing_source_archive enum value from the response property for the response status
- info
  removed the missing_source_archive enum value from the response property for the response status
- info
  removed the missing_source_archive enum value from the response property for the response status
- info
  removed the missing_source_archive enum value from the response property for the response status
- info
  removed the payment_required enum value from the response property for the response status
- info
  removed the payment_required enum value from the response property for the response status
- info
  removed the payment_required enum value from the response property for the response status
- info
  removed the payment_required enum value from the response property for the response status
- info
  removed the policy_rejected enum value from the response property for the response status
- info
  removed the policy_rejected enum value from the response property for the response status
- info
  removed the policy_rejected enum value from the response property for the response status
- info
  removed the policy_rejected enum value from the response property for the response status
- info
  removed the rate_limited enum value from the response property for the response status
- info
  removed the rate_limited enum value from the response property for the response status
- info
  removed the rate_limited enum value from the response property for the response status
- info
  removed the rate_limited enum value from the response property for the response status
- info
  response property checkout_url list-of-types was narrowed by removing types null from media type application/json of response 400
- info
  response property checkout_url list-of-types was narrowed by removing types null from media type application/json of response 401
- info
  response property checkout_url list-of-types was narrowed by removing types null from media type application/json of response 429
- info
  response property checkout_url list-of-types was narrowed by removing types null from media type application/json of response 500
- info
  response property docs_url list-of-types was narrowed by removing types null from media type application/json of response 400
- info
  response property docs_url list-of-types was narrowed by removing types null from media type application/json of response 401
- info
  response property docs_url list-of-types was narrowed by removing types null from media type application/json of response 429
- info
  response property docs_url list-of-types was narrowed by removing types null from media type application/json of response 500
- info
  the response's property pattern ^[\s\S]{0,8192}$ was added for the status
- info
  the response's property pattern ^[\s\S]{0,8192}$ was added for the status
- info
  the response's property pattern ^[\s\S]{0,8192}$ was added for the status
- info
  the response's property pattern ^[\s\S]{0,8192}$ was added for the status
- info
  the response's property pattern was changed from ^[\s\S]{1,1000}$ to ^[\s\S]{0,8192}$ for the status
- info
  the response's property pattern was changed from ^[\s\S]{1,1000}$ to ^[\s\S]{0,8192}$ for the status
- info
  the response's property pattern was changed from ^[\s\S]{1,1000}$ to ^[\s\S]{0,8192}$ for the status
- info
  the response's property pattern was changed from ^[\s\S]{1,1000}$ to ^[\s\S]{0,8192}$ for the status
- info
  the response's property pattern was changed from ^[\s\S]{1,240}$ to ^[\s\S]{0,8192}$ for the status
- info
  the response's property pattern was changed from ^[\s\S]{1,240}$ to ^[\s\S]{0,8192}$ for the status
- info
  the response's property pattern was changed from ^[\s\S]{1,240}$ to ^[\s\S]{0,8192}$ for the status
- info
  the response's property pattern was changed from ^[\s\S]{1,240}$ to ^[\s\S]{0,8192}$ for the status
- info
  the response's property pattern was changed from ^tovuk_[a-f0-9]{64}$ to ^[\s\S]{0,8192}$ for the status
- info
  added the required property to the response with the status

Operation history