Back to top

API Documentation

SSO

A brokerage may decide to provide access to many other different applications for it’s users and agents and allow a single sign on onto their platforms, making Rechat a hub to all applications agents need.

Each application a brokerage provides to it’s users is called a “SSO Application” that can be managed using the following.

In order to launch an app, all clients have to do is to open up a new browser to sso_application.open_url.

Create an app

Create an app
POST/brands/:brand/sso_applications

The most important thing here is the authentication_type. SAML would be enabled for third party apps with SSO functionality. None for applications that can just be opened as a link and no sso is possible into them.

Example URI

POST /brands/:brand/sso_applications
URI Parameters
HideShow
brand
string (required) Example: 7613484d-33be-4e71-a2e1-d2b36c51dac2
Request
HideShow
Body
{
  "name": "Test SSO Application",
  "authentication_type": "SAML",
  "acs_url": "https://samltest.id/saml/sp",
  "entity_id": "https://samltest.id/saml/sp",
  "start_url": null,
  "signed": null,
  "name_id": "null",
  "name_id_format": null,
  "mappings": null,
  "brands": [
    "7613484d-33be-4e71-a2e1-d2b36c51dac2"
  ]
}
Response  200
HideShow
Body
{
  "code": "OK",
  "data": {
    "id": "71cbcc5e-9562-412b-907a-797cebe1e8b1",
    "created_at": 1783014978.097399,
    "updated_at": 1783014978.097402,
    "deleted_at": null,
    "authentication_type": "SAML",
    "url": null,
    "acs_url": "https://samltest.id/saml/sp",
    "entity_id": "https://samltest.id/saml/sp",
    "start_url": null,
    "signed": null,
    "name": "Test SSO Application",
    "name_id": "null",
    "name_id_format": null,
    "mappings": null,
    "audience": null,
    "destination": null,
    "recipient": null,
    "order": 0,
    "issuer": "927e7771-deb4-4559-88a1-bc2c5c9ffa64",
    "extra": null,
    "type": "sso_application",
    "open_url": "http://localhost:3079/sso_applications/open?hash=jFzYu21eACj10tvWF2YhXa1rh%2BmdIxmLXD8MY4QEZHPEWXR%2FSoiVuOgZnitDB2in0EyAaaVVnsIaSP4Q4BH5jhDFQKYbd5VdjhW8uhsofVVxzZXniiU5JA1mfaQQIOedXGOCTXNB0FV3Q615IRGjQz6brMxgqHy%2FTesmfzVGAWqUE6vv%2Bsekb6YVzCTq1DCTxD8NCiVO4Abaz2Rx4dk%2F%2Fjwms%2BB2GkcC%2Bz6lTls%3D",
    "metadata_url": "http://localhost:3079/sso_applications/71cbcc5e-9562-412b-907a-797cebe1e8b1.xml"
  }
}

Update an app

Update an app
PUT/brands/:brand/sso_applications/:id

Example URI

