Rust · 0.1.0

Create Linked Identity

POST /api/v1/users/{user}/linkedIdentities

UserService · UserService_CreateLinkedIdentity

Protocol-derived reference. Authorization and instance policy still apply. Schema descriptions are inherited from the MIT-licensed application contract; examples here are not executed against a live server.

Access

Owner-only: the user named in the path must be the authenticated caller. Instance administrator status does not allow acting on another account here.

Complete an SSO authorization flow

The caller links an identity to their own account using the provider authorization code, matching redirectUri and any required PKCE codeVerifier. This is not a direct assignment of an arbitrary externUid and does not merge accounts based on email. An identity already linked elsewhere cannot simply be reassigned by this call.

Request

CreateLinkedIdentity links an SSO identity to the authenticated user.

POST/api/v1/users/{user}/linkedIdentities

Parameters

Name / location	Type / requirement	Description
`user` path	string Required	The user id.

Request body

Required

application/json · CreateLinkedIdentityRequest

Responses

200 · OK

application/json · LinkedIdentity

default · Default error response

application/json · Status

Complete operation definition

All declared constraints, media types and response details are retained below. Schema references link to their complete definitions.

Open JSON definition

{
  "tags": [
    "UserService"
  ],
  "description": "CreateLinkedIdentity links an SSO identity to the authenticated user.",
  "operationId": "UserService_CreateLinkedIdentity",
  "parameters": [
    {
      "name": "user",
      "in": "path",
      "description": "The user id.",
      "required": true,
      "schema": {
        "type": "string"
      }
    }
  ],
  "requestBody": {
    "content": {
      "application/json": {
        "schema": {
          "$ref": "#/components/schemas/CreateLinkedIdentityRequest"
        }
      }
    },
    "required": true
  },
  "responses": {
    "200": {
      "description": "OK",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/LinkedIdentity"
          }
        }
      }
    },
    "default": {
      "description": "Default error response",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/Status"
          }
        }
      }
    }
  }
}