Get an API user

Retrieves an API user

GET /identity/apiusers/{apiUserId}

URI Parameters

Name In Required Type Description

apiUserId

path

True

string

Version 4 UUID of the API user

Responses

Name Type Description

200 OK

ApiUser

API user object

Produces

  • application/json

Security

Every request requires a JWT access token for authentication in the Authorisation HTTP header. Please see the API authentication page for details about how to get a JWT token.

Authorization: Bearer {JWT_TOKEN}

Roles

  • Wenenu Owner

  • Wenenu API User Administrator

Sample request

Sample request

GET https://wenenu.com/identity/apiusers/1c207ca9-6d7a-4d42-8527-47d4fb9a06c2 HTTP/1.1
Authorization: Bearer {jwt_token}

Sample Response

Status code: 200 OK

{
  "id": "1c207ca9-6d7a-4d42-8527-47d4fb9a06c2",
  "name": "API user 1",
  "expiration": "2022-04-26",
  "tenantId": "108365366dc9-88be-4c42-8329-55808630",
  "roles": [
    "WENENU_SERVICE_CONNECTOR_ADMIN",
    "WENENU_TEST_AGENT_ADMIN"
  ],
  "secret": "rHn*****************************"
}

Definitions

ApiUser

Name Type Description

id

string

Version 4 UUID of the API user

tenantId

string

Version 4 UUID of the Wenenu tenant of the API user

name

string

Arbitrary name of the API user, length 1-64

expiration

string

Date of the expiration in ISO 8601 format

roles

string[]

List of Wenenu roles associated with the API user

secret

string

Masked secret of the API user, only the first three letters are revealed

newSecret

string

The secret of the API user returned only in the response of an API user creation