PUT /brands/:brand/sso_applications/:id
URI Parameters
HideShow
brand
string (required) Example: 7613484d-33be-4e71-a2e1-d2b36c51dac2
id
string (required) Example: 71cbcc5e-9562-412b-907a-797cebe1e8b1
Request
HideShow
Body
{
  "id": "71cbcc5e-9562-412b-907a-797cebe1e8b1",
  "created_at": 1783014978.097399,
  "updated_at": 1783014978.097402,
  "deleted_at": null,
  "authentication_type": "SAML",
  "url": null,
  "acs_url": "https://samltest.id/saml/sp",
  "entity_id": "https://samltest.id/saml/sp",
  "start_url": null,
  "signed": null,
  "name": "Updated Test SSO Application",
  "name_id": "null",
  "name_id_format": null,
  "mappings": null,
  "audience": null,
  "destination": null,
  "recipient": null,
  "order": 0,
  "issuer": "927e7771-deb4-4559-88a1-bc2c5c9ffa64",
  "extra": null,
  "type": "sso_application",
  "open_url": "http://localhost:3079/sso_applications/open?hash=jFzYu21eACj10tvWF2YhXa1rh%2BmdIxmLXD8MY4QEZHPEWXR%2FSoiVuOgZnitDB2in0EyAaaVVnsIaSP4Q4BH5jhDFQKYbd5VdjhW8uhsofVVxzZXniiU5JA1mfaQQIOedXGOCTXNB0FV3Q615IRGjQz6brMxgqHy%2FTesmfzVGAWqUE6vv%2Bsekb6YVzCTq1DCTxD8NCiVO4Abaz2Rx4dk%2F%2Fjwms%2BB2GkcC%2Bz6lTls%3D",
  "metadata_url": "http://localhost:3079/sso_applications/71cbcc5e-9562-412b-907a-797cebe1e8b1.xml",
  "brands": [
    "7613484d-33be-4e71-a2e1-d2b36c51dac2"
  ]
}
Response  200
HideShow
Body
{
  "code": "OK",
  "data": {
    "id": "71cbcc5e-9562-412b-907a-797cebe1e8b1",
    "created_at": 1783014978.097399,
    "updated_at": 1783014978.097402,
    "deleted_at": null,
    "authentication_type": "SAML",
    "url": null,
    "acs_url": "https://samltest.id/saml/sp",
    "entity_id": "https://samltest.id/saml/sp",
    "start_url": null,
    "signed": null,
    "name": "Updated Test SSO Application",
    "name_id": "null",
    "name_id_format": null,
    "mappings": null,
    "audience": null,
    "destination": null,
    "recipient": null,
    "order": 0,
    "issuer": "927e7771-deb4-4559-88a1-bc2c5c9ffa64",
    "extra": null,
    "type": "sso_application",
    "open_url": "http://localhost:3079/sso_applications/open?hash=jFzYu21eACj10tvWF2YhXa1rh%2BmdIxmLXD8MY4QEZHPEWXR%2FSoiVuOgZnitDB2in0EyAaaVVnsIaSP4Q4BH5jhDFQKYbd5VdjhW8uhsofVVxzZXniiU5JA1mfaQQIOedXGOCTXNB0FV3Q615IRGjQz6brMxgqHy%2FTesmfzVGAWqUE6vv%2Bsekb6YVzCTq1DCTxD8NCiVO4Abaz2Rx4dk%2F%2Fjwms%2BB2GkcC%2FzOlTls%3D",
    "metadata_url": "http://localhost:3079/sso_applications/71cbcc5e-9562-412b-907a-797cebe1e8b1.xml"
  }
}

Update app ordering

Update app ordering
PUT/brands/:brand/sso_applications/sort

It can handle multiple updates in one call.

Example URI

PUT /brands/:brand/sso_applications/sort
URI Parameters
HideShow
brand
string (required) Example: 7613484d-33be-4e71-a2e1-d2b36c51dac2
Request
HideShow
Body
[
  {
    "id": "f4b9dcb9-16c6-46b6-9d9a-b32df57da6df",
    "order": 27
  }
]
Response  200
HideShow
Body
{
  "code": "OK",
  "data": [
    {
      "id": "f4b9dcb9-16c6-46b6-9d9a-b32df57da6df",
      "order": 27
    }
  ],
  "info": {
    "count": 1,
    "total": 0
  }
}

Set Brands that are allowed to use this app

Set Brands that are allowed to use this app
PUT/brands/:brand/sso_applications/:id/brands

Example URI

