メインコンテンツへスキップ
POST
https://{tenantDomain}/api/v2
/
organizations
/
{id}
/
connections
Adds a connection to an organization
curl --request POST \
  --url https://{tenantDomain}/api/v2/organizations/{id}/connections \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "connection_id": "<string>",
  "organization_connection_name": "<string>",
  "assign_membership_on_login": true,
  "show_as_button": true,
  "is_signup_enabled": true,
  "organization_access_level": "none",
  "is_enabled": true
}
'
{
  "connection_id": "<string>",
  "organization_connection_name": "<string>",
  "assign_membership_on_login": true,
  "show_as_button": true,
  "is_signup_enabled": true,
  "organization_access_level": "none",
  "is_enabled": true,
  "connection": {
    "name": "<string>",
    "strategy": "<string>"
  }
}

承認

Authorization
string
header
必須

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

パスパラメータ

id
string
必須

Organization identifier.

Maximum string length: 50

ボディ

connection_id
string<connection-id>
必須

Connection identifier.

Required string length: 1 - 50
organization_connection_name
string

Name of the connection in the scope of this organization.

Required string length: 1 - 50
Pattern: ^[^]*$
assign_membership_on_login
boolean

When true, all users that log in with this connection will be automatically granted membership in the organization. When false, users must be granted membership in the organization before logging in with this connection.

show_as_button
boolean

Determines whether a connection should be displayed on this organization’s login prompt. Only applicable for enterprise connections. Default: true.

is_signup_enabled
boolean

Determines whether organization signup should be enabled for this organization connection. Only applicable for database connections. Default: false.

organization_access_level
enum<string>

Access level for the organization (e.g., "none", "full").

利用可能なオプション:
none,
readonly,
limited,
full
is_enabled
boolean

Whether the connection is enabled for the organization.

レスポンス

Connection successfully created.

connection_id
string<connection-id>
必須

Connection identifier.

Required string length: 1 - 50
organization_connection_name
string

Name of the connection in the scope of this organization.

Required string length: 1 - 50
Pattern: ^[^]*$
assign_membership_on_login
boolean

When true, all users that log in with this connection will be automatically granted membership in the organization. When false, users must be granted membership in the organization before logging in with this connection.

show_as_button
boolean

Determines whether a connection should be displayed on this organization’s login prompt. Only applicable for enterprise connections. Default: true.

is_signup_enabled
boolean

Determines whether organization signup should be enabled for this organization connection. Only applicable for database connections. Default: false.

organization_access_level
enum<string>

Access level for the organization (e.g., "none", "full").

利用可能なオプション:
none,
readonly,
limited,
full
is_enabled
boolean

Whether the connection is enabled for the organization.

connection
object