authed

Finish signing in to an MCP server

Finishes a sign-in the callback page received: adds the server (201) or reconnects it (200). Finishing the same sign-in again answers the server it already connected.

post/api/v1/org-mcp-servers/sign-ins/complete

Request

  • Base URL
    https://api.teaflask.com (the document declares no server; this is the origin it was published from)
  • URL
    https://api.teaflask.com/api/v1/org-mcp-servers/sign-ins/complete
  • Auth
    none declared

Request body

statestring required

The state the sign-in page returned.

codestring password nullable

The code the sign-in page returned.

issstring nullable

The iss the sign-in page returned, if any.

errorstring nullable

The error the sign-in page returned, if any.

urlstring password nullable

When adding a server: the address the sign-in started with.

display_namestring nullable

When adding a server: its name in the dashboard.

Response

Successful Response

idstring uuid required

The server's id.

handlestring required

The server's short name in agent tool names; it never changes.

display_namestring required

The server's name in the dashboard.

hoststring required

The host name of the server's address.

state'active' | 'needs_reconnect' | 'failed' required
last_errorstring nullable required

Why the server last failed to connect, or null.

sign_in'oauth' | 'token' | 'none' required
header_namesstring[] required

The names of the headers carrying its access token.

tool_countinteger required

How many tools the server lists now.

new_tool_countinteger required

How many of those arrived after the server was added.

first_listed_atstring date-time required

When the server was added.

tools_refreshed_atstring date-time required

When its tool list was last read.

removed_atstring date-time nullable required

When the server was removed, or null while it is live.

created_atstring date-time required

When the server was created.

versioninteger required

Pass back as expected_version when renaming the server.

Changes

No recorded changes to this operation across all 1 revision of this API.