Skip to main content

OAuth Apps

OAuth apps allow third-party services to access the API on behalf of users. Apps are scoped to a workspace.

List OAuth Apps​

GET /api/workspaces/:id/oauth-apps

Response:

{
  "oauthApps": [
    {
      "id": 1,
      "workspace_id": 2,
      "name": "My Integration",
      "client_id": "lnx_abc123...",
      "client_secret_prefix": "lnxs_xy",
      "redirect_uris": "[\"https://example.com/callback\"]",
      "created_by": 1,
      "created_by_name": "John Doe",
      "is_active": 1,
      "last_used_at": null,
      "created_at": 1710000000
    }
  ]
}

Create OAuth App​

Owner or admin only.

POST /api/workspaces/:id/oauth-apps

Request body:

FieldTypeRequiredDescription
namestringYesApp name
redirect_urisstring[]NoAllowed redirect URIs

Response:

{
  "oauthApp": {
    "id": 1,
    "client_id": "lnx_abc123...",
    "client_secret": "lnxs_full_secret_here",
    ...
  }
}
warning

The client_secret is only returned on creation. Store it securely.

Toggle OAuth App​

PATCH /api/workspaces/:id/oauth-apps/:appId

Delete OAuth App​

DELETE /api/workspaces/:id/oauth-apps/:appId