Get Federated Servers
    • Dark
      Light
    • PDF

    Get Federated Servers

    • Dark
      Light
    • PDF

    Article summary

    Get
    /api/v1/federation/listServersByUser
    Premium tag

    Lists all the servers the user has already saved.

    Changelog

    VersionDescription
    6.0.0Added
    Header parameters
    X-User-Id
    stringRequired

    The user ID.

    ExampleCkCPNctrgCDfmWLqC
    X-Auth-Token
    stringRequired

    The authentication token.

    Example1Dd4iN_ClKn5jl-xPC36snQ4s9Zd5GZnXCQuCNSKcVE
    Responses
    200

    OK

    Success Example
    {
      "servers": [
        {
          "name": "my-local.server",
          "default": true,
          "local": true
        },
        {
          "name": "matrix.org",
          "default": true,
          "local": false
        },
        {
          "name": "gitter.im",
          "default": true,
          "local": false
        },
        {
          "name": "libera.chat",
          "default": true,
          "local": false
        },
        {
          "name": "my-added-server.rocket.chat",
          "default": false,
          "local": false
        }
      ],
      "success": true
    }
    Expand All
    object
    servers
    Array of object
    object
    name
    string
    default
    boolean
    local
    boolean
    success
    boolean
    401

    Unauthorized

    Authorization Error
    {
      "status": "error",
      "message": "You must be logged in to do this."
    }
    object
    status
    string
    message
    string


    Was this article helpful?

    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.