---
title: "Link integration status"
method: GET
path: "/workspaces/{workspaceId}/link/status"
tags: ["link"]
---

# Link integration status

`GET /workspaces/{workspaceId}/link/status`

## Request

- Base URL: `https://vetnio.com/api/v2`
- URL: `https://vetnio.com/api/v2/workspaces/{workspaceId}/link/status`
- Auth: HTTP bearer

Returns whether the calling user has connected Vetnio to a Link tenant in this workspace, with the tenant subdomain and default location when they have. Link credentials are saved per user and workspace in Vetnio's integration settings; they cannot be created through the REST API. Call this first to decide whether to show Link features. Never calls Link itself, so it does not prove the stored API key still works.

## Path parameters

- `workspaceId` string, required: Identifier of the clinic (workspace), as returned by `GET /workspaces`. The key's user must be a member of the clinic, or an admin of the organization it belongs to.

## Response `200`

Configuration status payload.

- union: Whether the calling user has connected Vetnio to a Link tenant in this workspace. Link credentials are stored per user and workspace, so two vets in the same clinic can see different results. Discriminated by `configured`.
  - object: No Link integration is stored for the calling user in this workspace.
    - `configured` false, required: `false`: the calling user has not saved Link credentials in this workspace. Every other Link endpoint returns `412 PRECONDITION_FAILED` until they do.
  - object: A Link integration is stored for the calling user in this workspace.
    - `configured` true, required: `true`: the calling user has saved Link credentials in this workspace and the other Link endpoints can be used.
    - `subdomain` string, required: The clinic's Link tenant subdomain, i.e. the `<subdomain>` in `https://<subdomain>.linkjournal.se`.
    - `defaultLocationId` integer, nullable, required: Link location (clinic site) used for new journal entries when the export request has no `locationId`. `null` when none was chosen and the tenant has more than one active location; exports must then pass `locationId`.
    - `updatedAt` string, required: When the Link credentials were last saved (ISO-8601 UTC).

## Other responses

- `400`: Invalid input data
- `401`: Authorization not provided
- `403`: Insufficient access
- `404`: Not found
- `500`: Internal server error

---

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