Skip to content
Connect an agent

Connections

Read the authorization server metadata

Sign in with Plotwork's metadata (RFC 8414): the issuer, the endpoints, the scopes, PKCE S256 only, and how a client authenticates.

GET/.well-known/oauth-authorization-server

TL;DR

QuestionAnswer
What does it do?Read the authorization server metadata.
What does it take?Nothing.
What does it return?Status 200 with a body of type AuthorizationServerMetadata.
What can go wrong?503 sign in with Plotwork is not available on this server (oauth.unavailable). Every failure uses the one error envelope.

What it does

Sign in with Plotwork's metadata (RFC 8414): the issuer, the endpoints, the scopes, PKCE S256 only, and how a client authenticates. Any origin may read it.

Responses

StatusMeaningBody
200The metadata.AuthorizationServerMetadata
503Sign in with Plotwork is not available on this server (oauth.unavailable).ErrorResponse

Response body

A 200 answer has the type AuthorizationServerMetadata.

FieldTypeRequiredDescription
issuerstringyes
authorization_endpointstringyes
token_endpointstringyes
revocation_endpointstringyes
response_types_supportedstring[]yes
grant_types_supportedstring[]yes
code_challenge_methods_supportedstring[]yes
token_endpoint_auth_methods_supportedstring[]yes
revocation_endpoint_auth_methods_supportedstring[]yes
scopes_supportedstring[]yes
authorization_response_iss_parameter_supportedbooleanyes
service_documentationstringyes

See also

DocWhy
API referenceEvery endpoint, and the error envelope
SchemasEvery request and response type
Tool referenceThe operations as callable tools