---
title: "Start your T3 Connect sign-in (supports Idempotency-Key)"
method: POST
path: "/v1/integrations/t3/sign-in"
tags: ["Integrations"]
---

# Start your T3 Connect sign-in (supports Idempotency-Key)

`POST /v1/integrations/t3/sign-in`

## Request

- Base URL: `https://api.shardflux.dev`
- URL: `https://api.shardflux.dev/v1/integrations/t3/sign-in`
- Auth: HTTP bearer

Returns your pending T3 Connect device sign-in, or starts one: open verification_uri on any device and confirm user_code. One sign-in serves every workspace you link, with your session or with your API keys. Poll GET /integrations/t3/sign-in/{flow_id} every interval_seconds; workspaces waiting for the sign-in link by themselves once it is approved. While you are signed in this is 409 t3_signed_in; with replace: true the workspaces linked with your current sign-in are unlinked and a new sign-in starts. The sign-in is per organization: with a session in more than one organization pass ?project_id= (a project of that organization). Takes your session (`Authorization: Bearer sfu_…` or the dashboard): an API key gets 403 session_required with a fix.

## Query parameters

- `project_id` string, uuid

## Request body

- object
  - `replace` boolean: Sign in again with another T3 Connect account: your workspaces linked with the current sign-in are unlinked first.

## Response `200`

Default Response

- object
  - `flow_id` string, uuid, required: UUIDv7, lowercase canonical form.
  - `verification_uri` string, required: Open on any device with a browser and confirm user_code.
  - `user_code` string, required
  - `expires_at` string, date-time, required: RFC 3339 UTC timestamp with Z.
  - `interval_seconds` integer, required: Poll GET /integrations/t3/sign-in/{flow_id} at most this often.

## Other responses

- `4XX`: Default Response
- `5XX`: Default Response

---

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