User Roles on the Signiant Platform

The Signiant Platform allows users to hold different permission levels based on roles assigned to a user. When a user logs in via console.signiant.com, the user profile is called by the platform which contains the roles associated with the user, allowing access to more than one product or service at a time.

When using with the API, the client_id, client_secret, and generated JWT bearer token used to access the API are scoped to a single role for a single product.

To add, remove, and update users, you must use the v1/users endpoint with the JWT bearer token generated from the client_id and client_secret that correspond to the necessary role for the related product.

Examples

Creating Users

To create a new user, or assign a role to an existing user, send a POST request to the /v1/users/{email_address}/roles endpoint with the role as the request body.

Note: Creating a new user sends an automated email to the user, prompting them to set a password for their Signiant Console account.

Example Request

Copy
{
  "role": "MEDIA_ENGINE_USER"
}

Example Response

Copy
{
  "roleId": "31cd79a8-bbbb-bbbb-bbbb-e3465b4e8ee4",
  "role": "MEDIA_ENGINE_USER",
  "createdOn": "2024-04-20T18:43:53.747Z"
}

Listing Users

To list existing users and their associated roles, send a GET request to the /v1/users endpoint.

Example Response

Copy
{
  "items": [
    {
      "emailAddress": "user@example.com",
      "roles": {
        "items": [
          {
            "roleId": "c8e187a6-aaaa-aaaa-aaaa-6e6625176e4a",
            "role": "MEDIA_ENGINE_IT_ADMIN",
            "createdOn": "2024-04-20T17:06:26.284Z"
          },
          {
            "roleId": "6a275d61-bbbb-bbbb-bbbb-35e466289624",
            "role": "MEDIA_ENGINE_USER",
            "createdOn": "2024-04-20T18:43:53.747Z"
          }
        ]
      }
    }
  ]
}

Removing Users

To remove a user, you must remove their role using their roleId. Send a DELETE request to the /v1/users/{email_address}/roles/{roleId} endpoint.

Example Response

Copy
{
  "roleId": "31cd79a8-bbbb-bbbb-bbbb-e3465b4e8ee4",
  "role": "MEDIA_ENGINE_USER",
  "createdOn": "2024-04-20T18:43:53.747Z"
}

Note: At least one administrator must be assigned to an account.

Service and Role Reference

Product Account Type Service Role
Flight Deck Administrator MANAGER_AND_AGENTS_SAAS MANAGER_AND_AGENTS_SAAS_ADMIN
Jet Administrator S2S S2S_ADMIN
Media Engine Administrator MEDIA_ENGINE MEDIA_ENGINE_IT_ADMIN
Media Engine End User MEDIA_ENGINE MEDIA_ENGINE_USER

Note: The Signiant Platform API is currently not available for Media Shuttle. User roles must be assigned using the Media Shuttle IT Administration console or Operations Administration console. To add portal members via the API, see the Media Shuttle Management API documentation. To modify your Media Shuttle IT Administrators, contact Signiant Customer Care.