Enumerate Auth Links

GET /auth-links

Lists all auth links

Requires a signed user/session or the existing authenticated client flow. The anonymous DCR delegated device profile cannot invoke this operation.

Required scope

Any authenticated access token

Query parameters

statusstring

Collection visibility. Defaults to CONNECTED. Use DRAFT to list incomplete drafts, or '*' to include all authorized auth links. Exact id reads ignore this filter.

Default: CONNECTED

Allowed values: DRAFT, CONNECTED, *.

pluginIdstring

Only return auth links for this plugin.

expandarray<string>

Expansion tokens that request related or computed fields for each result. When omitted, the response contains only the default, shallower set of fields for each result.

nextTokenstring

Opaque token for the next page of results. Pass the continuation token returned by the previous response, unchanged. Omit it to start from the first page.

maxResultsinteger

Maximum number of results to return.

minimum: 1

maximum: 100

Returns

200

Auth links retrieved successfully

Fields

resultsarray<AuthLink>Required
paginationContextPaginationContext
errorsarray<Error>: Partial query errors collected while returning available results.

Errors

500 INTERNAL

Internal server error

Retry with backoff only when the operation is safe to repeat. Include the error code when reporting persistent failures.