For AI agents: The documentation index is at https://docs.digitalocean.com/llms.txt. Markdown versions of pages use the same URL with index.html.md in place of the HTML page (for example, append index.html.md to the directory path instead of opening the HTML document).

Usage

client.connections.get(id="39f9f768-a7f9-4c91-9557-3328c53dd054")

Description

Returns the connection and, while it is pending, the authorization the user still has to complete. Reading a pending connection picks up a completed authorization, and marks the connection expired once its link has lapsed. Returns 404 for an unknown connection or one you cannot see.

Parameters

id string required

Connection ID.

Response Example

{
  "connection": {
    "id": "39f9f768-a7f9-4c91-9557-3328c53dd054",
    "provider": "jira",
    "provider_display_name": "Jira",
    "user_id": "alice",
    "status": "active",
    "created_at": "2026-07-14T00:50:00Z",
    "updated_at": "2026-07-14T00:52:10Z",
    "revoked_at": null,
    "connection_parameters": {
      "site_url": "https://example.atlassian.net"
    },
    "credential_kind": "digitalocean_oauth",
    "credential_id": "",
    "network": null,
    "scopes": [
      "write:jira-work"
    ],
    "granted_at": "2026-07-14T00:52:10Z",
    "oauth": {
      "scopes": [
        "write:jira-work"
      ],
      "granted_at": "2026-07-14T00:52:10Z"
    }
  },
  "authorization": null
}

More Information

See /v2/action-gateway/connections/{id} in the API reference for additional detail on responses, headers, parameters, and more.