PUT /brands/:brand/sso_applications/:id/brands
URI Parameters
HideShow
brand
string (required) Example: 7613484d-33be-4e71-a2e1-d2b36c51dac2
id
string (required) Example: 71cbcc5e-9562-412b-907a-797cebe1e8b1
associations
string (required) Example: sso_application.brands
Request
HideShow
Body
{
  "brands": [
    "7613484d-33be-4e71-a2e1-d2b36c51dac2",
    "557b4781-7cf9-4bd1-8b97-e3dc8ec0ed1b"
  ]
}
Response  200
HideShow
Body
{
  "code": "OK",
  "data": {
    "id": "71cbcc5e-9562-412b-907a-797cebe1e8b1",
    "created_at": 1783014978.097399,
    "updated_at": 1783014978.097402,
    "deleted_at": null,
    "authentication_type": "SAML",
    "url": null,
    "acs_url": "https://samltest.id/saml/sp",
    "entity_id": "https://samltest.id/saml/sp",
    "start_url": null,
    "signed": null,
    "name": "Updated Test SSO Application",
    "name_id": "null",
    "name_id_format": null,
    "mappings": null,
    "audience": null,
    "destination": null,
    "recipient": null,
    "order": 0,
    "issuer": "927e7771-deb4-4559-88a1-bc2c5c9ffa64",
    "extra": null,
    "type": "sso_application",
    "brands": [
      {
        "id": "557b4781-7cf9-4bd1-8b97-e3dc8ec0ed1b",
        "created_at": 1783014976.3426,
        "updated_at": 1783014976.3426,
        "palette": null,
        "assets": null,
        "messages": null,
        "parent": {
          "id": "7613484d-33be-4e71-a2e1-d2b36c51dac2",
          "created_at": 1783014975.972053,
          "updated_at": 1783014975.972053,
          "palette": null,
          "assets": null,
          "messages": null,
          "parent": null,
          "name": "Admin Brand Parent",
          "deleted_at": null,
          "training": false,
          "brand_type": "Brokerage",
          "parents": null,
          "type": "brand",
          "hostnames": null,
          "member_count": 1,
          "base_url": "https://irish.rechat.com"
        },
        "name": "Child Brand",
        "deleted_at": null,
        "training": false,
        "brand_type": "Team",
        "parents": [
          "7613484d-33be-4e71-a2e1-d2b36c51dac2"
        ],
        "type": "brand",
        "hostnames": null,
        "member_count": 0,
        "base_url": "https://irish.rechat.com"
      },
      {
        "id": "7613484d-33be-4e71-a2e1-d2b36c51dac2",
        "created_at": 1783014975.972053,
        "updated_at": 1783014975.972053,
        "palette": null,
        "assets": null,
        "messages": null,
        "parent": null,
        "name": "Admin Brand Parent",
        "deleted_at": null,
        "training": false,
        "brand_type": "Brokerage",
        "parents": null,
        "type": "brand",
        "hostnames": null,
        "member_count": 1,
        "base_url": "https://irish.rechat.com"
      }
    ],
    "open_url": "http://localhost:3079/sso_applications/open?hash=jFzYu21eACj10tvWF2YhXa1rh%2BmdIxmLXD8MY4QEZHPEWXR%2FSoiVuOgZnitDB2in0EyAaaVVnsIaSP4Q4BH5jhDFQKYbd5VdjhW8uhsofVVxzZXniiU5JA1mfaQQIOedXGOCTXNB0FV3Q615IRGjQz6brMxgqHy%2FTesmfzVGAWqUE6vv%2Bsekb6YVzCTq1DCTxD8NCiVO4Abaz2Rx4dk%2F%2Fjwms%2BB2GkcA%2FjWlTls%3D",
    "metadata_url": "http://localhost:3079/sso_applications/71cbcc5e-9562-412b-907a-797cebe1e8b1.xml"
  }
}

Set Icon

Set Icon
PUT/brands/:brand/sso_applications/:id/icon

Example URI

PUT /brands/:brand/sso_applications/:id/icon
URI Parameters
HideShow
brand
string (required) Example: 7613484d-33be-4e71-a2e1-d2b36c51dac2
id
string (required) Example: 71cbcc5e-9562-412b-907a-797cebe1e8b1
associations
string (required) Example: sso_application.brands
Request
HideShow
Body
{
  "brands": [
    "7613484d-33be-4e71-a2e1-d2b36c51dac2",
    "557b4781-7cf9-4bd1-8b97-e3dc8ec0ed1b"
  ]
}
Response  200
HideShow
Body
{
  "code": "OK",
  "data": {
    "id": "71cbcc5e-9562-412b-907a-797cebe1e8b1",
    "created_at": 1783014978.097399,
    "updated_at": 1783014978.097402,
    "deleted_at": null,
    "authentication_type": "SAML",
    "url": null,
    "acs_url": "https://samltest.id/saml/sp",
    "entity_id": "https://samltest.id/saml/sp",
    "start_url": null,
    "signed": null,
    "name": "Updated Test SSO Application",
    "name_id": "null",
    "name_id_format": null,
    "mappings": null,
    "audience": null,
    "destination": null,
    "recipient": null,
    "order": 0,
    "issuer": "927e7771-deb4-4559-88a1-bc2c5c9ffa64",
    "extra": null,
    "type": "sso_application",
    "brands": [
      {
        "id": "557b4781-7cf9-4bd1-8b97-e3dc8ec0ed1b",
        "created_at": 1783014976.3426,
        "updated_at": 1783014976.3426,
        "palette": null,
        "assets": null,
        "messages": null,
        "parent": {
          "id": "7613484d-33be-4e71-a2e1-d2b36c51dac2",
          "created_at": 1783014975.972053,
          "updated_at": 1783014975.972053,
          "palette": null,
          "assets": null,
          "messages": null,
          "parent": null,
          "name": "Admin Brand Parent",
          "deleted_at": null,
          "training": false,
          "brand_type": "Brokerage",
          "parents": null,
          "type": "brand",
          "hostnames": null,
          "member_count": 1,
          "base_url": "https://irish.rechat.com"
        },
        "name": "Child Brand",
        "deleted_at": null,
        "training": false,
        "brand_type": "Team",
        "parents": [
          "7613484d-33be-4e71-a2e1-d2b36c51dac2"
        ],
        "type": "brand",
        "hostnames": null,
        "member_count": 0,
        "base_url": "https://irish.rechat.com"
      },
      {
        "id": "7613484d-33be-4e71-a2e1-d2b36c51dac2",
        "created_at": 1783014975.972053,
        "updated_at": 1783014975.972053,
        "palette": null,
        "assets": null,
        "messages": null,
        "parent": null,
        "name": "Admin Brand Parent",
        "deleted_at": null,
        "training": false,
        "brand_type": "Brokerage",
        "parents": null,
        "type": "brand",
        "hostnames": null,
        "member_count": 1,
        "base_url": "https://irish.rechat.com"
      }
    ],
    "open_url": "http://localhost:3079/sso_applications/open?hash=jFzYu21eACj10tvWF2YhXa1rh%2BmdIxmLXD8MY4QEZHPEWXR%2FSoiVuOgZnitDB2in0EyAaaVVnsIaSP4Q4BH5jhDFQKYbd5VdjhW8uhsofVVxzZXniiU5JA1mfaQQIOedXGOCTXNB0FV3Q615IRGjQz6brMxgqHy%2FTesmfzVGAWqUE6vv%2Bsekb6YVzCTq1DCTxD8NCiVO4Abaz2Rx4dk%2F%2Fjwms%2BB2GkcA%2FjWlTls%3D",
    "metadata_url": "http://localhost:3079/sso_applications/71cbcc5e-9562-412b-907a-797cebe1e8b1.xml"
  }
}

