Get user role pairings

GET 
https://acmeco.nonemployee.com/api/user_roles

This endpoint can retrieve user role pairings from Lifecycle or you can search for user role pairings using parameters

Request

Query Parameters

query object

Allows for pagination and sorting.

user_id uuid

The ID of a user for filtering

role_id uuid

The ID of a role for filtering

metadata boolean
Returns batching metadata in the response. This includes total as the total quantity, next as the path of the following query url, limit and after_id (if requested) with the next following id (null if it is the last "page").
Default value: false

Responses

200

Expected response to a valid request

application/json

Schema

Schema

user_roles object[]
Array [
iduuid
uidstring
Possible values: >= 32 characters and <= 32 characters
user_iduuid
role_iduuid
]
_metadata object
limitinteger
offsetinteger
totalinteger
nextstring
Example: /endpoint?limit=10&offset=60
previousstring
Example: /endpoint?limit=10&offset=40

Example (auto)

{
  "user_roles": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "uid": "string",
      "user_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "role_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
    }
  ],
  "_metadata": {
    "limit": 0,
    "offset": 0,
    "total": 0,
    "next": "/endpoint?limit=10&offset=60",
    "previous": "/endpoint?limit=10&offset=40"
  }
}

400

Bad Request - unable to complete.

application/json

Schema

Schema

oneOf
InvalidJson
error
Example: Invalid JSON syntax. Please check your syntax and try again.
ValidationErrors
error
Example: The <object> failed to create/update
errors
Example: {"attribute":"can't be blank"}

Example (auto)

{
  "error": "Invalid JSON syntax. Please check your syntax and try again."
}

500

Internal Server Error - returned on unhandled exceptions.

application/json

Schema

Schema

error
A message describing the error
Example: Sorry something went wrong

Example (auto)

{
  "error": "Sorry something went wrong"
}

Authorization: http

name: bearerAuthtype: httpscheme: bearerbearerFormat: Token token=your token

• go
• powershell
  SailPoint SDK
• python
  SailPoint SDK
• csharp
• curl
• dart
• http
• java
• javascript
• kotlin
• c
• nodejs
• objective-c
• ocaml
• php
• r
• ruby
• rust
• shell
• swift

• NATIVE

package main

import (
  "fmt"
  "net/http"
  "io"
)

func main() {

  url := "https://acmeco.nonemployee.com/api/user_roles"
  method := "GET"

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, nil)

  if err != nil {
    fmt.Println(err)
    return
  }
  req.Header.Add("Accept", "application/json")
  req.Header.Add("Authorization", "Bearer <TOKEN>")

  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := io.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}

Request Collapse all

Base URL

https://acmeco.nonemployee.com/api

Auth

Bearer Token

Parameters

query — query

user_id — query

role_id — query

metadata — query

---truefalse

ResponseClear

Click the Send API Request button above and see the response here!