Skip to content

platform.startPlatformProviderAuthorization

POST
/v1/platform/model_providers/{providerId}/oauth/authorizations
curl --request POST \
--url https://example.com/v1/platform/model_providers/example/oauth/authorizations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "redirectUri": "example", "expectedVersion": 1 }'
providerId
required
string
Media typeapplication/json
object
redirectUri
required
string
>= 1 characters <= 4096 characters
expectedVersion
required
integer
<= 9007199254740991

Example generated

{
"redirectUri": "example",
"expectedVersion": 1
}

Success

Media typeapplication/json
object
id
required
string
>= 1 characters
url
required
string
expiresAt
required
string

Example generated

{
"id": "example",
"url": "example",
"expiresAt": "example"
}

ModelProviderAuthorizationInvalid | ModelProviderInvalid

Media typeapplication/json
Any of:
object
_tag
required
string
Allowed values: ModelProviderAuthorizationInvalid
message
required
string

Example

{
"_tag": "ModelProviderAuthorizationInvalid"
}

AuthenticationRequired

Media typeapplication/json
object
_tag
required
string
Allowed values: AuthenticationRequired

Example

{
"_tag": "AuthenticationRequired"
}

@nmnmcc/ability/Authorizer/Forbidden | MembershipRequired | ForbiddenOrigin

Media typeapplication/json
Any of:
object
_tag
required
string
Allowed values: Forbidden
action
required
string
kind
required
string
field
string
reason
string

Example

{
"_tag": "Forbidden"
}

ModelProviderNotFound | ModelNotFound

Media typeapplication/json
Any of:
object
_tag
required
string
Allowed values: ModelProviderNotFound
providerId
required
string

Example

{
"_tag": "ModelProviderNotFound"
}

ModelProviderLoginRequired | ModelProviderConflict | ModelProviderInUse | ModelConflict | ModelInUse | @nmnmcc/ability/Authorizer/Pending

Media typeapplication/json
Any of:
object
_tag
required
string
Allowed values: ModelProviderLoginRequired

Example

{
"_tag": "ModelProviderLoginRequired"
}

PlatformUnavailable | OrganizationStorageUnavailable | ModelProviderOAuthUnavailable | ModelProvidersUnavailable | AuthenticationUnavailable | RequestFailed

Media typeapplication/json
Any of:
object
_tag
required
string
Allowed values: PlatformUnavailable

Example

{
"_tag": "PlatformUnavailable"
}