---
title: "Get Connection"
method: GET
path: "/instagram/connection"
tags: ["instagram"]
---

# Get Connection

`GET /instagram/connection`

## Request

- Base URL: `https://api.reeldrop.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.reeldrop.io/instagram/connection`
- Auth: HTTP bearer

## Query parameters

- `workspace_id` string, nullable: Workspace this request applies to. Defaults to the caller's personal workspace. Must be one the caller belongs to.

## Response `200`

Successful Response

- IgConnectionResponse
  - `connected` boolean, required
  - `user_owned` boolean
  - `username` string
  - `avatar_url` string
  - `expires_at` string
  - `ig_user_id` string
  - `ig_account_id` string
  - `needs_reauth` boolean
  - `reauth_reason` string

## Other responses

- `422`: Validation Error

---

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