{"basePath":"/realm","definitions":{"confirmation_code":{"descrpition":"Confirmation code acquired from realm owner","minLength":1,"title":"Confirmation code","type":"string"},"error":{"properties":{"code":{"description":"Error code.","type":"integer"},"id":{"description":"Object ID or index of element in array that was the reason of error. Might be 0.","type":"integer"},"reason":{"description":"Error description.","type":"string"}},"type":"object"},"errors":{"description":"Errors occurred while processing the request.","items":{"$ref":"#/definitions/error"},"type":"array"},"errors.result":{"description":"Canonical flespi response envelope used for non-2xx responses (and also when a 200 response carries per-item errors). 'result' is empty when 'errors' is populated.","properties":{"errors":{"$ref":"#/definitions/errors"},"result":{"description":"Always empty on error-only responses.","items":{},"type":"array"}},"type":"object"},"identity-providers.login.result":{"properties":{"result":{"items":{"properties":{"realm_id":{"$ref":"#/definitions/realm.id"},"url":{"description":"URL for logging in via selected identity provider","type":"string"}},"type":"object"},"type":"array"}},"type":"object"},"identity-providers.result":{"properties":{"result":{"items":{"properties":{"id":{"description":"Realm identity provider ID\n","type":"integer"},"public_info":{"description":"Auxiliary public information for the login UI\n","properties":{"description":{"description":"Free-form description text","type":"string"},"logo_url":{"description":"Logo image URL shown alongside the name","type":"string"},"name":{"description":"Display name shown on the login button","type":"string"}},"type":"object"},"type":{"description":"Identity provider type (e.g. \"oidc\", \"oauth2\", \"predefined\")\n","type":"string"}},"type":"object"},"type":"array"}},"type":"object"},"login.complete.request":{"properties":{"state":{"description":"Encrypted login continuation state from realm login URL.","type":"string"}},"required":["state"],"type":"object"},"login.complete.result":{"properties":{"result":{"items":{"properties":{"url":{"description":"URL where Web UI should redirect or continue the flow.","type":"string"}},"type":"object"},"type":"array"}},"type":"object"},"oauth.error":{"description":"OAuth protocol error response.","properties":{"error":{"type":"string"},"error_description":{"type":"string"}},"type":"object"},"oauth.token":{"description":"OAuth token response. The opaque Bearer retains the authenticated Realm and exact OAuth client identity.","properties":{"access_token":{"description":"Opaque Bearer access token accepted by flespi REST API.","type":"string"},"expires_in":{"description":"Access token lifetime in seconds.","type":"integer"},"refresh_token":{"description":"Rotated single-use refresh token bound to the exact OAuth client ID.","type":"string"},"scope":{"description":"OAuth scope granted for the access token.","enum":["default"],"type":"string"},"token_type":{"enum":["Bearer"],"type":"string"}},"type":"object"},"password":{"maxLength":511,"minLength":16,"type":"string","x-view":{"hash":[{"minLength":8,"type":"sha512"},{"type":"text"}],"type":"password"},"x-view-hash":"sha512,text","x-view-type":"password"},"realm.id":{"description":"Realm public ID","maxLength":16,"minLength":1,"title":"Public ID","type":"string","x-view-selector":"realmpublic"},"realm.info":{"properties":{"id":{"description":"Realm unique numeric ID","type":"string"},"public_id":{"description":"Realm unique string ID for public API","type":"string"},"public_info":{"properties":{"description":{"description":"Realm description text","type":"string"},"logo_url":{"description":"Realm logo URL link","type":"string"},"name":{"description":"Realm name given by its owner","type":"string"}},"type":"object"}},"type":"object"},"realm.info.result":{"properties":{"result":{"items":{"$ref":"#/definitions/realm.info"},"type":"array"}},"type":"object"},"token.result":{"properties":{"result":{"items":{"properties":{"token":{"description":"flespi token associated with the user","type":"string"}},"type":"object"},"type":"array"}},"type":"object"},"user.info.result":{"properties":{"result":{"items":{"properties":{"id":{"description":"User unique numeric ID","type":"string"},"name":{"description":"User name (unique for each realm)","type":"string"},"realm":{"$ref":"#/definitions/realm.info"}},"type":"object"},"type":"array"}},"type":"object"},"user.name":{"description":"User name","maxLength":255,"minLength":1,"title":"Name","type":"string"},"user.new_password":{"description":"User's new password\n","maxLength":511,"minLength":16,"title":"New password","type":"string","x-view":{"hash":[{"minLength":8,"type":"sha512"},{"type":"text"}],"type":"password"},"x-view-hash":"sha512,text","x-view-type":"password"},"user.password":{"description":"User's password\n","maxLength":511,"minLength":16,"title":"Password","type":"string","x-view":{"hash":[{"minLength":8,"type":"sha512"},{"type":"text"}],"type":"password"},"x-view-hash":"sha512,text","x-view-type":"password"}},"host":"flespi.io","info":{"description":"[Realms](https://flespi.com/kb/realms-create-and-manage-users) provide functionality to manage customer's own set of users.\n\nCustomer may specify [token](https://flespi.com/kb/tokens-access-keys-to-flespi-platform) parameters for the whole realm or for each separate user.\n\nWhen a user successfully logs in the specific realm then corresponding token is created. User may log in using these methods:\n  - name (unique for each realm) and password\n  - 3-rd party identity provider (OAuth 2.0 or OpendID Connect) account\n\nFor more information please read [Realms article in flespi KB](https://flespi.com/kb/realms-create-and-manage-users).\n","title":"flespi authentication realms public REST API","version":"0.1 alpha"},"parameters":{"identity-provider-id":{"default":"","description":"Realm Identity provider ID value","in":"path","name":"identity-provider-id","required":true,"type":"string"},"mcp-request-body":{"description":"JSON-RPC 2.0 request envelope.","in":"body","name":"data","required":true,"schema":{"additionalProperties":true,"type":"object"}},"oauth-client-id":{"description":"Exact HTTPS URL of an allowed OAuth Client ID Metadata Document. URL variants are different clients. Unlisted URLs are rejected before retrieval; redirects are not followed and the document endpoint must return HTTP 200.","in":"query","name":"client_id","required":true,"type":"string"},"oauth-code-challenge":{"description":"PKCE S256 code challenge.","in":"query","name":"code_challenge","required":true,"type":"string"},"oauth-code-challenge-method":{"description":"PKCE code challenge method. Only `S256` is supported.","enum":["S256"],"in":"query","name":"code_challenge_method","required":true,"type":"string"},"oauth-grant-type":{"description":"OAuth token grant type.","enum":["authorization_code","refresh_token"],"in":"formData","name":"grant_type","required":true,"type":"string"},"oauth-redirect-uri":{"description":"OAuth client redirect URI registered in the Client ID Metadata Document. HTTPS URIs must match exactly. Native clients may use HTTP loopback IP literal redirects on `127.0.0.1` or `[::1]`; only the port may differ from the registered URI.","in":"query","name":"redirect_uri","required":true,"type":"string"},"oauth-refresh-token":{"description":"Single-use refresh token received from a previous Realm OAuth token response. It is bound to the exact original client ID and rotates on successful use.","in":"formData","name":"refresh_token","required":false,"type":"string"},"oauth-response-type":{"description":"OAuth response type. Only `code` is supported.","enum":["code"],"in":"query","name":"response_type","required":true,"type":"string"},"oauth-scope":{"description":"OAuth scope string requested by the client. Only `default` is supported.","enum":["default"],"in":"query","name":"scope","required":false,"type":"string"},"oauth-state":{"description":"Opaque client state returned unchanged to the client redirect URI.","in":"query","name":"state","required":false,"type":"string"},"oauth-token-client-id":{"description":"Exact HTTPS URL of an allowed OAuth Client ID Metadata Document. It must match the client bound to the authorization code or refresh token and remain currently allowed.","in":"formData","name":"client_id","required":true,"type":"string"},"oauth-token-code":{"description":"Authorization code received from realm OAuth authorize flow. Required for `authorization_code` grant.","in":"formData","name":"code","required":false,"type":"string"},"oauth-token-code-verifier":{"description":"PKCE verifier matching the S256 code challenge from authorize request. Required for `authorization_code` grant.","in":"formData","name":"code_verifier","required":false,"type":"string"},"oauth-token-redirect-uri":{"description":"OAuth client redirect URI used for authorization. Required for `authorization_code` grant and must exactly match the actual URI, including any native loopback port.","in":"formData","name":"redirect_uri","required":false,"type":"string"},"realm-public-id":{"default":"","description":"Realm public ID value","in":"path","name":"realm-public-id","required":true,"type":"string","x-view-selector":"realmpublic"}},"paths":{"/{realm-public-id}/ai/mcp/develop":{"get":{"description":"SSE transport is not supported. Valid Realm requests are redirected to `/ai/mcp/develop`, which returns 405 for GET. Missing authentication returns a Bearer challenge with protected-resource metadata for OAuth discovery.\n","responses":{"307":{"description":"Redirect to the develop MCP server after Realm validation","headers":{"Location":{"description":"Direct `/ai/mcp/develop` endpoint URL.","type":"string"}}},"401":{"description":"Authentication is missing or invalid, including a Bearer token associated with another Realm","headers":{"WWW-Authenticate":{"description":"Bearer challenge containing the Realm MCP protected-resource metadata URL.","type":"string"}}},"403":{"description":"Realm access is denied, including proprietary token association, Realm state, or downstream ACL restrictions","schema":{"$ref":"#/definitions/errors.result"}}},"security":[{"FlespiToken":[]},{"Bearer":[]}],"summary":"Realm MCP server for development agents","tags":["realm"],"x-view-group":"MCP"},"parameters":[{"$ref":"#/parameters/realm-public-id"}],"post":{"description":"Valid Realm requests are redirected to `/ai/mcp/develop`, which checks the token ACL for `ai/mcp`.\n","parameters":[{"$ref":"#/parameters/mcp-request-body"}],"responses":{"307":{"description":"Redirect to the develop MCP server after Realm validation","headers":{"Location":{"description":"Direct `/ai/mcp/develop` endpoint URL.","type":"string"}}},"401":{"description":"Authentication is missing or invalid, including a Bearer token associated with another Realm","headers":{"WWW-Authenticate":{"description":"Bearer challenge containing the Realm MCP protected-resource metadata URL.","type":"string"}}},"403":{"description":"Realm access is denied, including proprietary token association, Realm state, or downstream ACL restrictions","schema":{"$ref":"#/definitions/errors.result"}}},"security":[{"FlespiToken":[]},{"Bearer":[]}],"summary":"Realm MCP server for development agents","tags":["realm"],"x-view-group":"MCP"}},"/{realm-public-id}/ai/mcp/support":{"get":{"description":"SSE transport is not supported. Valid Realm requests are redirected to `/ai/mcp/support`, which returns 405 for GET. Missing authentication returns a Bearer challenge with protected-resource metadata for OAuth discovery.\n","responses":{"307":{"description":"Redirect to the support MCP server after Realm validation","headers":{"Location":{"description":"Direct `/ai/mcp/support` endpoint URL.","type":"string"}}},"401":{"description":"Authentication is missing or invalid, including a Bearer token associated with another Realm","headers":{"WWW-Authenticate":{"description":"Bearer challenge containing the Realm MCP protected-resource metadata URL.","type":"string"}}},"403":{"description":"Realm access is denied, including proprietary token association, Realm state, or downstream ACL restrictions","schema":{"$ref":"#/definitions/errors.result"}}},"security":[{"FlespiToken":[]},{"Bearer":[]}],"summary":"Realm MCP server for support agents","tags":["realm"],"x-view-group":"MCP"},"parameters":[{"$ref":"#/parameters/realm-public-id"}],"post":{"description":"Valid Realm requests are redirected to `/ai/mcp/support`, which checks the token ACL for `ai/mcp`.\n","parameters":[{"$ref":"#/parameters/mcp-request-body"}],"responses":{"307":{"description":"Redirect to the support MCP server after Realm validation","headers":{"Location":{"description":"Direct `/ai/mcp/support` endpoint URL.","type":"string"}}},"401":{"description":"Authentication is missing or invalid, including a Bearer token associated with another Realm","headers":{"WWW-Authenticate":{"description":"Bearer challenge containing the Realm MCP protected-resource metadata URL.","type":"string"}}},"403":{"description":"Realm access is denied, including proprietary token association, Realm state, or downstream ACL restrictions","schema":{"$ref":"#/definitions/errors.result"}}},"security":[{"FlespiToken":[]},{"Bearer":[]}],"summary":"Realm MCP server for support agents","tags":["realm"],"x-view-group":"MCP"}},"/{realm-public-id}/confirm":{"post":{"description":"Confirm user registration and set a password.\n\nConfirmation code is acquired by realm owner.\n\nCall format: **POST /realm/{realm-public-id}/confirm**\n","parameters":[{"$ref":"#/parameters/realm-public-id"},{"in":"body","name":"data","required":true,"schema":{"properties":{"confirmation":{"$ref":"#/definitions/confirmation_code"},"name":{"$ref":"#/definitions/user.name"},"password":{"$ref":"#/definitions/user.password"}},"required":["name","confirmation","password"],"type":"object"}}],"responses":{"200":{"description":"Information about confirmed user\n","schema":{"$ref":"#/definitions/user.info.result"}},"403":{"description":"Failed to perform log in operation due to invalid confirmation code\n","schema":{"$ref":"#/definitions/errors.result"}},"500":{"description":"Server is unable to process request at the moment, try again later.\n"}},"summary":"Confirm realm user registration","tags":["realm"],"x-view-group":"User"}},"/{realm-public-id}/identity-providers":{"get":{"description":"Retrieve identity providers available for realm.\n\nThis is public method.\n\nCall format: **GET /realm/{realm-public-id}/identity-providers**\n","parameters":[{"$ref":"#/parameters/realm-public-id"}],"responses":{"200":{"description":"Information about available identity providers\n","schema":{"$ref":"#/definitions/identity-providers.result"}},"403":{"description":"Failed to query identity providers for the realm\n","schema":{"$ref":"#/definitions/errors.result"}},"500":{"description":"Server is unable to process request at the moment, try again later.\n"}},"summary":"Retrieve identity providers linked with realm","tags":["realm"],"x-view-group":"Identity providers"}},"/{realm-public-id}/identity-providers/{identity-provider-id}/login":{"get":{"description":"Retrieve log in link to authorize using the specific identity provider linked to the realm.\n\nCall format: **GET /realm/{realm-public-id}/identity-providers/{identity-provider-id}/login**\n\nWhen `state` is specified, login continues a Realm OAuth authorization.\n","parameters":[{"$ref":"#/parameters/realm-public-id"},{"$ref":"#/parameters/identity-provider-id"},{"description":"Realm OAuth authorization state.","in":"query","name":"state","required":false,"type":"string"}],"responses":{"200":{"description":"Result contains link for log in\n","schema":{"$ref":"#/definitions/identity-providers.login.result"}},"400":{"description":"Invalid or expired Realm OAuth authorization continuation","schema":{"$ref":"#/definitions/errors.result"}},"403":{"description":"Invalid realm public ID on unsupported identity provider\n","schema":{"$ref":"#/definitions/errors.result"}},"500":{"description":"Server is unable to process request at the moment, try again later.\n"}},"summary":"Retrieve identity provider log in link","tags":["realm"],"x-view-group":"Identity providers"}},"/{realm-public-id}/info":{"get":{"description":"Get information about specified realm.\n\nThis is public method which does not require authentification.\n\nCall format: **GET /realm/{realm-public-id}/info**\n","parameters":[{"$ref":"#/parameters/realm-public-id"}],"responses":{"200":{"description":"Information about requested realm","schema":{"$ref":"#/definitions/realm.info.result"}},"400":{"description":"Realm is not found\n","schema":{"$ref":"#/definitions/errors.result"}},"500":{"description":"Server is unable to process request at the moment, try again later.\n"}},"summary":"Retrieve realm information","tags":["realm"],"x-view-group":"Realm"}},"/{realm-public-id}/login":{"post":{"description":"Log in to specific realm using user name and password.\n\nREST API call will return token that user can use to access flespi platform.\n\nCall format: **POST /realm/{realm-public-id}/login**\n","parameters":[{"$ref":"#/parameters/realm-public-id"},{"in":"body","name":"data","required":true,"schema":{"properties":{"name":{"$ref":"#/definitions/user.name"},"password":{"$ref":"#/definitions/user.password"}},"required":["name","password"],"type":"object"}}],"responses":{"200":{"description":"Result contains token for work with flespi\n","schema":{"$ref":"#/definitions/token.result"}},"403":{"description":"Failed to perform log in operation due to invalid realm public ID\nor invalid user name and password\n","schema":{"$ref":"#/definitions/errors.result"}},"500":{"description":"Server is unable to process request at the moment, try again later.\n"}},"summary":"Authorize realm user","tags":["realm"],"x-view-group":"User"}},"/{realm-public-id}/login/complete":{"post":{"description":"Complete login continuation after realm user authentication.\n\nCall format: **POST /realm/{realm-public-id}/login/complete**\n","parameters":[{"$ref":"#/parameters/realm-public-id"},{"description":"Login continuation data","in":"body","name":"data","required":true,"schema":{"$ref":"#/definitions/login.complete.request"}}],"responses":{"200":{"description":"Login continuation result. On successful OAuth authorization continuation returns dialog URL. On recoverable OAuth error returns OAuth client redirect URL.\n","schema":{"$ref":"#/definitions/login.complete.result"}},"400":{"description":"Authorization continuation is missing, invalid, or otherwise unrecoverable.\n","schema":{"$ref":"#/definitions/errors.result"}},"403":{"description":"Realm login completion is forbidden because the realm public ID is invalid or unknown,\nthe realm is disabled, or the Realm OAuth server is disabled.\n","schema":{"$ref":"#/definitions/errors.result"}},"500":{"description":"Server is unable to process request at the moment, try again later.\n"}},"security":[{"FlespiToken":[]}],"summary":"Complete realm login continuation","tags":["realm"],"x-view-group":"OAuth"}},"/{realm-public-id}/oauth/authorization-server":{"get":{"description":"Get OAuth Authorization Server Metadata for specified realm.\n\nThis is public method which does not require authentification.\n\nCall format: **GET /realm/{realm-public-id}/oauth/authorization-server**\n","parameters":[{"$ref":"#/parameters/realm-public-id"}],"responses":{"200":{"description":"OAuth authorization server metadata for requested realm","schema":{"properties":{"authorization_endpoint":{"type":"string"},"client_id_metadata_document_supported":{"type":"boolean"},"code_challenge_methods_supported":{"items":{"type":"string"},"type":"array"},"grant_types_supported":{"items":{"type":"string"},"type":"array"},"issuer":{"type":"string"},"response_types_supported":{"items":{"type":"string"},"type":"array"},"scopes_supported":{"items":{"type":"string"},"type":"array"},"token_endpoint":{"type":"string"},"token_endpoint_auth_methods_supported":{"items":{"type":"string"},"type":"array"}},"type":"object"}},"400":{"description":"Invalid or unknown realm public ID.\n","schema":{"$ref":"#/definitions/oauth.error"}},"403":{"description":"OAuth access is denied, including when the realm or Realm OAuth server is disabled.\n","schema":{"$ref":"#/definitions/oauth.error"}},"500":{"description":"Server is unable to process request at the moment, try again later.\n"}},"summary":"Retrieve realm OAuth authorization server metadata","tags":["realm"],"x-view-group":"OAuth"}},"/{realm-public-id}/oauth/authorize":{"get":{"description":"Validate OAuth authorization request and redirect unauthenticated realm users to realm login.\n\nCall format: **GET /realm/{realm-public-id}/oauth/authorize**\n","parameters":[{"$ref":"#/parameters/realm-public-id"},{"$ref":"#/parameters/oauth-response-type"},{"$ref":"#/parameters/oauth-client-id"},{"$ref":"#/parameters/oauth-redirect-uri"},{"$ref":"#/parameters/oauth-state"},{"$ref":"#/parameters/oauth-scope"},{"$ref":"#/parameters/oauth-code-challenge"},{"$ref":"#/parameters/oauth-code-challenge-method"}],"responses":{"302":{"description":"Redirects either to realm login (`https://login.flespi.io/#/realm/{realm-public-id}/oauth/{state}`) or, after user authentication, to the OAuth client's redirect URI with authorization code.\n","headers":{"Location":{"description":"Realm login or validated OAuth client redirect URL.","type":"string"}}},"400":{"description":"Request is invalid before client redirect URI can be trusted.\n","schema":{"$ref":"#/definitions/oauth.error"}},"403":{"description":"OAuth access is denied, including when the realm or Realm OAuth server is disabled.\n","schema":{"$ref":"#/definitions/oauth.error"}},"500":{"description":"Server is unable to process request at the moment, try again later.\n"}},"summary":"Start realm OAuth authorization flow","tags":["realm"],"x-view-group":"OAuth"},"post":{"description":"Validate OAuth authorization request and redirect unauthenticated realm users to realm login.\n\nCall format: **POST /realm/{realm-public-id}/oauth/authorize**\n","parameters":[{"$ref":"#/parameters/realm-public-id"},{"$ref":"#/parameters/oauth-response-type"},{"$ref":"#/parameters/oauth-client-id"},{"$ref":"#/parameters/oauth-redirect-uri"},{"$ref":"#/parameters/oauth-state"},{"$ref":"#/parameters/oauth-scope"},{"$ref":"#/parameters/oauth-code-challenge"},{"$ref":"#/parameters/oauth-code-challenge-method"}],"responses":{"302":{"description":"Redirects either to realm login (`https://login.flespi.io/#/realm/{realm-public-id}/oauth/{state}`) or, after user authentication, to the OAuth client's redirect URI with authorization code.\n","headers":{"Location":{"description":"Realm login or validated OAuth client redirect URL.","type":"string"}}},"400":{"description":"Request is invalid before client redirect URI can be trusted.\n","schema":{"$ref":"#/definitions/oauth.error"}},"403":{"description":"OAuth access is denied, including when the realm or Realm OAuth server is disabled.\n","schema":{"$ref":"#/definitions/oauth.error"}},"500":{"description":"Server is unable to process request at the moment, try again later.\n"}},"summary":"Start realm OAuth authorization flow","tags":["realm"],"x-view-group":"OAuth"}},"/{realm-public-id}/oauth/token":{"post":{"consumes":["application/x-www-form-urlencoded"],"description":"Exchange authorization code issued by realm OAuth authorize flow, or rotate refresh token, for opaque Bearer access token and refresh token.\n\nAuthorization codes and refresh tokens are bound to their original client. Current client admission is checked before a grant is consumed. Refresh rotation does not revoke previously issued access tokens.\n\nCall format: **POST /realm/{realm-public-id}/oauth/token**\n","parameters":[{"$ref":"#/parameters/realm-public-id"},{"$ref":"#/parameters/oauth-grant-type"},{"$ref":"#/parameters/oauth-token-client-id"},{"$ref":"#/parameters/oauth-token-redirect-uri"},{"$ref":"#/parameters/oauth-token-code"},{"$ref":"#/parameters/oauth-token-code-verifier"},{"$ref":"#/parameters/oauth-refresh-token"}],"responses":{"200":{"description":"OAuth token response.\n","schema":{"$ref":"#/definitions/oauth.token"}},"400":{"description":"Token request, client admission, authorization code, or refresh token is invalid. A denied client does not consume an otherwise valid grant.\n","schema":{"$ref":"#/definitions/oauth.error"}},"403":{"description":"OAuth access is denied, including when the realm or Realm OAuth server is disabled.\n","schema":{"$ref":"#/definitions/oauth.error"}},"500":{"description":"Server is unable to process request at the moment, try again later.\n"}},"summary":"Exchange realm OAuth grant for tokens","tags":["realm"],"x-view-group":"OAuth"}},"/{realm-public-id}/user":{"get":{"description":"Retrieve user information under specified realm.\n\nUser is identified by its token and realm is identified by its public ID in path.\n\nCall format: **GET /realm/{realm-public-id}/user**\n","parameters":[{"$ref":"#/parameters/realm-public-id"}],"responses":{"200":{"description":"Information about user\n","schema":{"$ref":"#/definitions/user.info.result"}},"403":{"description":"Invalid token or user with such token is not found\n","schema":{"$ref":"#/definitions/errors.result"}},"500":{"description":"Server is unable to process request at the moment, try again later.\n"}},"security":[{"FlespiToken":[]}],"summary":"Retrieve realm user information","tags":["realm"],"x-view-group":"User"},"put":{"description":"Set realm user password.\n\nThis method allows user to change its password by supplying to the API call user name and its existing password.\n\nCall format: **PUT /realm/{realm-public-id}/user**\n","parameters":[{"$ref":"#/parameters/realm-public-id"},{"in":"body","name":"data","required":true,"schema":{"properties":{"name":{"$ref":"#/definitions/user.name"},"new_password":{"$ref":"#/definitions/user.new_password"},"password":{"$ref":"#/definitions/user.password"}},"required":["name","password","new_password"],"type":"object"}}],"responses":{"200":{"description":"Password has been successfully updated. User info is returned\n","schema":{"$ref":"#/definitions/user.info.result"}},"403":{"description":"Failed to set new password due to invalid realm public ID or invalid\nuser name and old password\n","schema":{"$ref":"#/definitions/errors.result"}},"500":{"description":"Server is unable to process request at the moment, try again later.\n"}},"summary":"Set realm user password","tags":["realm"],"x-view-group":"User"}}},"produces":["application/json"],"schemes":["https","http"],"securityDefinitions":{"Bearer":{"description":"Opaque Bearer authorization through a flespi token associated with the Realm. Realm OAuth-issued Bearers also retain the authenticated OAuth client ID.","in":"header","name":"Authorization","type":"apiKey"},"FlespiToken":{"description":"Authorization through flespi token","in":"header","name":"Authorization","type":"apiKey"}},"swagger":"2.0","tags":[{"name":"realm"}]}