---
title: "Poll a device-code connection"
method: GET
path: "/v1/connect/poll"
tags: ["Connection"]
---

# Poll a device-code connection

`GET /v1/connect/poll`

## Request

- Base URL: `https://app.taskfuel.ai`
- URL: `https://app.taskfuel.ai/v1/connect/poll`
- Auth: none required

Poll at the interval returned by /v1/connect/start. An approved API key is delivered once and the connection request is then deleted.

## Query parameters

- `code` string, required

## Response `200`

Connection pending or approved.

- union
  - ConnectPending
    - `status` 'pending', required
  - ConnectApproved
    - `status` 'approved', required
    - `key` string, required: Single-delivery taskfuel API key. Store it securely and never display it to anyone else.

## Other responses

- `400`: The code query parameter is missing.
- `404`: The code is unknown or expired.

---

[API](https://skmtc.dev/taskfuel/apis/taskfuel-gateway-api.md) · [All operations](https://skmtc.dev/taskfuel/apis/taskfuel-gateway-api/llms.txt) · [OpenAPI document](https://skmtc.dev/taskfuel/apis/taskfuel-gateway-api/revisions/fbf2d5210800?raw)