POST /principal/available

This call is used to determine if an alias is currently available.

A session token is not required for this call.

Each value of each AliasType must have a unique string representation. While some AliasTypes allow white-space and punctuation, only letters and numbers contribute to the uniqueness of the alias. Also while an alias can have both upper and lower case letters, the uniqueness test is case-insensitive. Here are some examples:
  • 'foo-bar', 'foo bar', and 'foo.bar' are all the same as 'foobar'
  • 'FooBar' and 'FOOBAR' are the same as 'foobar'
  • 'foo', 'foo1', and 'foo2' are each distinct
Note: This method will NOT reserve the passed alias. So it is possible that an alias, could be available during a pre-check, but then consumed before the caller has a chance to reserve it.

Resource URL

https://repo-prod.prod.sagebase.org/repo/v1/principal/available

Resource Information
Authentication false
HTTP Methods POST
Request Object AliasCheckRequest
(application/json)
Response Object AliasCheckResponse
(application/json)