Get all available applications

Get all available applications
GET/brands/:brand/sso_applications

Example URI

GET /brands/:brand/sso_applications
URI Parameters
HideShow
brand
string (required) Example: 7613484d-33be-4e71-a2e1-d2b36c51dac2
Response  200
HideShow
Body
{
  "code": "OK",
  "data": [
    {
      "id": "71cbcc5e-9562-412b-907a-797cebe1e8b1",
      "created_at": 1783014978.097399,
      "updated_at": 1783014978.097402,
      "deleted_at": null,
      "authentication_type": "SAML",
      "url": null,
      "acs_url": "https://samltest.id/saml/sp",
      "entity_id": "https://samltest.id/saml/sp",
      "start_url": null,
      "signed": null,
      "name": "Updated Test SSO Application",
      "name_id": "null",
      "name_id_format": null,
      "mappings": null,
      "audience": null,
      "destination": null,
      "recipient": null,
      "order": 0,
      "issuer": "927e7771-deb4-4559-88a1-bc2c5c9ffa64",
      "extra": null,
      "type": "sso_application",
      "open_url": "http://localhost:3079/sso_applications/open?hash=jFzYu21eACj10tvWF2YhXa1rh%2BmdIxmLXD8MY4QEZHPEWXR%2FSoiVuOgZnitDB2in0EyAaaVVnsIaSP4Q4BH5jhDFQKYbd5VdjhW8uhsofVVxzZXniiU5JA1mfaQQIOedXGOCTXNB0FV3Q615IRGjQz6brMxgqHy%2FTesmfzVGAWqUE6vv%2Bsekb6YVzCTq1DCTxD8NCiVO4Abaz2Rx4dk%2F%2Fjwms%2BB2GkcH%2BDWlTls%3D",
      "metadata_url": "http://localhost:3079/sso_applications/71cbcc5e-9562-412b-907a-797cebe1e8b1.xml"
    },
    {
      "id": "f4b9dcb9-16c6-46b6-9d9a-b32df57da6df",
      "created_at": 1783014978.267036,
      "updated_at": 1783014978.267036,
      "deleted_at": null,
      "authentication_type": "SAML",
      "url": null,
      "acs_url": "https://samltest.id/saml/sp",
      "entity_id": "https://samltest.id/saml/sp",
      "start_url": null,
      "signed": null,
      "name": "Order Update Test SSO Application",
      "name_id": "null",
      "name_id_format": null,
      "mappings": null,
      "audience": null,
      "destination": null,
      "recipient": null,
      "order": 27,
      "issuer": "ef3e8c86-f10d-42f6-aec3-ceb369196149",
      "extra": null,
      "type": "sso_application",
      "open_url": "http://localhost:3079/sso_applications/open?hash=jFzYu21eACj10tvWF2YhXa1rh%2BmdIxmLXD8MY4QEZHPEWXR%2FSoiVuOgZnitDB2in0EyAaaVVz8cbE%2FkQt035hhOQRKYbcMUJjhXotBsoKF90ypaw2HA9KgsxfaQQIOedXGOCTXNB0FV3Q615IRGjQz6brMxgqHy%2FTesmfzVGAWqUE6vv%2Bsekb6YVzCTq1DCTxD8NCiVO4Abaz2Rx4dk%2F%2Fjwms%2BB2GkcH%2BDWlTls%3D",
      "metadata_url": "http://localhost:3079/sso_applications/f4b9dcb9-16c6-46b6-9d9a-b32df57da6df.xml"
    }
  ],
  "info": {
    "count": 2,
    "total": 0
  }
}

