Skip to content

Functions

This is the endpoint which is most locked down in the service. Viewing functions is limited to MSS and power users. Modifying functions is limited to sysadmin and those with full administrative access. Also note that when adding a function or role it needs to be added as a child to an existing function since the function graph needs to be connected.

Fetching a function

To fetch a function you need to know the name or ID of the function

1
curl -H "Argus-API-Key: my/api/key" https://api.mnemonic.no/useradmin/v2/function/VIEW-INTEGRATIONGUIDE

This returns the function model:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
{
  "data": {
    "id": 1,
    "name": "INTEGRATIONGUIDE-READERS",
    "description": "Allows access to read the integration guide",
    "minimumSecurityLevel": "external",
    "flags": [
      "role"
    ],
    ...
  }
}

The endpoints searching and listing functions return the same function datamodel.

Tip

See the Swagger API documentation for details on the returned data model.

Listing a functions children

To list a functions children you need the name or ID of the parent function

1
curl -H "Argus-API-Key: my/api/key" https://api.mnemonic.no/useradmin/v2/function/VIEW-INTEGRATIONGUIDE/children

This returns a list of all the children of the function

Listing a functions parents

To list a functions parents you need the name or ID of the child function

1
curl -H "Argus-API-Key: my/api/key" https://api.mnemonic.no/useradmin/v2/function/VIEW-INTEGRATIONGUIDE/parents

This returns a list of all the parents of the function

Searching for functions

Searching for functions can be done using the simple search GET endpoint or the advanced search POST endpoint.

Please read the Overview to learn about general concepts for search endpoints.

For simple search, the valid filtering parameters can be added as query parameters, which will ANDed together for each parameter.
If any parameter name is repeated, all the values for that parameter name will be combined according to the Swagger API documentation.

Providing no parameters will return all functions

1
2
# List functions that have at least security level "standard" 
curl -H "Argus-API-Key: my/api/key" https://api.mnemonic.no/useradmin/v2/function?minimumSecurityLevel=standard
The result will be a list of all functions the current user has access to matching the query

Advanced searches allow combining multiple queries to get more fine-grained searches.

Detailed information on how to build advanced searches using sub-criteria are found in the Overview.

All parameters available for group search are detailed in the Swagger API documentation.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
# search for functions that are of securitylevel "standard" 
curl -X POST -H "Argus-API-Key: my/api/key" -H "Content-Type: application/json" \
  https://api.mnemonic.no/useradmin/v2/function/search -d '
{
    "minimumSecurityLevel": "standard"
    "subCriteria": [{
            "excluded": true,
            "minimumSecurityLevel": "administrative"
        }]
    }
}'