Responses

• 200 application/json

  User successfully created

  Hide response attributes Show response attributes object

  • user_name string Required

    The user's identifier

  • security object Required

    The user's security information

    Hide security attributes Show security attributes object

    • roles array[string]

      The set of roles assigned to a user

    • permissions array[string]

      The distinct set of permissions allowed by the user's roles. These correspond to operationId values in the OpenAPI definition.

    • elevated_permissions object

      The user's elevated permission status

      Hide elevated_permissions attributes Show elevated_permissions attributes object

      • enabled boolean Required

        True if the user has elevated permissions

      • expires_at string(date-time)

        The time at which the user's elevated permissions expire

    • password string

      The user's password. Only used when modifying a user.

    • enabled boolean

      True if the user is enabled

    • security_realm object

      The user's security realm

      Hide security_realm attributes Show security_realm attributes object

      • type string Required

        The type of the security realm

        Values are native, ldap, saml, or active_directory.

      • id string Required

        The identifier for the security realm

  • metadata object

    The users metadata

    Hide metadata attributes Show metadata attributes object

    • created_by string

      The Id of the user that created this user

    • created_at string(date-time)

      The date and time when the user was created

    • updated_by string

      The Id of the user that last updated this user

    • updated_at string(date-time)

      The date and time when the user was last updated

    • first_login_at string(date-time)

      The date and time when the user first logged in

    • last_login_at string(date-time)

      The date and time when the user last logged in

  • full_name string

    The user's optional full name

  • email string

    The user's optional email address

  • builtin boolean

    True if the user is a built-in read-only user

• 400 application/json
  • The provided user name is invalid. Check that it is not empty and it does not contain special characters. (code: user.user_name.invalid)
  • Some of the provided roles are invalid. (code: user.roles.invalid)
  • Some of the provided roles are forbidden. (code: user.roles.forbidden)
  • Trying to set a restricted field. (code: user.restricted_field)
  Hide headers attribute Show headers attribute

  • x-cloud-error-codes string

    The error codes associated with the response

    Values are user.user_name.invalid, user.roles.invalid, user.roles.forbidden, or user.restricted_field.

  Hide response attribute Show response attribute object

  • errors array[object] Required

    A list of errors that occurred in the failing request

    Hide errors attributes Show errors attributes object

    • code string Required

      A structured code representing the error type that occurred

    • message string Required

      A human readable message describing the error that occurred

    • fields array[string]

      If the error can be tied to a specific field or fields in the user request, this lists those fields

• 409 application/json

  The username is already in use. (code: user.user_name.conflict)

  Hide headers attribute Show headers attribute

  • x-cloud-error-codes string

    The error codes associated with the response

    Value is user.user_name.conflict.

  Hide response attribute Show response attribute object

  • errors array[object] Required

    A list of errors that occurred in the failing request

    Hide errors attributes Show errors attributes object

    • code string Required

      A structured code representing the error type that occurred

    • message string Required

      A human readable message describing the error that occurred

    • fields array[string]

      If the error can be tied to a specific field or fields in the user request, this lists those fields