Give Feedback

dots.v2.agents.auth.byProvider().connections.byConnection_id().reconnect.post()

Generated on 5 Nov 2026 from DoTs version v1.23.0

Copy page as Markdown View page as Markdown

Usage

client.v2.agents.auth.byProvider(provider).connections.byConnection_id(connection_id).reconnect.post(requestConfiguration?: RequestConfiguration<object>): Promise<undefined | Provider_connection_response>

Description

Begins the interactive step again for a connection that needs it. The response includes authorization while that step is outstanding. No token is returned.

Parameters

provider string required

Example: github

Provider key. github is the provider served today.

connection_id string required

Example: 3f2a1b0c-9d8e-7f6a-5b4c-3d2e1f0a9b8c

The connection id.

Request Sample

Show Request Sample

import { FetchRequestAdapter } from "@microsoft/kiota-http-fetchlibrary";
import {
    createDigitalOceanClient,
    DigitalOceanApiKeyAuthenticationProvider,
} from "@digitalocean/dots";

const authProvider = new DigitalOceanApiKeyAuthenticationProvider(process.env.DIGITALOCEAN_TOKEN!);
const adapter = new FetchRequestAdapter(authProvider);
const client = createDigitalOceanClient(adapter);

const response = await client.v2.agents.auth
    .byProvider("github").connections
    .byConnection_id("3f2a1b0c-9d8e-7f6a-5b4c-3d2e1f0a9b8c").reconnect.post();

Response Example

Show Response Example

{
  "connection": {
    "id": "3f2a1b0c-9d8e-7f6a-5b4c-3d2e1f0a9b8c",
    "provider": "github",
    "provider_display_name": "GitHub",
    "user_id": "octocat",
    "status": "active",
    "owning_user_id": "b1c2d3e4-f5a6-7890-abcd-ef1234567890",
    "deletion_protected": false,
    "created_at": "2026-07-27T12:00:00Z",
    "updated_at": "2026-07-27T12:00:00Z",
    "oauth": {
      "scopes": [
        "repo"
      ],
      "granted_at": "2026-07-27T12:00:00Z"
    }
  },
  "authorization": {
    "status": "requires_authorization",
    "connect_url": "https://example.invalid/connect",
    "verification_code": "ABCD-1234",
    "expires_at": "2026-07-27T12:00:00Z"
  }
}