Delete an app

Delete an app
DELETE/brands/:brand/sso_applications/:id

Example URI

DELETE /brands/:brand/sso_applications/:id
URI Parameters
HideShow
brand
string (required) Example: 7613484d-33be-4e71-a2e1-d2b36c51dac2
id
string (required) Example: 71cbcc5e-9562-412b-907a-797cebe1e8b1
Request
HideShow
Body
{
  "id": "71cbcc5e-9562-412b-907a-797cebe1e8b1",
  "created_at": 1783014978.097399,
  "updated_at": 1783014978.097402,
  "deleted_at": null,
  "authentication_type": "SAML",
  "url": null,
  "acs_url": "https://samltest.id/saml/sp",
  "entity_id": "https://samltest.id/saml/sp",
  "start_url": null,
  "signed": null,
  "name": "Updated Test SSO Application",
  "name_id": "null",
  "name_id_format": null,
  "mappings": null,
  "audience": null,
  "destination": null,
  "recipient": null,
  "order": 0,
  "issuer": "927e7771-deb4-4559-88a1-bc2c5c9ffa64",
  "extra": null,
  "type": "sso_application",
  "open_url": "http://localhost:3079/sso_applications/open?hash=jFzYu21eACj10tvWF2YhXa1rh%2BmdIxmLXD8MY4QEZHPEWXR%2FSoiVuOgZnitDB2in0EyAaaVVnsIaSP4Q4BH5jhDFQKYbd5VdjhW8uhsofVVxzZXniiU5JA1mfaQQIOedXGOCTXNB0FV3Q615IRGjQz6brMxgqHy%2FTesmfzVGAWqUE6vv%2Bsekb6YVzCTq1DCTxD8NCiVO4Abaz2Rx4dk%2F%2Fjwms%2BB2GkcC%2Bz6lTls%3D",
  "metadata_url": "http://localhost:3079/sso_applications/71cbcc5e-9562-412b-907a-797cebe1e8b1.xml",
  "brands": [
    "7613484d-33be-4e71-a2e1-d2b36c51dac2"
  ]
}
Response  200
HideShow
Body
{
  "code": "OK",
  "data": {
    "id": "71cbcc5e-9562-412b-907a-797cebe1e8b1",
    "created_at": 1783014978.097399,
    "updated_at": 1783014978.097402,
    "deleted_at": null,
    "authentication_type": "SAML",
    "url": null,
    "acs_url": "https://samltest.id/saml/sp",
    "entity_id": "https://samltest.id/saml/sp",
    "start_url": null,
    "signed": null,
    "name": "Updated Test SSO Application",
    "name_id": "null",
    "name_id_format": null,
    "mappings": null,
    "audience": null,
    "destination": null,
    "recipient": null,
    "order": 0,
    "issuer": "927e7771-deb4-4559-88a1-bc2c5c9ffa64",
    "extra": null,
    "type": "sso_application",
    "open_url": "http://localhost:3079/sso_applications/open?hash=jFzYu21eACj10tvWF2YhXa1rh%2BmdIxmLXD8MY4QEZHPEWXR%2FSoiVuOgZnitDB2in0EyAaaVVnsIaSP4Q4BH5jhDFQKYbd5VdjhW8uhsofVVxzZXniiU5JA1mfaQQIOedXGOCTXNB0FV3Q615IRGjQz6brMxgqHy%2FTesmfzVGAWqUE6vv%2Bsekb6YVzCTq1DCTxD8NCiVO4Abaz2Rx4dk%2F%2Fjwms%2BB2GkcC%2FzOlTls%3D",
    "metadata_url": "http://localhost:3079/sso_applications/71cbcc5e-9562-412b-907a-797cebe1e8b1.xml"
  }
}

Generated by aglio on 02 Jul 2026