For Developers

Fetch Integration

GET https://ed.link/api/v2/teams/:team_id/integrations/:integration_id

Fetches detailed information about a single integration, including its scoped access token and data sharing settings.

Permissions

Requires the integrations.read system permission.

Parameters

ParameterTypeRequiredDescription
:team_idUUIDYesThe ID of the team.
:integration_idUUIDYesThe ID of the integration.

Sample Request

const response = await axios.get(
    `https://ed.link/api/v2/teams/${team_id}/integrations/${integration_id}`,
    {
        headers: {
            authorization: `Bearer ${user_session_token}`
        }
    }
);

Sample Response

{
    "$data": {
        "id": "fd8e2612-1329-4d85-bb56-95dcb27d7c92",
        "status": "active",
        "district_sharing": "all",
        "developer_sharing": "all",
        "district_licensing_enabled": true,
        "access_token": "TaB...zzH",
        "created_date": "2024-01-15T08:00:00.000Z",
        "updated_date": "2024-06-20T18:20:59.000Z"
    }
}