Link

Init Link Connection

post/v1/link/init

Request

  • Base URL: https://api.withone.ai
  • URL: https://api.withone.ai/v1/link/init
  • Auth: API key in header X-One-Secret

Query parameters

limitinteger

Items per page. Default 20, hard-capped at 150. limit=0 is treated as 1. Larger values silently clamp.

pageinteger

Page number for pagination (1-indexed). Defaults to 1.

skipinteger

Number of items to skip before the first returned item. Defaults to 0. Most callers should leave this at 0 and rely on page + limit.

Request body

groupstring nullable
identitystring nullable
identityType'organization' | 'user' | 'team' | 'project'
labelstring nullable
namestring nullable
tagsstring[] nullable

Response

Connection initialized

pageinteger required
pagesinteger required
totalinteger required
requestIdstring

Prefixed ID with 'oauth_req' prefix (e.g., 'oauth_req_1C'), also accepts raw integer

Changes

No recorded changes to this operation across all 1 revision of this API.