Introduction

This is the NetFoundry identity service

Overview

HTTP verbs

NetFoundry adheres closely to standard HTTP and REST conventions in its use of HTTP verbs.

Verb Usage

GET

Used to retrieve a resource

POST

Used to create a new resource

PUT

Used to update an existing resource, full updates only

DELETE

Used to delete an existing resource
The PATCH method is not used (yet).

HTTP status codes

NetFoundry adheres closely to standard HTTP and REST conventions in its use of HTTP status codes.

Status code Usage

200 OK

The actual response will depend on the request method used. In a GET request, the response will contain an entity corresponding to the requested resource. In a POST request, the response will contain an entity describing or containing the result of the action.

201 Created

The request has been fulfilled and resulted in a new resource being created.

202 Accepted

The request has been accepted and is being processed asynchronously Standard response for successful HTTP requests which invoke back-end services.

204 No Content

The server successfully processed the request, but is not returning any content.

400 Bad Request

The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing).

401 Unauthorized

The request lacks valid authentication credentials for the target resource.

403 Forbidden

The request is authenticated with valid credentials however that set of credentials is not authorized to access this resource.

404 Not Found

The requested resource could not be found but may be available again in the future. Subsequent requests by the client are permissible.

Resources

Organization

Find Organizations

GET /organizations

Authorization

Valid Authorization Bearer token required, along with a permission grant authorizing access to any referenced resources.

Path parameters

No parameters.

Query parameters

Supports standard paging query parameters.

Parameter Type Optional Description

name

String

true

active

Boolean

true

mfaProviders

Object

true

includeDeleted

Boolean

true

Default value: 'false'.

Request fields

No request body.

Response fields

Standard paging response where content field is list of following objects:

Path Type Optional Description

id

String

false

name

String

true

Used for display purposes. Not unique or private.

io.netfoundry.common.util.validation.BasicPattern.

label

String

false

A short value, containing only letters, numbers and dashes, which could be used as a label in a vanity domain. This label uniquely identifies the Organization, and is the key by which organization users indicate the organization within which they intend to authenticate. Note: A deleted organization looses its label. Such organizations will have a label value that combines the organization id with the prior label value. This maintains the constraint that all organization labels are unique, and frees the prior organization label value for reclamation. Obviously a deleted organization’s label will no longer meet the validation constraints of a live organization label.

Must match the regular expression \p{Alnum}|\p{Alnum}[-\p{Alnum}]{0,61}\p{Alnum}.

identityProviders

Array[Object]

false

identityProviders[].id

String

false

identityProviders[].organizationId

String

false

The id of the {@link Organization} that this provider will authenticate users into.

identityProviders[].auth0ConnectionId

String

false

The auth0 generated id of the auth0 connection that this IdentityProvider represents.

Size must be between 1 and 128 inclusive.

identityProviders[].name

String

false

Used for display purposes. Not unique or private.

Size must be between 1 and 128 inclusive.

identityProviders[].auth0ConnectionType

String

false

Must be one of [Database, Social, Enterprise, Passwordless].

active

Boolean

true

mfaProvider

String

true

Specifies an Auth0 compliant MFA provider. When set, it will trigger MFA on authentication via Auth0. If null, then the organization does not require MFA.

Must be one of [None, GoogleAuthenticator].

createdAt

Object

false

updatedAt

Object

false

deletedAt

Object

true

deleted

Boolean

true

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/organizations' -i -X GET \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJ0LTFKX1VHSFg5bXBpdmU0NkdGVlJnIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6ImJhNGYwODY0LTg5ZDQtNDI3ZS04MzEyLWY3OGM2YzRlNzBmZSIsImF1ZCI6ImlkZW50aXR5IiwiaWF0IjoxNTkyOTMyMTA5LCJleHAiOjE1OTI5MzU3MDksInBvbGljaWVzIjpbeyJyZXNvdXJjZXMiOlsibmZybjoqIl0sImFjdGlvbnMiOlsiKjoqIl19XSwiZ3JhbnRzLXN1cGVyIjoiW3tcImlkXCI6XCJlZDA3MTE0OS05MDQ4LTQ2YmItYWNjNC1mMDllMzk2ZDM5MjJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCI1N2FiN2ZmMi00MTQ3LTQ3NWEtOTFhZC04YmM2Nzc3MjRlNjZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCIzNGYxMDg0MC1jYmY1LTRjMWQtOWI0Yy1jMjA0OGYzZjQ3NThcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCJjYmY4OTAyMS05ZTUyLTRjOWQtYjA0Yi04YmYzMTdlNmQ1YTBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDl9LHtcImlkXCI6XCIxNDU0NjZlOC1hZTRkLTRiNTAtYjczOS04NWMyMThmOTBmZmRcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJiMTY1Y2MxNS0xNGQ2LTQwYzItODg4My0xZTRiMTU3MTBkMDJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCJiZDYyYmNlYy02MGY5LTQwNzUtOTExMS1mNjM1NTI0OGE5ZmRcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCI1ZTIzZmI2My00ZWE4LTQzMjQtODU0NS01NGY0Yzc1MTlhODJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCJkMjQ2ODliZC03NWZmLTQ4MzYtOTM0Ni03ODYwOWFlMmZmOGVcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCI4MDY5OTJmNC0yYzc2LTQxMDctOTA5YS0yYWIzOGRmNWVjNTlcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCJjMDJiNDhiMy1iMmI0LTRlZDAtYjhhNC1hNjYxMzIwZTFkM2ZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDl9LHtcImlkXCI6XCIxNjFlOTU2Mi0wMWI2LTRlMTEtYmY0Zi1kNTgzMzhkYzNjZDNcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCIwODIxMTRiNy1hZGVhLTQ5MjYtOTY3NC1lNjBmZTJhODM2MGJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJiZDM2NjZlMy1lMTJjLTRkMTktODI5MS04MzM3NjY2ZDVhYTBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDl9LHtcImlkXCI6XCJlMzNiN2YyYS1mODVhLTQzZWMtOTEwOC02N2Y5M2I4NjFkMmFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCIzOWNiMzVjZi05NzExLTQxNzQtOTg0Zi1jZjgxYWIyNGJmNmJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCJjOTM2NWEwNS04YzMwLTRkMDQtYTAxMy1jZTAwODljNWZlZWNcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCJjMGQwZDg4NC1kOWE2LTRjODItYmU1ZC1mY2ExNWFiODUyNTBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCIzZGYzOTU3Ni0yZmZmLTRiYzItYmNiNS03NjNhMWU1ZDg4ZWFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCJiNmYzNTI5Yi04ODc2LTQ5NjUtYmQ2ZC02ODIzY2VhYzdlOGRcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCIyZmNlNzU2My1lYjk0LTRhMjEtOTAzMS02ZDQwNDhmZjE5YTdcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJjMmQxODBiMC04MjdhLTRlYzEtYjU4Zi01NWU0ZjcwMTY5NDZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCI5ZjIyNGUwNS04MmZiLTQ4ODgtOTY1YS0yMmE2ZGE4MjNhOTFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCJjMWRlMjk2Ni0xZmJmLTRmNTEtYmNhMi05YjU3OTYxMzIzMjBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDV9LHtcImlkXCI6XCJkZDUzYWU3NS01MzA2LTRhNDktOWE5Yi1iNjAzZDdmOTM0MDZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCJmOTgxN2Y2YS1lZDY3LTQ5N2QtYjAxMC02NTdkMGEyYjNiNzlcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDl9XSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbXSIsImdyYW50cy1hY3Rpb24iOiJbXSIsImdyYW50cy1zdGFuZGFyZCI6IltdIn0.lXu0ww5aSeX7twWkAoMQWeIkldcLaFtxLl3URhAtiJfDtr0Ff1T0lT6IoIj33o-RPEq1ImFQ0Znjk7UovaVYotIc1VyfsXHMR2qJFtPWDAj9rxFYSFDYYXN511qQlA-Da5_s87Ca8tCzCA26dCHs1nAjzYFE1U3ME8-FjPPBVpijqe8yAy9jlgB-StlzMb3tsgz6khFJpZ-VLPkjRCfbZjss9_TT0jgR5HLW3ov0r8prR3abhk_ocERPjz2rzEt_atlFv_BPgRJQ-SEn6TkPsfAHO9fxsVw3_ptN1g9Dzv28a-keCSRBXq9QM96spQX4kmA7ft8rVeOaywTtf_MEkA'

Example response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 1740

[ {
  "id" : "c011b83c-a593-4d52-bb4e-3c130e346e38",
  "name" : "MOP Services Identity Group",
  "label" : "MOP-Services",
  "identityProviders" : [ ],
  "active" : true,
  "mfaProvider" : "None",
  "createdAt" : {
    "nano" : 152000000,
    "epochSecond" : 1592932103
  },
  "updatedAt" : null,
  "deletedAt" : null,
  "deleted" : false
}, {
  "id" : "f20456a7-e2c0-4abf-a358-250644369772",
  "name" : "ACME International, Inc.",
  "label" : "ACME-0",
  "identityProviders" : [ {
    "id" : "4e26c2d8-01ba-4f4f-ba83-8415f68df9ff",
    "organizationId" : "f20456a7-e2c0-4abf-a358-250644369772",
    "auth0ConnectionId" : "auth0-opaque-connectionId-2",
    "name" : "Google-Account",
    "auth0ConnectionType" : "Social"
  }, {
    "id" : "eb0d6f6a-2950-4f80-b00a-26ccad664f80",
    "organizationId" : "f20456a7-e2c0-4abf-a358-250644369772",
    "auth0ConnectionId" : "auth0-opaque-connectionId-1",
    "name" : "ACME Federated Active Directory",
    "auth0ConnectionType" : "Enterprise"
  } ],
  "active" : true,
  "mfaProvider" : null,
  "createdAt" : {
    "nano" : 846000000,
    "epochSecond" : 1592932105
  },
  "updatedAt" : null,
  "deletedAt" : null,
  "deleted" : false
}, {
  "id" : "7356a198-035c-448d-805e-d816a62fafd7",
  "name" : "Best Corp.",
  "label" : "BEST-CORP",
  "identityProviders" : [ {
    "id" : "276cbcfb-35a0-40d6-b254-63cf269b83cb",
    "organizationId" : "7356a198-035c-448d-805e-d816a62fafd7",
    "auth0ConnectionId" : "auth0-opaque-connection",
    "name" : "Corp SAML",
    "auth0ConnectionType" : "Enterprise"
  } ],
  "active" : true,
  "mfaProvider" : null,
  "createdAt" : {
    "nano" : 87000000,
    "epochSecond" : 1592932109
  },
  "updatedAt" : null,
  "deletedAt" : null,
  "deleted" : false
} ]

Get Organization By Id

GET /organizations/{id:[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}}

Authorization

Valid Authorization Bearer token required, along with a permission grant authorizing access to any referenced resources.

Path parameters

Parameter Type Optional Description

id

Object

false

Client must have read action on the annotated resource.

Query parameters

No parameters.

Request fields

No request body.

Response fields

Path Type Optional Description

id

String

false

name

String

true

Used for display purposes. Not unique or private.

io.netfoundry.common.util.validation.BasicPattern.

label

String

false

A short value, containing only letters, numbers and dashes, which could be used as a label in a vanity domain. This label uniquely identifies the Organization, and is the key by which organization users indicate the organization within which they intend to authenticate. Note: A deleted organization looses its label. Such organizations will have a label value that combines the organization id with the prior label value. This maintains the constraint that all organization labels are unique, and frees the prior organization label value for reclamation. Obviously a deleted organization’s label will no longer meet the validation constraints of a live organization label.

Must match the regular expression \p{Alnum}|\p{Alnum}[-\p{Alnum}]{0,61}\p{Alnum}.

identityProviders

Array[Object]

false

identityProviders[].id

String

false

identityProviders[].organizationId

String

false

The id of the {@link Organization} that this provider will authenticate users into.

identityProviders[].auth0ConnectionId

String

false

The auth0 generated id of the auth0 connection that this IdentityProvider represents.

Size must be between 1 and 128 inclusive.

identityProviders[].name

String

false

Used for display purposes. Not unique or private.

Size must be between 1 and 128 inclusive.

identityProviders[].auth0ConnectionType

String

false

Must be one of [Database, Social, Enterprise, Passwordless].

active

Boolean

true

mfaProvider

String

true

Specifies an Auth0 compliant MFA provider. When set, it will trigger MFA on authentication via Auth0. If null, then the organization does not require MFA.

Must be one of [None, GoogleAuthenticator].

createdAt

Object

false

updatedAt

Object

false

deletedAt

Object

true

deleted

Boolean

true

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/organizations/f20456a7-e2c0-4abf-a358-250644369772' -i -X GET \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJmZlRLYjJZa0J3NGJWTVVSbEI1Q2FRIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6ImJhNGYwODY0LTg5ZDQtNDI3ZS04MzEyLWY3OGM2YzRlNzBmZSIsImF1ZCI6ImlkZW50aXR5IiwiaWF0IjoxNTkyOTMyMTA5LCJleHAiOjE1OTI5MzU3MDksInBvbGljaWVzIjpbeyJyZXNvdXJjZXMiOlsibmZybjoqIl0sImFjdGlvbnMiOlsiKjoqIl19XSwiZ3JhbnRzLXN1cGVyIjoiW3tcImlkXCI6XCJlZDA3MTE0OS05MDQ4LTQ2YmItYWNjNC1mMDllMzk2ZDM5MjJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCI0YjYzOWNmOC00MDU4LTQ4MDEtYWQzZS05N2M4N2Y3ZWQzNzBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDl9LHtcImlkXCI6XCI1N2FiN2ZmMi00MTQ3LTQ3NWEtOTFhZC04YmM2Nzc3MjRlNjZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCIzNGYxMDg0MC1jYmY1LTRjMWQtOWI0Yy1jMjA0OGYzZjQ3NThcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCJjYmY4OTAyMS05ZTUyLTRjOWQtYjA0Yi04YmYzMTdlNmQ1YTBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDl9LHtcImlkXCI6XCIxNDU0NjZlOC1hZTRkLTRiNTAtYjczOS04NWMyMThmOTBmZmRcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJiMTY1Y2MxNS0xNGQ2LTQwYzItODg4My0xZTRiMTU3MTBkMDJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCJiZDYyYmNlYy02MGY5LTQwNzUtOTExMS1mNjM1NTI0OGE5ZmRcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCI1ZTIzZmI2My00ZWE4LTQzMjQtODU0NS01NGY0Yzc1MTlhODJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCJkMjQ2ODliZC03NWZmLTQ4MzYtOTM0Ni03ODYwOWFlMmZmOGVcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCI4MDY5OTJmNC0yYzc2LTQxMDctOTA5YS0yYWIzOGRmNWVjNTlcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCJjMDJiNDhiMy1iMmI0LTRlZDAtYjhhNC1hNjYxMzIwZTFkM2ZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDl9LHtcImlkXCI6XCIxNjFlOTU2Mi0wMWI2LTRlMTEtYmY0Zi1kNTgzMzhkYzNjZDNcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCIwODIxMTRiNy1hZGVhLTQ5MjYtOTY3NC1lNjBmZTJhODM2MGJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJiZDM2NjZlMy1lMTJjLTRkMTktODI5MS04MzM3NjY2ZDVhYTBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDl9LHtcImlkXCI6XCJlMzNiN2YyYS1mODVhLTQzZWMtOTEwOC02N2Y5M2I4NjFkMmFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCIzOWNiMzVjZi05NzExLTQxNzQtOTg0Zi1jZjgxYWIyNGJmNmJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCJjOTM2NWEwNS04YzMwLTRkMDQtYTAxMy1jZTAwODljNWZlZWNcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCJjMGQwZDg4NC1kOWE2LTRjODItYmU1ZC1mY2ExNWFiODUyNTBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCIzZGYzOTU3Ni0yZmZmLTRiYzItYmNiNS03NjNhMWU1ZDg4ZWFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCJiNmYzNTI5Yi04ODc2LTQ5NjUtYmQ2ZC02ODIzY2VhYzdlOGRcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCIyZmNlNzU2My1lYjk0LTRhMjEtOTAzMS02ZDQwNDhmZjE5YTdcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJjMmQxODBiMC04MjdhLTRlYzEtYjU4Zi01NWU0ZjcwMTY5NDZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCI5ZjIyNGUwNS04MmZiLTQ4ODgtOTY1YS0yMmE2ZGE4MjNhOTFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCJjMWRlMjk2Ni0xZmJmLTRmNTEtYmNhMi05YjU3OTYxMzIzMjBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDV9LHtcImlkXCI6XCJkZDUzYWU3NS01MzA2LTRhNDktOWE5Yi1iNjAzZDdmOTM0MDZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCJmOTgxN2Y2YS1lZDY3LTQ5N2QtYjAxMC02NTdkMGEyYjNiNzlcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDl9XSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbXSIsImdyYW50cy1hY3Rpb24iOiJbXSIsImdyYW50cy1zdGFuZGFyZCI6IltdIn0.K82vbPqyLllmCRMR_NyZbcXMY2j_PUmT-PlUub50aC7E9WMvxwUAJ8Hk0gk-RP_bkgsWd_74i7OsrC4N2jY3J5Xy-E4-hhaw_2ICmnSU4a036XLAnJ4XTOZQHGeVA4HJZB--cZhGg9j2rwerTtuOv-Vj3pQYcA2mHtN2Waj2gIwV7ErFjxu1BuOj2u62-GiWKwTv73e-pRkmQDpMLvSgSBWvReeaYWlkmY_jhVg8Gr7DdfvPNAmrZNOGrFXyIqAendQcw93ZtmPelxVzRj3fc8j_0yezXAsS7JXtSYfv9ibSiTPuD4vy45DEYhzC7emlKInHwjvUs6-r3uKAB2DfsQ'

Example response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 839

{
  "id" : "f20456a7-e2c0-4abf-a358-250644369772",
  "name" : "ACME International, Inc.",
  "label" : "ACME-0",
  "identityProviders" : [ {
    "id" : "4e26c2d8-01ba-4f4f-ba83-8415f68df9ff",
    "organizationId" : "f20456a7-e2c0-4abf-a358-250644369772",
    "auth0ConnectionId" : "auth0-opaque-connectionId-2",
    "name" : "Google-Account",
    "auth0ConnectionType" : "Social"
  }, {
    "id" : "eb0d6f6a-2950-4f80-b00a-26ccad664f80",
    "organizationId" : "f20456a7-e2c0-4abf-a358-250644369772",
    "auth0ConnectionId" : "auth0-opaque-connectionId-1",
    "name" : "ACME Federated Active Directory",
    "auth0ConnectionType" : "Enterprise"
  } ],
  "active" : true,
  "mfaProvider" : null,
  "createdAt" : {
    "nano" : 846000000,
    "epochSecond" : 1592932105
  },
  "updatedAt" : null,
  "deletedAt" : null,
  "deleted" : false
}

Get Organization By Label

GET /organizations/label/{label:[-a-zA-Z0-9]{1,63}}

Authorization

Valid Authorization Bearer token required, along with a permission grant authorizing access to any referenced resources.

Path parameters

Parameter Type Optional Description

label

String

false

Query parameters

No parameters.

Request fields

No request body.

Response fields

Path Type Optional Description

id

String

false

name

String

true

Used for display purposes. Not unique or private.

io.netfoundry.common.util.validation.BasicPattern.

label

String

false

A short value, containing only letters, numbers and dashes, which could be used as a label in a vanity domain. This label uniquely identifies the Organization, and is the key by which organization users indicate the organization within which they intend to authenticate. Note: A deleted organization looses its label. Such organizations will have a label value that combines the organization id with the prior label value. This maintains the constraint that all organization labels are unique, and frees the prior organization label value for reclamation. Obviously a deleted organization’s label will no longer meet the validation constraints of a live organization label.

Must match the regular expression \p{Alnum}|\p{Alnum}[-\p{Alnum}]{0,61}\p{Alnum}.

identityProviders

Array[Object]

false

identityProviders[].id

String

false

identityProviders[].organizationId

String

false

The id of the {@link Organization} that this provider will authenticate users into.

identityProviders[].auth0ConnectionId

String

false

The auth0 generated id of the auth0 connection that this IdentityProvider represents.

Size must be between 1 and 128 inclusive.

identityProviders[].name

String

false

Used for display purposes. Not unique or private.

Size must be between 1 and 128 inclusive.

identityProviders[].auth0ConnectionType

String

false

Must be one of [Database, Social, Enterprise, Passwordless].

active

Boolean

true

mfaProvider

String

true

Specifies an Auth0 compliant MFA provider. When set, it will trigger MFA on authentication via Auth0. If null, then the organization does not require MFA.

Must be one of [None, GoogleAuthenticator].

createdAt

Object

false

updatedAt

Object

false

deletedAt

Object

true

deleted

Boolean

true

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/organizations/label/ACME-0' -i -X GET \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJmd1NRcVhUZEwzS05NRkVMRXpmdm9BIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6ImJhNGYwODY0LTg5ZDQtNDI3ZS04MzEyLWY3OGM2YzRlNzBmZSIsImF1ZCI6ImlkZW50aXR5IiwiaWF0IjoxNTkyOTMyMTA5LCJleHAiOjE1OTI5MzU3MDksInBvbGljaWVzIjpbeyJyZXNvdXJjZXMiOlsibmZybjoqIl0sImFjdGlvbnMiOlsiKjoqIl19XSwiZ3JhbnRzLXN1cGVyIjoiW3tcImlkXCI6XCI4MDY5OTJmNC0yYzc2LTQxMDctOTA5YS0yYWIzOGRmNWVjNTlcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCJjMDJiNDhiMy1iMmI0LTRlZDAtYjhhNC1hNjYxMzIwZTFkM2ZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDl9LHtcImlkXCI6XCIxNjFlOTU2Mi0wMWI2LTRlMTEtYmY0Zi1kNTgzMzhkYzNjZDNcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCIwODIxMTRiNy1hZGVhLTQ5MjYtOTY3NC1lNjBmZTJhODM2MGJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJlZDA3MTE0OS05MDQ4LTQ2YmItYWNjNC1mMDllMzk2ZDM5MjJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJlMzNiN2YyYS1mODVhLTQzZWMtOTEwOC02N2Y5M2I4NjFkMmFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCIzOWNiMzVjZi05NzExLTQxNzQtOTg0Zi1jZjgxYWIyNGJmNmJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCJjOTM2NWEwNS04YzMwLTRkMDQtYTAxMy1jZTAwODljNWZlZWNcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCJjMGQwZDg4NC1kOWE2LTRjODItYmU1ZC1mY2ExNWFiODUyNTBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCI1N2FiN2ZmMi00MTQ3LTQ3NWEtOTFhZC04YmM2Nzc3MjRlNjZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCIzZGYzOTU3Ni0yZmZmLTRiYzItYmNiNS03NjNhMWU1ZDg4ZWFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCJiNmYzNTI5Yi04ODc2LTQ5NjUtYmQ2ZC02ODIzY2VhYzdlOGRcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCIzNGYxMDg0MC1jYmY1LTRjMWQtOWI0Yy1jMjA0OGYzZjQ3NThcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCIyZmNlNzU2My1lYjk0LTRhMjEtOTAzMS02ZDQwNDhmZjE5YTdcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJjMmQxODBiMC04MjdhLTRlYzEtYjU4Zi01NWU0ZjcwMTY5NDZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCI5ZjIyNGUwNS04MmZiLTQ4ODgtOTY1YS0yMmE2ZGE4MjNhOTFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCJjMWRlMjk2Ni0xZmJmLTRmNTEtYmNhMi05YjU3OTYxMzIzMjBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDV9LHtcImlkXCI6XCIxNDU0NjZlOC1hZTRkLTRiNTAtYjczOS04NWMyMThmOTBmZmRcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJiMTY1Y2MxNS0xNGQ2LTQwYzItODg4My0xZTRiMTU3MTBkMDJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCI1ZTIzZmI2My00ZWE4LTQzMjQtODU0NS01NGY0Yzc1MTlhODJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCJiZDYyYmNlYy02MGY5LTQwNzUtOTExMS1mNjM1NTI0OGE5ZmRcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCJkMjQ2ODliZC03NWZmLTQ4MzYtOTM0Ni03ODYwOWFlMmZmOGVcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCJkZDUzYWU3NS01MzA2LTRhNDktOWE5Yi1iNjAzZDdmOTM0MDZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9XSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbXSIsImdyYW50cy1hY3Rpb24iOiJbXSIsImdyYW50cy1zdGFuZGFyZCI6IltdIn0.DYoyXIrGErgRy-6l5ldvATdXdHSd8tULsgCOIbSQdeI-lblz0xd_mjdX3ks06tek-O2Kt0mtHdHH-xfEHx15RmDLxpyNzjEM7AJj6ll9IilRC6kh9pW2JfC4BNy4QoKYo7ZMuDUczGqLJOJ-D1aXHTFVGbpacNyYiatTqOftoOIexe93aUDxwJh5kdib8RrfeZCoXl3dK54qzVztO7aD1RhKBogmcXF0CNimub2Hmhl3Upqm3kh_QFsw8gWrdv63yVri2NJCBBI4whgxAY8xelsImZLSf8fa6MZn7JMUHhVZ82rsK11l29_srJdy9ZZmq-Kkzvk-tAoajpQUguKcDQ'

Example response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 839

{
  "id" : "f20456a7-e2c0-4abf-a358-250644369772",
  "name" : "ACME International, Inc.",
  "label" : "ACME-0",
  "identityProviders" : [ {
    "id" : "4e26c2d8-01ba-4f4f-ba83-8415f68df9ff",
    "organizationId" : "f20456a7-e2c0-4abf-a358-250644369772",
    "auth0ConnectionId" : "auth0-opaque-connectionId-2",
    "name" : "Google-Account",
    "auth0ConnectionType" : "Social"
  }, {
    "id" : "eb0d6f6a-2950-4f80-b00a-26ccad664f80",
    "organizationId" : "f20456a7-e2c0-4abf-a358-250644369772",
    "auth0ConnectionId" : "auth0-opaque-connectionId-1",
    "name" : "ACME Federated Active Directory",
    "auth0ConnectionType" : "Enterprise"
  } ],
  "active" : true,
  "mfaProvider" : null,
  "createdAt" : {
    "nano" : 846000000,
    "epochSecond" : 1592932105
  },
  "updatedAt" : null,
  "deletedAt" : null,
  "deleted" : false
}

Create Organization

POST /organizations

Authorization

Valid Authorization Bearer token required, along with a permission grant authorizing access to any referenced resources.

Path parameters

No parameters.

Query parameters

No parameters.

Request fields

Path Type Optional Description

name

String

true

io.netfoundry.common.util.validation.ValidAs.

label

String

false

Must match the regular expression \p{Alnum}|\p{Alnum}[-\p{Alnum}]{0,61}\p{Alnum}.

auth0ConnectionId

String

false

Size must be between 1 and 128 inclusive.

identityProviderName

String

false

Size must be between 1 and 128 inclusive.

auth0ConnectionType

String

false

Must be one of [Database, Social, Enterprise, Passwordless].

Response fields

Path Type Optional Description

id

String

false

name

String

true

Used for display purposes. Not unique or private.

io.netfoundry.common.util.validation.BasicPattern.

label

String

false

A short value, containing only letters, numbers and dashes, which could be used as a label in a vanity domain. This label uniquely identifies the Organization, and is the key by which organization users indicate the organization within which they intend to authenticate. Note: A deleted organization looses its label. Such organizations will have a label value that combines the organization id with the prior label value. This maintains the constraint that all organization labels are unique, and frees the prior organization label value for reclamation. Obviously a deleted organization’s label will no longer meet the validation constraints of a live organization label.

Must match the regular expression \p{Alnum}|\p{Alnum}[-\p{Alnum}]{0,61}\p{Alnum}.

identityProviders

Array[Object]

false

identityProviders[].id

String

false

identityProviders[].organizationId

String

false

The id of the {@link Organization} that this provider will authenticate users into.

identityProviders[].auth0ConnectionId

String

false

The auth0 generated id of the auth0 connection that this IdentityProvider represents.

Size must be between 1 and 128 inclusive.

identityProviders[].name

String

false

Used for display purposes. Not unique or private.

Size must be between 1 and 128 inclusive.

identityProviders[].auth0ConnectionType

String

false

Must be one of [Database, Social, Enterprise, Passwordless].

active

Boolean

true

mfaProvider

String

true

Specifies an Auth0 compliant MFA provider. When set, it will trigger MFA on authentication via Auth0. If null, then the organization does not require MFA.

Must be one of [None, GoogleAuthenticator].

createdAt

Object

false

updatedAt

Object

false

deletedAt

Object

true

deleted

Boolean

true

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/organizations' -i -X POST \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJIMHBRaUE5M2J5ZFNOZjd2MGg3ZmN3IiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6ImJhNGYwODY0LTg5ZDQtNDI3ZS04MzEyLWY3OGM2YzRlNzBmZSIsImF1ZCI6ImlkZW50aXR5IiwiaWF0IjoxNTkyOTMyMTA4LCJleHAiOjE1OTI5MzU3MDgsInBvbGljaWVzIjpbeyJyZXNvdXJjZXMiOlsibmZybjoqIl0sImFjdGlvbnMiOlsiKjoqIl19XSwiZ3JhbnRzLXN1cGVyIjoiW3tcImlkXCI6XCI4MDY5OTJmNC0yYzc2LTQxMDctOTA5YS0yYWIzOGRmNWVjNTlcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCIxNjFlOTU2Mi0wMWI2LTRlMTEtYmY0Zi1kNTgzMzhkYzNjZDNcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCIwODIxMTRiNy1hZGVhLTQ5MjYtOTY3NC1lNjBmZTJhODM2MGJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJlZDA3MTE0OS05MDQ4LTQ2YmItYWNjNC1mMDllMzk2ZDM5MjJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJlMzNiN2YyYS1mODVhLTQzZWMtOTEwOC02N2Y5M2I4NjFkMmFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCIzOWNiMzVjZi05NzExLTQxNzQtOTg0Zi1jZjgxYWIyNGJmNmJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCJjOTM2NWEwNS04YzMwLTRkMDQtYTAxMy1jZTAwODljNWZlZWNcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCJjMGQwZDg4NC1kOWE2LTRjODItYmU1ZC1mY2ExNWFiODUyNTBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCI1N2FiN2ZmMi00MTQ3LTQ3NWEtOTFhZC04YmM2Nzc3MjRlNjZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCIzZGYzOTU3Ni0yZmZmLTRiYzItYmNiNS03NjNhMWU1ZDg4ZWFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCJiNmYzNTI5Yi04ODc2LTQ5NjUtYmQ2ZC02ODIzY2VhYzdlOGRcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCIzNGYxMDg0MC1jYmY1LTRjMWQtOWI0Yy1jMjA0OGYzZjQ3NThcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCIyZmNlNzU2My1lYjk0LTRhMjEtOTAzMS02ZDQwNDhmZjE5YTdcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJjMmQxODBiMC04MjdhLTRlYzEtYjU4Zi01NWU0ZjcwMTY5NDZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCI5ZjIyNGUwNS04MmZiLTQ4ODgtOTY1YS0yMmE2ZGE4MjNhOTFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCJjMWRlMjk2Ni0xZmJmLTRmNTEtYmNhMi05YjU3OTYxMzIzMjBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDV9LHtcImlkXCI6XCIxNDU0NjZlOC1hZTRkLTRiNTAtYjczOS04NWMyMThmOTBmZmRcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJiMTY1Y2MxNS0xNGQ2LTQwYzItODg4My0xZTRiMTU3MTBkMDJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCI1ZTIzZmI2My00ZWE4LTQzMjQtODU0NS01NGY0Yzc1MTlhODJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCJiZDYyYmNlYy02MGY5LTQwNzUtOTExMS1mNjM1NTI0OGE5ZmRcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCJkMjQ2ODliZC03NWZmLTQ4MzYtOTM0Ni03ODYwOWFlMmZmOGVcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCJkZDUzYWU3NS01MzA2LTRhNDktOWE5Yi1iNjAzZDdmOTM0MDZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9XSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbXSIsImdyYW50cy1hY3Rpb24iOiJbXSIsImdyYW50cy1zdGFuZGFyZCI6IltdIn0.Q3LVo7EKfOUipCuVNAyODGIays5g41OamV9iWNvIUF8Y5XdESdUtqztl9eTZq8OAmmhsPjItTqC4DjTrPuGfW04K3V-PDi6amyni-xMwS5yAc9v7RiYwfUsOS7iM-IhCKS0XVbls1AahzCTiMqb_UXwshl_JrwAG601WDaAbm7cMLAm6q2zavwNLqNGUMfGv69ygXPGkmafDkpr_MBmBMiz6Ur4JUxGjC3FjuXRz98srs5m7pUF0f233ZGyu9KPC9wEMzSdwjuB2ccsqAKDOFbar0L_vXdHKbpRRddeND2JlRQKyJiVMb9shyJl_Oyick7rVuouRyihmjpScu_L0Bw' \
    -d '{"name":"Best Corp.","label":"BEST-CORP","auth0ConnectionId":"auth0-opaque-connection","identityProviderName":"Corp SAML","auth0ConnectionType":"Enterprise"}'

Example response

HTTP/1.1 201 Created
Content-Type: application/json;charset=UTF-8
Content-Length: 555

{
  "id" : "7356a198-035c-448d-805e-d816a62fafd7",
  "name" : "Best Corp.",
  "label" : "BEST-CORP",
  "identityProviders" : [ {
    "id" : "276cbcfb-35a0-40d6-b254-63cf269b83cb",
    "organizationId" : "7356a198-035c-448d-805e-d816a62fafd7",
    "auth0ConnectionId" : "auth0-opaque-connection",
    "name" : "Corp SAML",
    "auth0ConnectionType" : "Enterprise"
  } ],
  "active" : true,
  "mfaProvider" : null,
  "createdAt" : {
    "nano" : 87000000,
    "epochSecond" : 1592932109
  },
  "updatedAt" : null,
  "deletedAt" : null,
  "deleted" : false
}

Activate Or Deactivate Organization

PUT /organizations/{id}/{action:activate|deactivate}

Authorization

Valid Authorization Bearer token required, along with a permission grant authorizing access to any referenced resources.

Path parameters

Parameter Type Optional Description

id

Object

false

Client must have update-active action on the annotated resource.

action

String

false

Query parameters

No parameters.

Request fields

No request body.

Response fields

Path Type Optional Description

id

String

false

name

String

true

Used for display purposes. Not unique or private.

io.netfoundry.common.util.validation.BasicPattern.

label

String

false

A short value, containing only letters, numbers and dashes, which could be used as a label in a vanity domain. This label uniquely identifies the Organization, and is the key by which organization users indicate the organization within which they intend to authenticate. Note: A deleted organization looses its label. Such organizations will have a label value that combines the organization id with the prior label value. This maintains the constraint that all organization labels are unique, and frees the prior organization label value for reclamation. Obviously a deleted organization’s label will no longer meet the validation constraints of a live organization label.

Must match the regular expression \p{Alnum}|\p{Alnum}[-\p{Alnum}]{0,61}\p{Alnum}.

identityProviders

Array[Object]

false

identityProviders[].id

String

false

identityProviders[].organizationId

String

false

The id of the {@link Organization} that this provider will authenticate users into.

identityProviders[].auth0ConnectionId

String

false

The auth0 generated id of the auth0 connection that this IdentityProvider represents.

Size must be between 1 and 128 inclusive.

identityProviders[].name

String

false

Used for display purposes. Not unique or private.

Size must be between 1 and 128 inclusive.

identityProviders[].auth0ConnectionType

String

false

Must be one of [Database, Social, Enterprise, Passwordless].

active

Boolean

true

mfaProvider

String

true

Specifies an Auth0 compliant MFA provider. When set, it will trigger MFA on authentication via Auth0. If null, then the organization does not require MFA.

Must be one of [None, GoogleAuthenticator].

createdAt

Object

false

updatedAt

Object

false

deletedAt

Object

true

deleted

Boolean

true

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/organizations/22abe455-a4b1-48e1-ae8d-8f9f10ac8554/deactivate' -i -X PUT \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJHNkV0b09mOGM3a0RLWlZzMjFsZ1l3IiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6ImJhNGYwODY0LTg5ZDQtNDI3ZS04MzEyLWY3OGM2YzRlNzBmZSIsImF1ZCI6ImlkZW50aXR5IiwiaWF0IjoxNTkyOTMyMTA5LCJleHAiOjE1OTI5MzU3MDksInBvbGljaWVzIjpbeyJyZXNvdXJjZXMiOlsibmZybjoqIl0sImFjdGlvbnMiOlsiKjoqIl19XSwiZ3JhbnRzLXN1cGVyIjoiW3tcImlkXCI6XCJlZDA3MTE0OS05MDQ4LTQ2YmItYWNjNC1mMDllMzk2ZDM5MjJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCI0YjYzOWNmOC00MDU4LTQ4MDEtYWQzZS05N2M4N2Y3ZWQzNzBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDl9LHtcImlkXCI6XCI1N2FiN2ZmMi00MTQ3LTQ3NWEtOTFhZC04YmM2Nzc3MjRlNjZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCIzNGYxMDg0MC1jYmY1LTRjMWQtOWI0Yy1jMjA0OGYzZjQ3NThcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCJjYmY4OTAyMS05ZTUyLTRjOWQtYjA0Yi04YmYzMTdlNmQ1YTBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDl9LHtcImlkXCI6XCIxNDU0NjZlOC1hZTRkLTRiNTAtYjczOS04NWMyMThmOTBmZmRcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJiMTY1Y2MxNS0xNGQ2LTQwYzItODg4My0xZTRiMTU3MTBkMDJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCJiZDYyYmNlYy02MGY5LTQwNzUtOTExMS1mNjM1NTI0OGE5ZmRcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCI1ZTIzZmI2My00ZWE4LTQzMjQtODU0NS01NGY0Yzc1MTlhODJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCJkMjQ2ODliZC03NWZmLTQ4MzYtOTM0Ni03ODYwOWFlMmZmOGVcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCI4MDY5OTJmNC0yYzc2LTQxMDctOTA5YS0yYWIzOGRmNWVjNTlcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCJjMDJiNDhiMy1iMmI0LTRlZDAtYjhhNC1hNjYxMzIwZTFkM2ZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDl9LHtcImlkXCI6XCIxNjFlOTU2Mi0wMWI2LTRlMTEtYmY0Zi1kNTgzMzhkYzNjZDNcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCI4MTljYzhiZS0zYTk1LTRjMzYtYTAxNC00ZmQ0OGUxMWU3N2JcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDl9LHtcImlkXCI6XCIwODIxMTRiNy1hZGVhLTQ5MjYtOTY3NC1lNjBmZTJhODM2MGJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJiZDM2NjZlMy1lMTJjLTRkMTktODI5MS04MzM3NjY2ZDVhYTBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDl9LHtcImlkXCI6XCJlMzNiN2YyYS1mODVhLTQzZWMtOTEwOC02N2Y5M2I4NjFkMmFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCIzOWNiMzVjZi05NzExLTQxNzQtOTg0Zi1jZjgxYWIyNGJmNmJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCJjOTM2NWEwNS04YzMwLTRkMDQtYTAxMy1jZTAwODljNWZlZWNcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCJjMGQwZDg4NC1kOWE2LTRjODItYmU1ZC1mY2ExNWFiODUyNTBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCIzZGYzOTU3Ni0yZmZmLTRiYzItYmNiNS03NjNhMWU1ZDg4ZWFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCJiNmYzNTI5Yi04ODc2LTQ5NjUtYmQ2ZC02ODIzY2VhYzdlOGRcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCIyZmNlNzU2My1lYjk0LTRhMjEtOTAzMS02ZDQwNDhmZjE5YTdcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJjMmQxODBiMC04MjdhLTRlYzEtYjU4Zi01NWU0ZjcwMTY5NDZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCI5ZjIyNGUwNS04MmZiLTQ4ODgtOTY1YS0yMmE2ZGE4MjNhOTFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCJjMWRlMjk2Ni0xZmJmLTRmNTEtYmNhMi05YjU3OTYxMzIzMjBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDV9LHtcImlkXCI6XCJkZDUzYWU3NS01MzA2LTRhNDktOWE5Yi1iNjAzZDdmOTM0MDZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCJmOTgxN2Y2YS1lZDY3LTQ5N2QtYjAxMC02NTdkMGEyYjNiNzlcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDl9LHtcImlkXCI6XCI0NzYyYmYyZS1iMDM0LTQ1MjAtYmEyZS1kNTk3OGNmYTQxOTFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDl9XSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbXSIsImdyYW50cy1hY3Rpb24iOiJbXSIsImdyYW50cy1zdGFuZGFyZCI6IltdIn0.A8VUAEJRAcLkBEWfkbf-jh8OhFMSFE8UryGv6GPR6zl2qzWEd1ZaaNYu0DS4wnLklEfDpTeXntw-1ZOA-apZpeshHKo7a5s7cBpLXc-U-J-Ovo02-P05vk97iwMMSM57MnlExdcNca6U-VXBlW1GSXfadf6mEr2s9RAawU43wmdRbSgnPasi0KGaGr1wArxysrfYWJapGHs2tBgInbwJdBtmN7gqfbHyHFa8PvrGGcNQbe2HeuGVA3IxzFY3u_9UVAzf6v_BwI-NqDccXKbxGwPJJrsinV6dJYknuB3mI89JmlQ115P4pdYxdjP62r6WaJuAiWuzlQH1NeusvmX_Cw'

Example response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 635

{
  "id" : "22abe455-a4b1-48e1-ae8d-8f9f10ac8554",
  "name" : "World Wide Imports",
  "label" : "WW-Imports-47",
  "identityProviders" : [ {
    "id" : "bc86166c-0be1-4348-88d2-40d2b3cd1faa",
    "organizationId" : "22abe455-a4b1-48e1-ae8d-8f9f10ac8554",
    "auth0ConnectionId" : "auth0-opaque-connectionId-48",
    "name" : "Username/Password",
    "auth0ConnectionType" : "Database"
  } ],
  "active" : false,
  "mfaProvider" : null,
  "createdAt" : {
    "nano" : 973000000,
    "epochSecond" : 1592932109
  },
  "updatedAt" : {
    "nano" : 54000000,
    "epochSecond" : 1592932110
  },
  "deletedAt" : null,
  "deleted" : false
}

Add Identity Provider

POST /organizations/{id}/identity-providers

Authorization

Valid Authorization Bearer token required, along with a permission grant authorizing access to any referenced resources.

Path parameters

Parameter Type Optional Description

id

Object

false

Client must have create-identity-provider action on the annotated resource.

Query parameters

No parameters.

Request fields

Path Type Optional Description

auth0ConnectionId

String

false

Size must be between 1 and 128 inclusive.

identityProviderName

String

false

Size must be between 1 and 128 inclusive.

auth0ConnectionType

String

false

Must be one of [Database, Social, Enterprise, Passwordless].

Response fields

Path Type Optional Description

id

String

false

name

String

true

Used for display purposes. Not unique or private.

io.netfoundry.common.util.validation.BasicPattern.

label

String

false

A short value, containing only letters, numbers and dashes, which could be used as a label in a vanity domain. This label uniquely identifies the Organization, and is the key by which organization users indicate the organization within which they intend to authenticate. Note: A deleted organization looses its label. Such organizations will have a label value that combines the organization id with the prior label value. This maintains the constraint that all organization labels are unique, and frees the prior organization label value for reclamation. Obviously a deleted organization’s label will no longer meet the validation constraints of a live organization label.

Must match the regular expression \p{Alnum}|\p{Alnum}[-\p{Alnum}]{0,61}\p{Alnum}.

identityProviders

Array[Object]

false

identityProviders[].id

String

false

identityProviders[].organizationId

String

false

The id of the {@link Organization} that this provider will authenticate users into.

identityProviders[].auth0ConnectionId

String

false

The auth0 generated id of the auth0 connection that this IdentityProvider represents.

Size must be between 1 and 128 inclusive.

identityProviders[].name

String

false

Used for display purposes. Not unique or private.

Size must be between 1 and 128 inclusive.

identityProviders[].auth0ConnectionType

String

false

Must be one of [Database, Social, Enterprise, Passwordless].

active

Boolean

true

mfaProvider

String

true

Specifies an Auth0 compliant MFA provider. When set, it will trigger MFA on authentication via Auth0. If null, then the organization does not require MFA.

Must be one of [None, GoogleAuthenticator].

createdAt

Object

false

updatedAt

Object

false

deletedAt

Object

true

deleted

Boolean

true

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/organizations/a9f7f74b-c6eb-40e4-9b71-4234e3a841e3/identity-providers' -i -X POST \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJMY0ttenhJTFUzVEptb01QOTFGU3pBIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6ImJhNGYwODY0LTg5ZDQtNDI3ZS04MzEyLWY3OGM2YzRlNzBmZSIsImF1ZCI6ImlkZW50aXR5IiwiaWF0IjoxNTkyOTMyMTA5LCJleHAiOjE1OTI5MzU3MDksInBvbGljaWVzIjpbeyJyZXNvdXJjZXMiOlsibmZybjoqIl0sImFjdGlvbnMiOlsiKjoqIl19XSwiZ3JhbnRzLXN1cGVyIjoiW3tcImlkXCI6XCJlZDA3MTE0OS05MDQ4LTQ2YmItYWNjNC1mMDllMzk2ZDM5MjJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCI0YjYzOWNmOC00MDU4LTQ4MDEtYWQzZS05N2M4N2Y3ZWQzNzBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDl9LHtcImlkXCI6XCI1N2FiN2ZmMi00MTQ3LTQ3NWEtOTFhZC04YmM2Nzc3MjRlNjZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCIzNGYxMDg0MC1jYmY1LTRjMWQtOWI0Yy1jMjA0OGYzZjQ3NThcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCJjYmY4OTAyMS05ZTUyLTRjOWQtYjA0Yi04YmYzMTdlNmQ1YTBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDl9LHtcImlkXCI6XCIxNDU0NjZlOC1hZTRkLTRiNTAtYjczOS04NWMyMThmOTBmZmRcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJiMTY1Y2MxNS0xNGQ2LTQwYzItODg4My0xZTRiMTU3MTBkMDJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCJiZDYyYmNlYy02MGY5LTQwNzUtOTExMS1mNjM1NTI0OGE5ZmRcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCI1ZTIzZmI2My00ZWE4LTQzMjQtODU0NS01NGY0Yzc1MTlhODJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCJkMjQ2ODliZC03NWZmLTQ4MzYtOTM0Ni03ODYwOWFlMmZmOGVcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCI4MDY5OTJmNC0yYzc2LTQxMDctOTA5YS0yYWIzOGRmNWVjNTlcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCJjMDJiNDhiMy1iMmI0LTRlZDAtYjhhNC1hNjYxMzIwZTFkM2ZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDl9LHtcImlkXCI6XCIxNjFlOTU2Mi0wMWI2LTRlMTEtYmY0Zi1kNTgzMzhkYzNjZDNcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCI4MTljYzhiZS0zYTk1LTRjMzYtYTAxNC00ZmQ0OGUxMWU3N2JcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDl9LHtcImlkXCI6XCIwODIxMTRiNy1hZGVhLTQ5MjYtOTY3NC1lNjBmZTJhODM2MGJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJiZDM2NjZlMy1lMTJjLTRkMTktODI5MS04MzM3NjY2ZDVhYTBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDl9LHtcImlkXCI6XCJlMzNiN2YyYS1mODVhLTQzZWMtOTEwOC02N2Y5M2I4NjFkMmFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCIzOWNiMzVjZi05NzExLTQxNzQtOTg0Zi1jZjgxYWIyNGJmNmJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCJjOTM2NWEwNS04YzMwLTRkMDQtYTAxMy1jZTAwODljNWZlZWNcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCJjMGQwZDg4NC1kOWE2LTRjODItYmU1ZC1mY2ExNWFiODUyNTBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCIzZGYzOTU3Ni0yZmZmLTRiYzItYmNiNS03NjNhMWU1ZDg4ZWFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCJiNmYzNTI5Yi04ODc2LTQ5NjUtYmQ2ZC02ODIzY2VhYzdlOGRcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCIyZmNlNzU2My1lYjk0LTRhMjEtOTAzMS02ZDQwNDhmZjE5YTdcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJjMmQxODBiMC04MjdhLTRlYzEtYjU4Zi01NWU0ZjcwMTY5NDZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCI5ZjIyNGUwNS04MmZiLTQ4ODgtOTY1YS0yMmE2ZGE4MjNhOTFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCJjMWRlMjk2Ni0xZmJmLTRmNTEtYmNhMi05YjU3OTYxMzIzMjBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDV9LHtcImlkXCI6XCJkZDUzYWU3NS01MzA2LTRhNDktOWE5Yi1iNjAzZDdmOTM0MDZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCJmOTgxN2Y2YS1lZDY3LTQ5N2QtYjAxMC02NTdkMGEyYjNiNzlcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDl9XSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbXSIsImdyYW50cy1hY3Rpb24iOiJbXSIsImdyYW50cy1zdGFuZGFyZCI6IltdIn0.S-iMgFcs90NhB-HeKQRcNktIE1pV5uTXpDnGswSsXa19C3ncBxdY3VyQ7KYYV2_rnJg8_8cn91nCq8lHg0LdbbwvSfUoeeriqXR_vPFCf9QUTdqor1jkxMikurhwK6uXxzFnT8zWSCPsxmb4bwu6Qp47Ws97y9PhmrX1ojy4PyXtxi7K83YOQj1QKOR_IHRP_osHYIpamx9ulJYj7VYc4z-Z4Ene7k_dmxfYaiev_d18rfzNFCwBAaahkhZoHHpvAgyaLkpa4TPr0jiZl4tVefJKoRgqIAwWEQl3d3asCzBG9N0TENpkiO5KOynMLZ8BeoIaKFGvULp37utwAO_C-Q' \
    -d '{"auth0ConnectionId":"auth0-opaque-connection","identityProviderName":"Corp SAML","auth0ConnectionType":"Enterprise"}'

Example response

HTTP/1.1 201 Created
Content-Type: application/json;charset=UTF-8
Content-Length: 820

{
  "id" : "a9f7f74b-c6eb-40e4-9b71-4234e3a841e3",
  "name" : "World Wide Imports",
  "label" : "WW-Imports-45",
  "identityProviders" : [ {
    "id" : "3187edb5-e172-4558-a9e7-d3e4d5025535",
    "organizationId" : "a9f7f74b-c6eb-40e4-9b71-4234e3a841e3",
    "auth0ConnectionId" : "auth0-opaque-connection",
    "name" : "Corp SAML",
    "auth0ConnectionType" : "Enterprise"
  }, {
    "id" : "02229bb1-a97f-4eb2-bec8-aa671948bb49",
    "organizationId" : "a9f7f74b-c6eb-40e4-9b71-4234e3a841e3",
    "auth0ConnectionId" : "auth0-opaque-connectionId-46",
    "name" : "Username/Password",
    "auth0ConnectionType" : "Database"
  } ],
  "active" : true,
  "mfaProvider" : null,
  "createdAt" : {
    "nano" : 785000000,
    "epochSecond" : 1592932109
  },
  "updatedAt" : null,
  "deletedAt" : null,
  "deleted" : false
}

User Identity

Find User Identities

GET /user-identities

Returns a set of {@link UserIdentity}s that are visible to the requesting client and optionally filtered based on the submitted request parameters.

Authorization

Valid Authorization Bearer token required, along with a permission grant authorizing access to any referenced resources.

Path parameters

No parameters.

Query parameters

Supports standard paging query parameters.

Parameter Type Optional Description

tenantId

Object

true

Deprecated..

organizationId

Object

true

Restricts results to Identities in the specified Organization (by Organization’s id.).

firstName

String

true

lastName

String

true

email

String

true

active

Boolean

true

Restricts results to Identities with a matching active status.

includeDeleted

Boolean

true

Default value: 'false'.

Request fields

No request body.

Response fields

Standard paging response where content field is list of following objects:

Path Type Optional Description

id

String

false

organizationId

String

false

firstName

String

true

io.netfoundry.common.util.validation.BasicPattern.

lastName

String

true

io.netfoundry.common.util.validation.BasicPattern.

email

String

false

Size must be between 6 and 254 inclusive.

identityMappings

Array[Object]

false

identityMappings[].id

String

false

identityMappings[].auth0UserId

String

false

Size must be between 4 and 256 inclusive.

identityMappings[].identityProviderId

String

false

identityMappings[].userIdentityId

String

false

active

Boolean

true

createdAt

Object

false

deletedAt

Object

true

Returns the date that the identity was deleted or null if the identity has not been deleted. Note, identities are marked as deleted and not returned from searches unless explicitly requested.

tenantId

String

true

Deprecated. The Tenant resource has been renamed to Organization. Use getOrganizationId().

Returns the id of the {@link Organization} that this identity is a member of.

name

String

true

type

String

true

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/user-identities' -i -X GET \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJsSXNHZ2xKOFZNeHlXRHZzSWNyNURnIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6ImJhNGYwODY0LTg5ZDQtNDI3ZS04MzEyLWY3OGM2YzRlNzBmZSIsImF1ZCI6ImlkZW50aXR5IiwiaWF0IjoxNTkyOTMyMTExLCJleHAiOjE1OTI5MzU3MTEsInBvbGljaWVzIjpbeyJyZXNvdXJjZXMiOlsibmZybjoqIl0sImFjdGlvbnMiOlsiKjoqIl19XSwiZ3JhbnRzLXN1cGVyIjoiW3tcImlkXCI6XCI4M2Q0NjI5MS02ZjZhLTRmYzEtOWVhZS1hZGQyMjYyMzczZjFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTF9LHtcImlkXCI6XCIxMzJlMTc4OS1kNDRhLTQ3NjQtYThiMC1kOWMwNTE0NjZkM2VcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTB9LHtcImlkXCI6XCJlZDA3MTE0OS05MDQ4LTQ2YmItYWNjNC1mMDllMzk2ZDM5MjJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJkZmQxYTUyOC1jMjI0LTRiYWMtOWJjNi0wMjU3NDRlYTJlZGVcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTB9LHtcImlkXCI6XCI0YjYzOWNmOC00MDU4LTQ4MDEtYWQzZS05N2M4N2Y3ZWQzNzBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDl9LHtcImlkXCI6XCI1N2FiN2ZmMi00MTQ3LTQ3NWEtOTFhZC04YmM2Nzc3MjRlNjZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCI1YTE0MDg3Ni0wMTQ3LTQ1YjItOWFlYy1iMDQ4ZjAwNDA1ZTZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTF9LHtcImlkXCI6XCIzNGYxMDg0MC1jYmY1LTRjMWQtOWI0Yy1jMjA0OGYzZjQ3NThcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCJiMjgyMjgxNy1hZGVjLTRhNDMtODIzZi0yZTI1MjIwOWI1ZWJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTB9LHtcImlkXCI6XCJjYmY4OTAyMS05ZTUyLTRjOWQtYjA0Yi04YmYzMTdlNmQ1YTBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDl9LHtcImlkXCI6XCIyN2UxNGZiZC1hMDY1LTRlYmItYjRmOC00MGY3ZDg2NGQ0NWRcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTB9LHtcImlkXCI6XCI1OTcyMjcyZS0yZTQwLTQyNzUtYjRjYS1mOGY2ZDgzZTVlOWJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTB9LHtcImlkXCI6XCIxNDU0NjZlOC1hZTRkLTRiNTAtYjczOS04NWMyMThmOTBmZmRcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJhNTViYjIyOS1iZWIxLTRjOWEtOWEwMi02Mjc3NzY0Zjk5MDhcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTB9LHtcImlkXCI6XCJiMTY1Y2MxNS0xNGQ2LTQwYzItODg4My0xZTRiMTU3MTBkMDJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCI1YTk1NzMzZS0wY2YxLTRiZTctYjQ3My1hNTIyYzM5Y2E0OGNcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTB9LHtcImlkXCI6XCJiZDYyYmNlYy02MGY5LTQwNzUtOTExMS1mNjM1NTI0OGE5ZmRcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCI1ZTIzZmI2My00ZWE4LTQzMjQtODU0NS01NGY0Yzc1MTlhODJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCJkMjQ2ODliZC03NWZmLTQ4MzYtOTM0Ni03ODYwOWFlMmZmOGVcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCI4MDY5OTJmNC0yYzc2LTQxMDctOTA5YS0yYWIzOGRmNWVjNTlcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCJjMDJiNDhiMy1iMmI0LTRlZDAtYjhhNC1hNjYxMzIwZTFkM2ZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDl9LHtcImlkXCI6XCIxNjFlOTU2Mi0wMWI2LTRlMTEtYmY0Zi1kNTgzMzhkYzNjZDNcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCI4MTljYzhiZS0zYTk1LTRjMzYtYTAxNC00ZmQ0OGUxMWU3N2JcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDl9LHtcImlkXCI6XCIwODIxMTRiNy1hZGVhLTQ5MjYtOTY3NC1lNjBmZTJhODM2MGJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCI2ODQzOWNlYy0zN2E0LTQ3MmMtYmQ5My01MGIzODRiYmVhZGFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTB9LHtcImlkXCI6XCJiZDM2NjZlMy1lMTJjLTRkMTktODI5MS04MzM3NjY2ZDVhYTBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDl9LHtcImlkXCI6XCJlMzNiN2YyYS1mODVhLTQzZWMtOTEwOC02N2Y5M2I4NjFkMmFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCIzOWNiMzVjZi05NzExLTQxNzQtOTg0Zi1jZjgxYWIyNGJmNmJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCJjOTM2NWEwNS04YzMwLTRkMDQtYTAxMy1jZTAwODljNWZlZWNcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCJiNDMyZjMyYy1jMWQ3LTQ1MzctOTI0Ny02MDg3ZjA5NTJjNmZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTF9LHtcImlkXCI6XCJhM2E0NjNhMS02NzlkLTRlMjctYjRjYi1hMDllMTY4OTE4OWFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTB9LHtcImlkXCI6XCJjMGQwZDg4NC1kOWE2LTRjODItYmU1ZC1mY2ExNWFiODUyNTBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCIzZGYzOTU3Ni0yZmZmLTRiYzItYmNiNS03NjNhMWU1ZDg4ZWFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCJiNmYzNTI5Yi04ODc2LTQ5NjUtYmQ2ZC02ODIzY2VhYzdlOGRcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCIyZmNlNzU2My1lYjk0LTRhMjEtOTAzMS02ZDQwNDhmZjE5YTdcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJjMmQxODBiMC04MjdhLTRlYzEtYjU4Zi01NWU0ZjcwMTY5NDZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCI5ZjIyNGUwNS04MmZiLTQ4ODgtOTY1YS0yMmE2ZGE4MjNhOTFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCJjMWRlMjk2Ni0xZmJmLTRmNTEtYmNhMi05YjU3OTYxMzIzMjBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDV9LHtcImlkXCI6XCJkZDUzYWU3NS01MzA2LTRhNDktOWE5Yi1iNjAzZDdmOTM0MDZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCJmOTgxN2Y2YS1lZDY3LTQ5N2QtYjAxMC02NTdkMGEyYjNiNzlcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDl9LHtcImlkXCI6XCI0NzYyYmYyZS1iMDM0LTQ1MjAtYmEyZS1kNTk3OGNmYTQxOTFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDl9XSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbXSIsImdyYW50cy1hY3Rpb24iOiJbXSIsImdyYW50cy1zdGFuZGFyZCI6IltdIn0.il9UTPXuBOdJLiL6nYbQrBBNGpedOoCrLEyf6abd3b3Bi45JSvRfvS0qWnKv57w0gcnt0WaHgWvofVA8UTHrSEELOhJzrWDD2w2lJ5JUsBk-yB6pDdiu-dopjmFi7zpLfKlorZXQZpN4nK22o6vR28U2vmPK0eVnxL9tzzvcOIo4iY61QYsq8_UH64l3y7pFAFZACnSS3m9siPMXIRrPce3_S5knSibQ9rL_SuMwefycdtUy-nAwJAzLQBW-wTUt8IQdkGxdfzgN7Zbi9upNUT9VKwqgoY2H5KQ3oim5ZFDIgO3b6p340bjIMk_TxhXCQk4btpCJVXC0C0UXU3oJow'

Example response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 2053

[ {
  "id" : "8fa7308e-175b-40d4-a752-67430695864c",
  "organizationId" : "f20456a7-e2c0-4abf-a358-250644369772",
  "firstName" : "John",
  "lastName" : "Doe",
  "email" : "john.doe@acme.com",
  "identityMappings" : [ {
    "id" : "beb6da1d-4ffe-4997-9e70-266ef370969d",
    "auth0UserId" : "auth0-opaque-userId-3",
    "identityProviderId" : "eb0d6f6a-2950-4f80-b00a-26ccad664f80",
    "userIdentityId" : "8fa7308e-175b-40d4-a752-67430695864c"
  } ],
  "active" : true,
  "createdAt" : {
    "nano" : 853000000,
    "epochSecond" : 1592932105
  },
  "deletedAt" : null,
  "tenantId" : "f20456a7-e2c0-4abf-a358-250644369772",
  "name" : "John Doe",
  "type" : "UserIdentity"
}, {
  "id" : "ba4f0864-89d4-427e-8312-f78c6c4e70fe",
  "organizationId" : "f20456a7-e2c0-4abf-a358-250644369772",
  "firstName" : "TESTING",
  "lastName" : "CLIENT",
  "email" : "test.client@server.com",
  "identityMappings" : [ {
    "id" : "c08b1f64-b027-45ab-aa73-e25ef979a85e",
    "auth0UserId" : "auth0-opaque-userId-6",
    "identityProviderId" : "4e26c2d8-01ba-4f4f-ba83-8415f68df9ff",
    "userIdentityId" : "ba4f0864-89d4-427e-8312-f78c6c4e70fe"
  } ],
  "active" : true,
  "createdAt" : {
    "nano" : 860000000,
    "epochSecond" : 1592932105
  },
  "deletedAt" : null,
  "tenantId" : "f20456a7-e2c0-4abf-a358-250644369772",
  "name" : "TESTING CLIENT",
  "type" : "UserIdentity"
}, {
  "id" : "67403fb3-cded-4a20-a146-df4c2b493c45",
  "organizationId" : "f20456a7-e2c0-4abf-a358-250644369772",
  "firstName" : "First",
  "lastName" : "Last",
  "email" : "random-30@acme.com",
  "identityMappings" : [ {
    "id" : "5635ed0e-4817-43f3-b7bf-f74449160880",
    "auth0UserId" : "auth0-opaque-userId-31",
    "identityProviderId" : "4e26c2d8-01ba-4f4f-ba83-8415f68df9ff",
    "userIdentityId" : "67403fb3-cded-4a20-a146-df4c2b493c45"
  } ],
  "active" : true,
  "createdAt" : {
    "nano" : 100000000,
    "epochSecond" : 1592932108
  },
  "deletedAt" : null,
  "tenantId" : "f20456a7-e2c0-4abf-a358-250644369772",
  "name" : "First Last",
  "type" : "UserIdentity"
} ]

Get User Identity

GET /user-identities/{id:[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}}

Get an User Identity by its id.

Authorization

Valid Authorization Bearer token required, along with a permission grant authorizing access to any referenced resources.

Path parameters

Parameter Type Optional Description

id

Object

false

The id of the desired Identity.

Client must have read action on the annotated resource.

Query parameters

No parameters.

Request fields

No request body.

Response fields

Path Type Optional Description

id

String

false

organizationId

String

false

firstName

String

true

io.netfoundry.common.util.validation.BasicPattern.

lastName

String

true

io.netfoundry.common.util.validation.BasicPattern.

email

String

false

Size must be between 6 and 254 inclusive.

identityMappings

Array[Object]

false

identityMappings[].id

String

false

identityMappings[].auth0UserId

String

false

Size must be between 4 and 256 inclusive.

identityMappings[].identityProviderId

String

false

identityMappings[].userIdentityId

String

false

active

Boolean

true

createdAt

Object

false

deletedAt

Object

true

Returns the date that the identity was deleted or null if the identity has not been deleted. Note, identities are marked as deleted and not returned from searches unless explicitly requested.

tenantId

String

true

Deprecated. The Tenant resource has been renamed to Organization. Use getOrganizationId().

Returns the id of the {@link Organization} that this identity is a member of.

name

String

true

type

String

true

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/user-identities/8fa7308e-175b-40d4-a752-67430695864c' -i -X GET \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJkWEdQMjExT0dFQjFzcnp2OGJJYllBIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6ImJhNGYwODY0LTg5ZDQtNDI3ZS04MzEyLWY3OGM2YzRlNzBmZSIsImF1ZCI6ImlkZW50aXR5IiwiaWF0IjoxNTkyOTMyMTExLCJleHAiOjE1OTI5MzU3MTEsInBvbGljaWVzIjpbeyJyZXNvdXJjZXMiOlsibmZybjoqIl0sImFjdGlvbnMiOlsiKjoqIl19XSwiZ3JhbnRzLXN1cGVyIjoiW3tcImlkXCI6XCI4M2Q0NjI5MS02ZjZhLTRmYzEtOWVhZS1hZGQyMjYyMzczZjFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTF9LHtcImlkXCI6XCIxMzJlMTc4OS1kNDRhLTQ3NjQtYThiMC1kOWMwNTE0NjZkM2VcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTB9LHtcImlkXCI6XCJlZDA3MTE0OS05MDQ4LTQ2YmItYWNjNC1mMDllMzk2ZDM5MjJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJkZmQxYTUyOC1jMjI0LTRiYWMtOWJjNi0wMjU3NDRlYTJlZGVcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTB9LHtcImlkXCI6XCI0YjYzOWNmOC00MDU4LTQ4MDEtYWQzZS05N2M4N2Y3ZWQzNzBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDl9LHtcImlkXCI6XCI1N2FiN2ZmMi00MTQ3LTQ3NWEtOTFhZC04YmM2Nzc3MjRlNjZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCI1YTE0MDg3Ni0wMTQ3LTQ1YjItOWFlYy1iMDQ4ZjAwNDA1ZTZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTF9LHtcImlkXCI6XCIzNGYxMDg0MC1jYmY1LTRjMWQtOWI0Yy1jMjA0OGYzZjQ3NThcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCJiMjgyMjgxNy1hZGVjLTRhNDMtODIzZi0yZTI1MjIwOWI1ZWJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTB9LHtcImlkXCI6XCJjYmY4OTAyMS05ZTUyLTRjOWQtYjA0Yi04YmYzMTdlNmQ1YTBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDl9LHtcImlkXCI6XCIyN2UxNGZiZC1hMDY1LTRlYmItYjRmOC00MGY3ZDg2NGQ0NWRcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTB9LHtcImlkXCI6XCI1OTcyMjcyZS0yZTQwLTQyNzUtYjRjYS1mOGY2ZDgzZTVlOWJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTB9LHtcImlkXCI6XCIxNDU0NjZlOC1hZTRkLTRiNTAtYjczOS04NWMyMThmOTBmZmRcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJhNTViYjIyOS1iZWIxLTRjOWEtOWEwMi02Mjc3NzY0Zjk5MDhcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTB9LHtcImlkXCI6XCJlMjAyODI4MC02NjNlLTRkZTItYWI2NS04NDE1ZTIxMGU1M2NcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTF9LHtcImlkXCI6XCJiMTY1Y2MxNS0xNGQ2LTQwYzItODg4My0xZTRiMTU3MTBkMDJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCI1YTk1NzMzZS0wY2YxLTRiZTctYjQ3My1hNTIyYzM5Y2E0OGNcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTB9LHtcImlkXCI6XCJiZDYyYmNlYy02MGY5LTQwNzUtOTExMS1mNjM1NTI0OGE5ZmRcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCI1ZTIzZmI2My00ZWE4LTQzMjQtODU0NS01NGY0Yzc1MTlhODJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCJkMjQ2ODliZC03NWZmLTQ4MzYtOTM0Ni03ODYwOWFlMmZmOGVcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCI4MDY5OTJmNC0yYzc2LTQxMDctOTA5YS0yYWIzOGRmNWVjNTlcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCJjMDJiNDhiMy1iMmI0LTRlZDAtYjhhNC1hNjYxMzIwZTFkM2ZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDl9LHtcImlkXCI6XCIxNjFlOTU2Mi0wMWI2LTRlMTEtYmY0Zi1kNTgzMzhkYzNjZDNcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCI4MTljYzhiZS0zYTk1LTRjMzYtYTAxNC00ZmQ0OGUxMWU3N2JcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDl9LHtcImlkXCI6XCIwODIxMTRiNy1hZGVhLTQ5MjYtOTY3NC1lNjBmZTJhODM2MGJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCI2ODQzOWNlYy0zN2E0LTQ3MmMtYmQ5My01MGIzODRiYmVhZGFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTB9LHtcImlkXCI6XCJiZDM2NjZlMy1lMTJjLTRkMTktODI5MS04MzM3NjY2ZDVhYTBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDl9LHtcImlkXCI6XCIxMDQ3YjBmNy05OWM0LTQ2YTItOGVmZi0yYzY4ZGQwOTI5NDRcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTF9LHtcImlkXCI6XCJlMzNiN2YyYS1mODVhLTQzZWMtOTEwOC02N2Y5M2I4NjFkMmFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCIzOWNiMzVjZi05NzExLTQxNzQtOTg0Zi1jZjgxYWIyNGJmNmJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCJjOTM2NWEwNS04YzMwLTRkMDQtYTAxMy1jZTAwODljNWZlZWNcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCJiNDMyZjMyYy1jMWQ3LTQ1MzctOTI0Ny02MDg3ZjA5NTJjNmZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTF9LHtcImlkXCI6XCJhM2E0NjNhMS02NzlkLTRlMjctYjRjYi1hMDllMTY4OTE4OWFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTB9LHtcImlkXCI6XCJjMGQwZDg4NC1kOWE2LTRjODItYmU1ZC1mY2ExNWFiODUyNTBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCIzZGYzOTU3Ni0yZmZmLTRiYzItYmNiNS03NjNhMWU1ZDg4ZWFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCJiNmYzNTI5Yi04ODc2LTQ5NjUtYmQ2ZC02ODIzY2VhYzdlOGRcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCIyZmNlNzU2My1lYjk0LTRhMjEtOTAzMS02ZDQwNDhmZjE5YTdcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJjMmQxODBiMC04MjdhLTRlYzEtYjU4Zi01NWU0ZjcwMTY5NDZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCI5ZjIyNGUwNS04MmZiLTQ4ODgtOTY1YS0yMmE2ZGE4MjNhOTFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCJjMWRlMjk2Ni0xZmJmLTRmNTEtYmNhMi05YjU3OTYxMzIzMjBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDV9LHtcImlkXCI6XCJkZDUzYWU3NS01MzA2LTRhNDktOWE5Yi1iNjAzZDdmOTM0MDZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCJmOTgxN2Y2YS1lZDY3LTQ5N2QtYjAxMC02NTdkMGEyYjNiNzlcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDl9LHtcImlkXCI6XCI0NzYyYmYyZS1iMDM0LTQ1MjAtYmEyZS1kNTk3OGNmYTQxOTFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDl9XSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbXSIsImdyYW50cy1hY3Rpb24iOiJbXSIsImdyYW50cy1zdGFuZGFyZCI6IltdIn0.PqRmLN8hODmcUEr_olhn2-drACjIGS_I9AsrQw-ReTAlRndxsWtZTzPsjlORrWCLrUU-vAcyNlYWLVhaw78Cokh5JzPGWX86gO6Lws8B47jNp_PUGLTRgoZCjdYtQGE3UrfJqwICt8L20fsR0gjHyh4cf7goQ1WZ2j9UCWtxelWvCNHUUSEh2PqtZ39s0_jLWa1UkUZ1RAW5j-CZekKBaaoMCPosFUpTw0NWjct0u-KoxV7cXJaMP_VfJTZyKSyx1iQQNrSNJDkUzfjyL1c1Dh2p_3Cki3PsKz27TrXUHxZriwm3Ys1Nqs56FpzDAcEbEck25M672OEtz8ThjRbTAQ'

Example response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 674

{
  "id" : "8fa7308e-175b-40d4-a752-67430695864c",
  "organizationId" : "f20456a7-e2c0-4abf-a358-250644369772",
  "firstName" : "John",
  "lastName" : "Doe",
  "email" : "john.doe@acme.com",
  "identityMappings" : [ {
    "id" : "beb6da1d-4ffe-4997-9e70-266ef370969d",
    "auth0UserId" : "auth0-opaque-userId-3",
    "identityProviderId" : "eb0d6f6a-2950-4f80-b00a-26ccad664f80",
    "userIdentityId" : "8fa7308e-175b-40d4-a752-67430695864c"
  } ],
  "active" : true,
  "createdAt" : {
    "nano" : 853000000,
    "epochSecond" : 1592932105
  },
  "deletedAt" : null,
  "tenantId" : "f20456a7-e2c0-4abf-a358-250644369772",
  "name" : "John Doe",
  "type" : "UserIdentity"
}

Get User Identity By Mapping

GET /user-identities/mapping/{auth0UserId}/{identityProviderId}

Authorization

Valid Authorization Bearer token required, along with a permission grant authorizing access to any referenced resources.

Path parameters

Parameter Type Optional Description

auth0UserId

String

false

identityProviderId

Object

false

Query parameters

No parameters.

Request fields

No request body.

Response fields

Path Type Optional Description

id

String

false

organizationId

String

false

firstName

String

true

io.netfoundry.common.util.validation.BasicPattern.

lastName

String

true

io.netfoundry.common.util.validation.BasicPattern.

email

String

false

Size must be between 6 and 254 inclusive.

identityMappings

Array[Object]

false

identityMappings[].id

String

false

identityMappings[].auth0UserId

String

false

Size must be between 4 and 256 inclusive.

identityMappings[].identityProviderId

String

false

identityMappings[].userIdentityId

String

false

active

Boolean

true

createdAt

Object

false

deletedAt

Object

true

Returns the date that the identity was deleted or null if the identity has not been deleted. Note, identities are marked as deleted and not returned from searches unless explicitly requested.

tenantId

String

true

Deprecated. The Tenant resource has been renamed to Organization. Use getOrganizationId().

Returns the id of the {@link Organization} that this identity is a member of.

name

String

true

type

String

true

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/user-identities/mapping/auth0-opaque-userId-3/eb0d6f6a-2950-4f80-b00a-26ccad664f80' -i -X GET \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiI0WWZiRkwxejJncFhrYTNpcGVoeFNRIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6ImJhNGYwODY0LTg5ZDQtNDI3ZS04MzEyLWY3OGM2YzRlNzBmZSIsImF1ZCI6ImlkZW50aXR5IiwiaWF0IjoxNTkyOTMyMTExLCJleHAiOjE1OTI5MzU3MTEsInBvbGljaWVzIjpbeyJyZXNvdXJjZXMiOlsibmZybjoqIl0sImFjdGlvbnMiOlsiKjoqIl19XSwiZ3JhbnRzLXN1cGVyIjoiW3tcImlkXCI6XCI4M2Q0NjI5MS02ZjZhLTRmYzEtOWVhZS1hZGQyMjYyMzczZjFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTF9LHtcImlkXCI6XCIxMzJlMTc4OS1kNDRhLTQ3NjQtYThiMC1kOWMwNTE0NjZkM2VcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTB9LHtcImlkXCI6XCJlZDA3MTE0OS05MDQ4LTQ2YmItYWNjNC1mMDllMzk2ZDM5MjJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJkZmQxYTUyOC1jMjI0LTRiYWMtOWJjNi0wMjU3NDRlYTJlZGVcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTB9LHtcImlkXCI6XCI0YjYzOWNmOC00MDU4LTQ4MDEtYWQzZS05N2M4N2Y3ZWQzNzBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDl9LHtcImlkXCI6XCI1N2FiN2ZmMi00MTQ3LTQ3NWEtOTFhZC04YmM2Nzc3MjRlNjZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCI1YTE0MDg3Ni0wMTQ3LTQ1YjItOWFlYy1iMDQ4ZjAwNDA1ZTZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTF9LHtcImlkXCI6XCIzNGYxMDg0MC1jYmY1LTRjMWQtOWI0Yy1jMjA0OGYzZjQ3NThcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCJiMjgyMjgxNy1hZGVjLTRhNDMtODIzZi0yZTI1MjIwOWI1ZWJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTB9LHtcImlkXCI6XCJjYmY4OTAyMS05ZTUyLTRjOWQtYjA0Yi04YmYzMTdlNmQ1YTBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDl9LHtcImlkXCI6XCIyN2UxNGZiZC1hMDY1LTRlYmItYjRmOC00MGY3ZDg2NGQ0NWRcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTB9LHtcImlkXCI6XCI1OTcyMjcyZS0yZTQwLTQyNzUtYjRjYS1mOGY2ZDgzZTVlOWJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTB9LHtcImlkXCI6XCIxNDU0NjZlOC1hZTRkLTRiNTAtYjczOS04NWMyMThmOTBmZmRcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJhNTViYjIyOS1iZWIxLTRjOWEtOWEwMi02Mjc3NzY0Zjk5MDhcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTB9LHtcImlkXCI6XCJlMjAyODI4MC02NjNlLTRkZTItYWI2NS04NDE1ZTIxMGU1M2NcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTF9LHtcImlkXCI6XCJiMTY1Y2MxNS0xNGQ2LTQwYzItODg4My0xZTRiMTU3MTBkMDJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCI1YTk1NzMzZS0wY2YxLTRiZTctYjQ3My1hNTIyYzM5Y2E0OGNcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTB9LHtcImlkXCI6XCJiZDYyYmNlYy02MGY5LTQwNzUtOTExMS1mNjM1NTI0OGE5ZmRcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCI1ZTIzZmI2My00ZWE4LTQzMjQtODU0NS01NGY0Yzc1MTlhODJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCJkMjQ2ODliZC03NWZmLTQ4MzYtOTM0Ni03ODYwOWFlMmZmOGVcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCI4MDY5OTJmNC0yYzc2LTQxMDctOTA5YS0yYWIzOGRmNWVjNTlcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCJjMDJiNDhiMy1iMmI0LTRlZDAtYjhhNC1hNjYxMzIwZTFkM2ZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDl9LHtcImlkXCI6XCIxNjFlOTU2Mi0wMWI2LTRlMTEtYmY0Zi1kNTgzMzhkYzNjZDNcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCI4MTljYzhiZS0zYTk1LTRjMzYtYTAxNC00ZmQ0OGUxMWU3N2JcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDl9LHtcImlkXCI6XCIwODIxMTRiNy1hZGVhLTQ5MjYtOTY3NC1lNjBmZTJhODM2MGJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCI3YjJmMGFlYy05YjIwLTQxNWQtYjJmZS00NzZmZDc3ZTkzMmRcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTF9LHtcImlkXCI6XCI2ODQzOWNlYy0zN2E0LTQ3MmMtYmQ5My01MGIzODRiYmVhZGFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTB9LHtcImlkXCI6XCJiZDM2NjZlMy1lMTJjLTRkMTktODI5MS04MzM3NjY2ZDVhYTBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDl9LHtcImlkXCI6XCIxMDQ3YjBmNy05OWM0LTQ2YTItOGVmZi0yYzY4ZGQwOTI5NDRcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTF9LHtcImlkXCI6XCJlMzNiN2YyYS1mODVhLTQzZWMtOTEwOC02N2Y5M2I4NjFkMmFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCIzOWNiMzVjZi05NzExLTQxNzQtOTg0Zi1jZjgxYWIyNGJmNmJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCJjOTM2NWEwNS04YzMwLTRkMDQtYTAxMy1jZTAwODljNWZlZWNcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCJiNDMyZjMyYy1jMWQ3LTQ1MzctOTI0Ny02MDg3ZjA5NTJjNmZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTF9LHtcImlkXCI6XCJhM2E0NjNhMS02NzlkLTRlMjctYjRjYi1hMDllMTY4OTE4OWFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTB9LHtcImlkXCI6XCJjMGQwZDg4NC1kOWE2LTRjODItYmU1ZC1mY2ExNWFiODUyNTBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCIzZGYzOTU3Ni0yZmZmLTRiYzItYmNiNS03NjNhMWU1ZDg4ZWFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCJiNmYzNTI5Yi04ODc2LTQ5NjUtYmQ2ZC02ODIzY2VhYzdlOGRcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCIyZmNlNzU2My1lYjk0LTRhMjEtOTAzMS02ZDQwNDhmZjE5YTdcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJjMmQxODBiMC04MjdhLTRlYzEtYjU4Zi01NWU0ZjcwMTY5NDZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCI5ZjIyNGUwNS04MmZiLTQ4ODgtOTY1YS0yMmE2ZGE4MjNhOTFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCJjMWRlMjk2Ni0xZmJmLTRmNTEtYmNhMi05YjU3OTYxMzIzMjBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDV9LHtcImlkXCI6XCJkZDUzYWU3NS01MzA2LTRhNDktOWE5Yi1iNjAzZDdmOTM0MDZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCJmOTgxN2Y2YS1lZDY3LTQ5N2QtYjAxMC02NTdkMGEyYjNiNzlcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDl9LHtcImlkXCI6XCI0NzYyYmYyZS1iMDM0LTQ1MjAtYmEyZS1kNTk3OGNmYTQxOTFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDl9XSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbXSIsImdyYW50cy1hY3Rpb24iOiJbXSIsImdyYW50cy1zdGFuZGFyZCI6IltdIn0.hAaiArDYwfSF1TbHIXEXae4SGvPuBTmdxrdj-MQomAFg8RYde2WX5wlcdbzFwDcSjdkxGBm2rXOk0qi4x1FVCJC2P6qMn6nLcjNGCk0ql_qfHBzU-SrXvIFD9B8rqhzYXGMYrxPITnc5E7Ge4lOOjxGmLxiAkHEbXrLv1jcrW0s0Lynx0fl8kZR9EBK9NtVVHw4bquJDnnGL3KGL732f5vIK4E1ivYiA8aZk5PbZnXqCw6-3ew92KFNesVXFggvF5tYaN9_VN7rdnACJ7Q50p9vQZ_ECVSE-uG8vId0xeYTCOhNsJhF8HFmwAyg3XOkU3t6bwAHkiTsliR-iBDvtJw'

Example response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 674

{
  "id" : "8fa7308e-175b-40d4-a752-67430695864c",
  "organizationId" : "f20456a7-e2c0-4abf-a358-250644369772",
  "firstName" : "John",
  "lastName" : "Doe",
  "email" : "john.doe@acme.com",
  "identityMappings" : [ {
    "id" : "beb6da1d-4ffe-4997-9e70-266ef370969d",
    "auth0UserId" : "auth0-opaque-userId-3",
    "identityProviderId" : "eb0d6f6a-2950-4f80-b00a-26ccad664f80",
    "userIdentityId" : "8fa7308e-175b-40d4-a752-67430695864c"
  } ],
  "active" : true,
  "createdAt" : {
    "nano" : 853000000,
    "epochSecond" : 1592932105
  },
  "deletedAt" : null,
  "tenantId" : "f20456a7-e2c0-4abf-a358-250644369772",
  "name" : "John Doe",
  "type" : "UserIdentity"
}

Create Identity

POST /user-identities

Authorization

Valid Authorization Bearer token required, along with a permission grant authorizing access to any referenced resources.

Path parameters

No parameters.

Query parameters

No parameters.

Request fields

Path Type Optional Description

organizationId

String

false

Client must have create action under the annotated resource.

firstName

String

true

io.netfoundry.common.util.validation.ValidAs.

lastName

String

true

io.netfoundry.common.util.validation.ValidAs.

email

String

false

Size must be between 6 and 254 inclusive.

Response fields

Path Type Optional Description

id

String

false

organizationId

String

false

firstName

String

true

io.netfoundry.common.util.validation.BasicPattern.

lastName

String

true

io.netfoundry.common.util.validation.BasicPattern.

email

String

false

Size must be between 6 and 254 inclusive.

identityMappings

Array[Object]

false

identityMappings[].id

String

false

identityMappings[].auth0UserId

String

false

Size must be between 4 and 256 inclusive.

identityMappings[].identityProviderId

String

false

identityMappings[].userIdentityId

String

false

active

Boolean

true

createdAt

Object

false

deletedAt

Object

true

Returns the date that the identity was deleted or null if the identity has not been deleted. Note, identities are marked as deleted and not returned from searches unless explicitly requested.

tenantId

String

true

Deprecated. The Tenant resource has been renamed to Organization. Use getOrganizationId().

Returns the id of the {@link Organization} that this identity is a member of.

name

String

true

type

String

true

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/user-identities' -i -X POST \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJzblZubFhDZlR3ajZTbHNXQU1mWHhnIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6ImJhNGYwODY0LTg5ZDQtNDI3ZS04MzEyLWY3OGM2YzRlNzBmZSIsImF1ZCI6ImlkZW50aXR5IiwiaWF0IjoxNTkyOTMyMTExLCJleHAiOjE1OTI5MzU3MTEsInBvbGljaWVzIjpbeyJyZXNvdXJjZXMiOlsibmZybjoqIl0sImFjdGlvbnMiOlsiKjoqIl19XSwiZ3JhbnRzLXN1cGVyIjoiW3tcImlkXCI6XCI4M2Q0NjI5MS02ZjZhLTRmYzEtOWVhZS1hZGQyMjYyMzczZjFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTF9LHtcImlkXCI6XCIxMzJlMTc4OS1kNDRhLTQ3NjQtYThiMC1kOWMwNTE0NjZkM2VcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTB9LHtcImlkXCI6XCJlZDA3MTE0OS05MDQ4LTQ2YmItYWNjNC1mMDllMzk2ZDM5MjJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJkZmQxYTUyOC1jMjI0LTRiYWMtOWJjNi0wMjU3NDRlYTJlZGVcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTB9LHtcImlkXCI6XCI0YjYzOWNmOC00MDU4LTQ4MDEtYWQzZS05N2M4N2Y3ZWQzNzBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDl9LHtcImlkXCI6XCI1N2FiN2ZmMi00MTQ3LTQ3NWEtOTFhZC04YmM2Nzc3MjRlNjZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCI1YTE0MDg3Ni0wMTQ3LTQ1YjItOWFlYy1iMDQ4ZjAwNDA1ZTZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTF9LHtcImlkXCI6XCIzNGYxMDg0MC1jYmY1LTRjMWQtOWI0Yy1jMjA0OGYzZjQ3NThcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCI1MjJlOTdhOC1kZjZjLTQ1ZTktYTAyZi1kYTY0OGJiYjM4NGNcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTF9LHtcImlkXCI6XCJiMjgyMjgxNy1hZGVjLTRhNDMtODIzZi0yZTI1MjIwOWI1ZWJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTB9LHtcImlkXCI6XCJjYmY4OTAyMS05ZTUyLTRjOWQtYjA0Yi04YmYzMTdlNmQ1YTBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDl9LHtcImlkXCI6XCIyN2UxNGZiZC1hMDY1LTRlYmItYjRmOC00MGY3ZDg2NGQ0NWRcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTB9LHtcImlkXCI6XCI1OTcyMjcyZS0yZTQwLTQyNzUtYjRjYS1mOGY2ZDgzZTVlOWJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTB9LHtcImlkXCI6XCIxNDU0NjZlOC1hZTRkLTRiNTAtYjczOS04NWMyMThmOTBmZmRcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJhNTViYjIyOS1iZWIxLTRjOWEtOWEwMi02Mjc3NzY0Zjk5MDhcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTB9LHtcImlkXCI6XCJlMjAyODI4MC02NjNlLTRkZTItYWI2NS04NDE1ZTIxMGU1M2NcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTF9LHtcImlkXCI6XCJiMTY1Y2MxNS0xNGQ2LTQwYzItODg4My0xZTRiMTU3MTBkMDJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCI1YTk1NzMzZS0wY2YxLTRiZTctYjQ3My1hNTIyYzM5Y2E0OGNcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTB9LHtcImlkXCI6XCJiZDYyYmNlYy02MGY5LTQwNzUtOTExMS1mNjM1NTI0OGE5ZmRcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCI1ZTIzZmI2My00ZWE4LTQzMjQtODU0NS01NGY0Yzc1MTlhODJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCJkMjQ2ODliZC03NWZmLTQ4MzYtOTM0Ni03ODYwOWFlMmZmOGVcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCI4MDY5OTJmNC0yYzc2LTQxMDctOTA5YS0yYWIzOGRmNWVjNTlcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCJjMDJiNDhiMy1iMmI0LTRlZDAtYjhhNC1hNjYxMzIwZTFkM2ZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDl9LHtcImlkXCI6XCIxNjFlOTU2Mi0wMWI2LTRlMTEtYmY0Zi1kNTgzMzhkYzNjZDNcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCI4MTljYzhiZS0zYTk1LTRjMzYtYTAxNC00ZmQ0OGUxMWU3N2JcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDl9LHtcImlkXCI6XCIwODIxMTRiNy1hZGVhLTQ5MjYtOTY3NC1lNjBmZTJhODM2MGJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCI3YjJmMGFlYy05YjIwLTQxNWQtYjJmZS00NzZmZDc3ZTkzMmRcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTF9LHtcImlkXCI6XCI2ODQzOWNlYy0zN2E0LTQ3MmMtYmQ5My01MGIzODRiYmVhZGFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTB9LHtcImlkXCI6XCJiZDM2NjZlMy1lMTJjLTRkMTktODI5MS04MzM3NjY2ZDVhYTBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDl9LHtcImlkXCI6XCIxMDQ3YjBmNy05OWM0LTQ2YTItOGVmZi0yYzY4ZGQwOTI5NDRcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTF9LHtcImlkXCI6XCJlMzNiN2YyYS1mODVhLTQzZWMtOTEwOC02N2Y5M2I4NjFkMmFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCIzOWNiMzVjZi05NzExLTQxNzQtOTg0Zi1jZjgxYWIyNGJmNmJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCJjOTM2NWEwNS04YzMwLTRkMDQtYTAxMy1jZTAwODljNWZlZWNcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCJiNDMyZjMyYy1jMWQ3LTQ1MzctOTI0Ny02MDg3ZjA5NTJjNmZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTF9LHtcImlkXCI6XCJhM2E0NjNhMS02NzlkLTRlMjctYjRjYi1hMDllMTY4OTE4OWFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTB9LHtcImlkXCI6XCJjMGQwZDg4NC1kOWE2LTRjODItYmU1ZC1mY2ExNWFiODUyNTBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCIzZGYzOTU3Ni0yZmZmLTRiYzItYmNiNS03NjNhMWU1ZDg4ZWFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCJiNmYzNTI5Yi04ODc2LTQ5NjUtYmQ2ZC02ODIzY2VhYzdlOGRcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCIyZmNlNzU2My1lYjk0LTRhMjEtOTAzMS02ZDQwNDhmZjE5YTdcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJjMmQxODBiMC04MjdhLTRlYzEtYjU4Zi01NWU0ZjcwMTY5NDZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCI5ZjIyNGUwNS04MmZiLTQ4ODgtOTY1YS0yMmE2ZGE4MjNhOTFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCJjMWRlMjk2Ni0xZmJmLTRmNTEtYmNhMi05YjU3OTYxMzIzMjBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDV9LHtcImlkXCI6XCJkZDUzYWU3NS01MzA2LTRhNDktOWE5Yi1iNjAzZDdmOTM0MDZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCJmOTgxN2Y2YS1lZDY3LTQ5N2QtYjAxMC02NTdkMGEyYjNiNzlcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDl9LHtcImlkXCI6XCI0NzYyYmYyZS1iMDM0LTQ1MjAtYmEyZS1kNTk3OGNmYTQxOTFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDl9XSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbXSIsImdyYW50cy1hY3Rpb24iOiJbXSIsImdyYW50cy1zdGFuZGFyZCI6IltdIn0.MD4tKd3o7GMRXroq00CJQAKwiEQ8BsUulLAePD2EA0PZ8OkjiPY0XVjBCTE3wPAFj26KOi2lMyeXja3faYnZeVxDt3guKsR6SKXnQY10YqTxLaGuaohiiS3MYyy21vJ1r6KYAMHYyKT7ojHIp6kOTzUwXRDqxRJN6oCcLUi-Iq1x5A8SdzC1cM_d89ziZzoU72qaVgQJ0WZohQul5Twm2HjX4Z5uML-wmUQeZZf1NIvanKnAF-R39OGUCWuczoFhNVcwAQlv_lv_AH22LRGaKSqnUlyq45czEh5ZfJJ-a7inU07VvLRgpaAhUaRsaG-rqpoO5tuOM_Za0dgoqgmrDA' \
    -d '{"organizationId":"f20456a7-e2c0-4abf-a358-250644369772","firstName":"Jane","lastName":"Doe","email":"jane.doe@acme.com"}'

Example response

HTTP/1.1 201 Created
Content-Type: application/json;charset=UTF-8
Content-Length: 443

{
  "id" : "704c8d7c-7b08-45ae-b2ae-9b74b87af415",
  "organizationId" : "f20456a7-e2c0-4abf-a358-250644369772",
  "firstName" : "Jane",
  "lastName" : "Doe",
  "email" : "jane.doe@acme.com",
  "identityMappings" : [ ],
  "active" : true,
  "createdAt" : {
    "nano" : 836000000,
    "epochSecond" : 1592932111
  },
  "deletedAt" : null,
  "tenantId" : "f20456a7-e2c0-4abf-a358-250644369772",
  "name" : "Jane Doe",
  "type" : "UserIdentity"
}

Update Identity Info

PUT /user-identities/{id}

Authorization

Valid Authorization Bearer token required, along with a permission grant authorizing access to any referenced resources.

Path parameters

Parameter Type Optional Description

id

Object

false

Client must have update action on the annotated resource.

Query parameters

No parameters.

Request fields

Path Type Optional Description

firstName

String

true

io.netfoundry.common.util.validation.ValidAs.

lastName

String

true

io.netfoundry.common.util.validation.ValidAs.

email

String

true

Size must be between 6 and 254 inclusive.

Response fields

Path Type Optional Description

id

String

false

organizationId

String

false

firstName

String

true

io.netfoundry.common.util.validation.BasicPattern.

lastName

String

true

io.netfoundry.common.util.validation.BasicPattern.

email

String

false

Size must be between 6 and 254 inclusive.

identityMappings

Array[Object]

false

identityMappings[].id

String

false

identityMappings[].auth0UserId

String

false

Size must be between 4 and 256 inclusive.

identityMappings[].identityProviderId

String

false

identityMappings[].userIdentityId

String

false

active

Boolean

true

createdAt

Object

false

deletedAt

Object

true

Returns the date that the identity was deleted or null if the identity has not been deleted. Note, identities are marked as deleted and not returned from searches unless explicitly requested.

tenantId

String

true

Deprecated. The Tenant resource has been renamed to Organization. Use getOrganizationId().

Returns the id of the {@link Organization} that this identity is a member of.

name

String

true

type

String

true

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/user-identities/6f665301-f1ae-435e-8ef5-8ef3ea506742' -i -X PUT \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJjczhiUllvODFqWFhXREhRckotOUZBIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6ImJhNGYwODY0LTg5ZDQtNDI3ZS04MzEyLWY3OGM2YzRlNzBmZSIsImF1ZCI6ImlkZW50aXR5IiwiaWF0IjoxNTkyOTMyMTExLCJleHAiOjE1OTI5MzU3MTEsInBvbGljaWVzIjpbeyJyZXNvdXJjZXMiOlsibmZybjoqIl0sImFjdGlvbnMiOlsiKjoqIl19XSwiZ3JhbnRzLXN1cGVyIjoiW3tcImlkXCI6XCI4M2Q0NjI5MS02ZjZhLTRmYzEtOWVhZS1hZGQyMjYyMzczZjFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTF9LHtcImlkXCI6XCIxMzJlMTc4OS1kNDRhLTQ3NjQtYThiMC1kOWMwNTE0NjZkM2VcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTB9LHtcImlkXCI6XCJlZDA3MTE0OS05MDQ4LTQ2YmItYWNjNC1mMDllMzk2ZDM5MjJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJkZmQxYTUyOC1jMjI0LTRiYWMtOWJjNi0wMjU3NDRlYTJlZGVcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTB9LHtcImlkXCI6XCI0YjYzOWNmOC00MDU4LTQ4MDEtYWQzZS05N2M4N2Y3ZWQzNzBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDl9LHtcImlkXCI6XCI1N2FiN2ZmMi00MTQ3LTQ3NWEtOTFhZC04YmM2Nzc3MjRlNjZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCIzNGYxMDg0MC1jYmY1LTRjMWQtOWI0Yy1jMjA0OGYzZjQ3NThcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCJiMjgyMjgxNy1hZGVjLTRhNDMtODIzZi0yZTI1MjIwOWI1ZWJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTB9LHtcImlkXCI6XCJjYmY4OTAyMS05ZTUyLTRjOWQtYjA0Yi04YmYzMTdlNmQ1YTBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDl9LHtcImlkXCI6XCIyN2UxNGZiZC1hMDY1LTRlYmItYjRmOC00MGY3ZDg2NGQ0NWRcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTB9LHtcImlkXCI6XCI1OTcyMjcyZS0yZTQwLTQyNzUtYjRjYS1mOGY2ZDgzZTVlOWJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTB9LHtcImlkXCI6XCIxNDU0NjZlOC1hZTRkLTRiNTAtYjczOS04NWMyMThmOTBmZmRcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJhNTViYjIyOS1iZWIxLTRjOWEtOWEwMi02Mjc3NzY0Zjk5MDhcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTB9LHtcImlkXCI6XCJiMTY1Y2MxNS0xNGQ2LTQwYzItODg4My0xZTRiMTU3MTBkMDJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCI1YTk1NzMzZS0wY2YxLTRiZTctYjQ3My1hNTIyYzM5Y2E0OGNcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTB9LHtcImlkXCI6XCJiZDYyYmNlYy02MGY5LTQwNzUtOTExMS1mNjM1NTI0OGE5ZmRcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCI1ZTIzZmI2My00ZWE4LTQzMjQtODU0NS01NGY0Yzc1MTlhODJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCJkMjQ2ODliZC03NWZmLTQ4MzYtOTM0Ni03ODYwOWFlMmZmOGVcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCI4MDY5OTJmNC0yYzc2LTQxMDctOTA5YS0yYWIzOGRmNWVjNTlcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCJjMDJiNDhiMy1iMmI0LTRlZDAtYjhhNC1hNjYxMzIwZTFkM2ZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDl9LHtcImlkXCI6XCIxNjFlOTU2Mi0wMWI2LTRlMTEtYmY0Zi1kNTgzMzhkYzNjZDNcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCI4MTljYzhiZS0zYTk1LTRjMzYtYTAxNC00ZmQ0OGUxMWU3N2JcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDl9LHtcImlkXCI6XCIwODIxMTRiNy1hZGVhLTQ5MjYtOTY3NC1lNjBmZTJhODM2MGJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCI2ODQzOWNlYy0zN2E0LTQ3MmMtYmQ5My01MGIzODRiYmVhZGFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTB9LHtcImlkXCI6XCJiZDM2NjZlMy1lMTJjLTRkMTktODI5MS04MzM3NjY2ZDVhYTBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDl9LHtcImlkXCI6XCJlMzNiN2YyYS1mODVhLTQzZWMtOTEwOC02N2Y5M2I4NjFkMmFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCIzOWNiMzVjZi05NzExLTQxNzQtOTg0Zi1jZjgxYWIyNGJmNmJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCJjOTM2NWEwNS04YzMwLTRkMDQtYTAxMy1jZTAwODljNWZlZWNcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCJhM2E0NjNhMS02NzlkLTRlMjctYjRjYi1hMDllMTY4OTE4OWFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTB9LHtcImlkXCI6XCJjMGQwZDg4NC1kOWE2LTRjODItYmU1ZC1mY2ExNWFiODUyNTBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCIzZGYzOTU3Ni0yZmZmLTRiYzItYmNiNS03NjNhMWU1ZDg4ZWFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCJiNmYzNTI5Yi04ODc2LTQ5NjUtYmQ2ZC02ODIzY2VhYzdlOGRcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCIyZmNlNzU2My1lYjk0LTRhMjEtOTAzMS02ZDQwNDhmZjE5YTdcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJjMmQxODBiMC04MjdhLTRlYzEtYjU4Zi01NWU0ZjcwMTY5NDZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCI5ZjIyNGUwNS04MmZiLTQ4ODgtOTY1YS0yMmE2ZGE4MjNhOTFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCJjMWRlMjk2Ni0xZmJmLTRmNTEtYmNhMi05YjU3OTYxMzIzMjBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDV9LHtcImlkXCI6XCJkZDUzYWU3NS01MzA2LTRhNDktOWE5Yi1iNjAzZDdmOTM0MDZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCJmOTgxN2Y2YS1lZDY3LTQ5N2QtYjAxMC02NTdkMGEyYjNiNzlcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDl9LHtcImlkXCI6XCI0NzYyYmYyZS1iMDM0LTQ1MjAtYmEyZS1kNTk3OGNmYTQxOTFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDl9XSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbXSIsImdyYW50cy1hY3Rpb24iOiJbXSIsImdyYW50cy1zdGFuZGFyZCI6IltdIn0.ocHfhJon0Ge9wJ_989nJaMFrQg_kymnDmDGpy_ckM7V1di2j9fxsPOnwyzSYyOEmffedpdhxuvDepPJkLy46bR49kQW4F7ZlblNQrLYq5lfhksTB_KOqFNY7GumSGsij3awxtoPBF-Z-zSrEJVp3oCd-ercP2jVnCoUeAXUlKxEO8iLANa79SXYDnaYPmoFuK1vcPE5u_DhBAaEdoKBdSEwACdl3Ca0089Bi5CoN7dGcolOL7KDQSMlGZDSzaiVSG5Ggy1q8Qsglbm4rwtR3n-SfW8CEt2r4jAUCw44Kyxo0hEETqe7o_E38L8qXh-Z0McLmvsCTf9ealX4KohJ-cg' \
    -d '{"firstName":"Bobby","lastName":"White","email":"bobby.white@acme.com"}'

Example response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 683

{
  "id" : "6f665301-f1ae-435e-8ef5-8ef3ea506742",
  "organizationId" : "f20456a7-e2c0-4abf-a358-250644369772",
  "firstName" : "Bobby",
  "lastName" : "White",
  "email" : "bobby.white@acme.com",
  "identityMappings" : [ {
    "id" : "a975a39d-bb59-4ef1-b238-16f469c9d9ce",
    "auth0UserId" : "auth0-opaque-userId-64",
    "identityProviderId" : "4e26c2d8-01ba-4f4f-ba83-8415f68df9ff",
    "userIdentityId" : "6f665301-f1ae-435e-8ef5-8ef3ea506742"
  } ],
  "active" : true,
  "createdAt" : {
    "nano" : 28000000,
    "epochSecond" : 1592932111
  },
  "deletedAt" : null,
  "tenantId" : "f20456a7-e2c0-4abf-a358-250644369772",
  "name" : "Bobby White",
  "type" : "UserIdentity"
}

Activate Or Deactivate User Identity

PUT /user-identities/{id}/{action:activate|deactivate}

Authorization

Valid Authorization Bearer token required, along with a permission grant authorizing access to any referenced resources.

Path parameters

Parameter Type Optional Description

id

Object

false

Client must have update-active action on the annotated resource.

action

String

false

Query parameters

No parameters.

Request fields

No request body.

Response fields

Path Type Optional Description

id

String

false

organizationId

String

false

firstName

String

true

io.netfoundry.common.util.validation.BasicPattern.

lastName

String

true

io.netfoundry.common.util.validation.BasicPattern.

email

String

false

Size must be between 6 and 254 inclusive.

identityMappings

Array[Object]

false

identityMappings[].id

String

false

identityMappings[].auth0UserId

String

false

Size must be between 4 and 256 inclusive.

identityMappings[].identityProviderId

String

false

identityMappings[].userIdentityId

String

false

active

Boolean

true

createdAt

Object

false

deletedAt

Object

true

Returns the date that the identity was deleted or null if the identity has not been deleted. Note, identities are marked as deleted and not returned from searches unless explicitly requested.

tenantId

String

true

Deprecated. The Tenant resource has been renamed to Organization. Use getOrganizationId().

Returns the id of the {@link Organization} that this identity is a member of.

name

String

true

type

String

true

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/user-identities/62052822-dabe-4ae5-87b6-211384402fb2/deactivate' -i -X PUT \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJVdnlHV2pkT0RLRnZabEZpbllQdi1nIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6ImJhNGYwODY0LTg5ZDQtNDI3ZS04MzEyLWY3OGM2YzRlNzBmZSIsImF1ZCI6ImlkZW50aXR5IiwiaWF0IjoxNTkyOTMyMTExLCJleHAiOjE1OTI5MzU3MTEsInBvbGljaWVzIjpbeyJyZXNvdXJjZXMiOlsibmZybjoqIl0sImFjdGlvbnMiOlsiKjoqIl19XSwiZ3JhbnRzLXN1cGVyIjoiW3tcImlkXCI6XCI4M2Q0NjI5MS02ZjZhLTRmYzEtOWVhZS1hZGQyMjYyMzczZjFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTF9LHtcImlkXCI6XCIxMzJlMTc4OS1kNDRhLTQ3NjQtYThiMC1kOWMwNTE0NjZkM2VcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTB9LHtcImlkXCI6XCJlZDA3MTE0OS05MDQ4LTQ2YmItYWNjNC1mMDllMzk2ZDM5MjJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJkZmQxYTUyOC1jMjI0LTRiYWMtOWJjNi0wMjU3NDRlYTJlZGVcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTB9LHtcImlkXCI6XCI0YjYzOWNmOC00MDU4LTQ4MDEtYWQzZS05N2M4N2Y3ZWQzNzBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDl9LHtcImlkXCI6XCI1N2FiN2ZmMi00MTQ3LTQ3NWEtOTFhZC04YmM2Nzc3MjRlNjZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCIzNGYxMDg0MC1jYmY1LTRjMWQtOWI0Yy1jMjA0OGYzZjQ3NThcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCJiMjgyMjgxNy1hZGVjLTRhNDMtODIzZi0yZTI1MjIwOWI1ZWJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTB9LHtcImlkXCI6XCJjYmY4OTAyMS05ZTUyLTRjOWQtYjA0Yi04YmYzMTdlNmQ1YTBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDl9LHtcImlkXCI6XCIyN2UxNGZiZC1hMDY1LTRlYmItYjRmOC00MGY3ZDg2NGQ0NWRcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTB9LHtcImlkXCI6XCI1OTcyMjcyZS0yZTQwLTQyNzUtYjRjYS1mOGY2ZDgzZTVlOWJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTB9LHtcImlkXCI6XCIxNDU0NjZlOC1hZTRkLTRiNTAtYjczOS04NWMyMThmOTBmZmRcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJhNTViYjIyOS1iZWIxLTRjOWEtOWEwMi02Mjc3NzY0Zjk5MDhcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTB9LHtcImlkXCI6XCJiMTY1Y2MxNS0xNGQ2LTQwYzItODg4My0xZTRiMTU3MTBkMDJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCI1YTk1NzMzZS0wY2YxLTRiZTctYjQ3My1hNTIyYzM5Y2E0OGNcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTB9LHtcImlkXCI6XCJiZDYyYmNlYy02MGY5LTQwNzUtOTExMS1mNjM1NTI0OGE5ZmRcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCI1ZTIzZmI2My00ZWE4LTQzMjQtODU0NS01NGY0Yzc1MTlhODJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCJkMjQ2ODliZC03NWZmLTQ4MzYtOTM0Ni03ODYwOWFlMmZmOGVcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCI4MDY5OTJmNC0yYzc2LTQxMDctOTA5YS0yYWIzOGRmNWVjNTlcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCJjMDJiNDhiMy1iMmI0LTRlZDAtYjhhNC1hNjYxMzIwZTFkM2ZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDl9LHtcImlkXCI6XCIxNjFlOTU2Mi0wMWI2LTRlMTEtYmY0Zi1kNTgzMzhkYzNjZDNcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCI4MTljYzhiZS0zYTk1LTRjMzYtYTAxNC00ZmQ0OGUxMWU3N2JcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDl9LHtcImlkXCI6XCIwODIxMTRiNy1hZGVhLTQ5MjYtOTY3NC1lNjBmZTJhODM2MGJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCI2ODQzOWNlYy0zN2E0LTQ3MmMtYmQ5My01MGIzODRiYmVhZGFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTB9LHtcImlkXCI6XCJiZDM2NjZlMy1lMTJjLTRkMTktODI5MS04MzM3NjY2ZDVhYTBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDl9LHtcImlkXCI6XCJlMzNiN2YyYS1mODVhLTQzZWMtOTEwOC02N2Y5M2I4NjFkMmFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCIzOWNiMzVjZi05NzExLTQxNzQtOTg0Zi1jZjgxYWIyNGJmNmJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCJjOTM2NWEwNS04YzMwLTRkMDQtYTAxMy1jZTAwODljNWZlZWNcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCJiNDMyZjMyYy1jMWQ3LTQ1MzctOTI0Ny02MDg3ZjA5NTJjNmZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTF9LHtcImlkXCI6XCJhM2E0NjNhMS02NzlkLTRlMjctYjRjYi1hMDllMTY4OTE4OWFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTB9LHtcImlkXCI6XCJjMGQwZDg4NC1kOWE2LTRjODItYmU1ZC1mY2ExNWFiODUyNTBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCIzZGYzOTU3Ni0yZmZmLTRiYzItYmNiNS03NjNhMWU1ZDg4ZWFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCJiNmYzNTI5Yi04ODc2LTQ5NjUtYmQ2ZC02ODIzY2VhYzdlOGRcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCIyZmNlNzU2My1lYjk0LTRhMjEtOTAzMS02ZDQwNDhmZjE5YTdcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJjMmQxODBiMC04MjdhLTRlYzEtYjU4Zi01NWU0ZjcwMTY5NDZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCI5ZjIyNGUwNS04MmZiLTQ4ODgtOTY1YS0yMmE2ZGE4MjNhOTFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCJjMWRlMjk2Ni0xZmJmLTRmNTEtYmNhMi05YjU3OTYxMzIzMjBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDV9LHtcImlkXCI6XCJkZDUzYWU3NS01MzA2LTRhNDktOWE5Yi1iNjAzZDdmOTM0MDZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCJmOTgxN2Y2YS1lZDY3LTQ5N2QtYjAxMC02NTdkMGEyYjNiNzlcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDl9LHtcImlkXCI6XCI0NzYyYmYyZS1iMDM0LTQ1MjAtYmEyZS1kNTk3OGNmYTQxOTFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDl9XSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbXSIsImdyYW50cy1hY3Rpb24iOiJbXSIsImdyYW50cy1zdGFuZGFyZCI6IltdIn0.YE7enuIZysLQLNAz88jwFC94NpJwfT5AsOsgsDwgVc0OjTsL4Pmrw8ytb4vHlUKjQZ09Dm0BLuF2LbI4fT4YwvR41dsFslD43ZE52RUyDEyVsXhVQwmJ_I8d_vp-6lY41IQ6FqCSiOYjTYA7l_9GK684SbjlBJTUlZdKeWk3KNJ4ckh6SwRIeBJtkQXpubLZmPaAS9j8fDp8r485W-KiRbM-F08591Xwv8GGe3Yo744VQ0j8-0x6N1OXI68rNWdTMHy67PmoRPBNO7KuSWJ8nq9SG102vBkpfBwwU0jZzDI0H6WeeR6Nxl4yK8WddmpiIP5EMxsN2SOMvcr4zHlZ4A'

Example response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 681

{
  "id" : "62052822-dabe-4ae5-87b6-211384402fb2",
  "organizationId" : "f20456a7-e2c0-4abf-a358-250644369772",
  "firstName" : "First",
  "lastName" : "Last",
  "email" : "random-65@acme.com",
  "identityMappings" : [ {
    "id" : "90216da4-135b-4bb4-b5d5-1dab9ae6c66d",
    "auth0UserId" : "auth0-opaque-userId-66",
    "identityProviderId" : "4e26c2d8-01ba-4f4f-ba83-8415f68df9ff",
    "userIdentityId" : "62052822-dabe-4ae5-87b6-211384402fb2"
  } ],
  "active" : false,
  "createdAt" : {
    "nano" : 248000000,
    "epochSecond" : 1592932111
  },
  "deletedAt" : null,
  "tenantId" : "f20456a7-e2c0-4abf-a358-250644369772",
  "name" : "First Last",
  "type" : "UserIdentity"
}

Reset User Identity Mfa Settings

PUT /user-identities/{id}/reset-mfa

Calling this service will reset the user’s MFA settings. On their next login attempt, they will be required to setup their MFA settings again. This is useful if, for example, the user has replaced their phone and can no longer access their secondary authentication.

Authorization

Valid Authorization Bearer token required, along with a permission grant authorizing access to any referenced resources.

Path parameters

Parameter Type Optional Description

id

Object

false

The id of the user identity to reset.

Client must have update-reset-mfa action on the annotated resource.

Query parameters

No parameters.

Request fields

No request body.

Response fields

No response body.

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/user-identities/7abd9449-c68e-4e5a-bbce-098c5427363d/reset-mfa' -i -X PUT \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiIwSXVnSGE5RzR5eWtCeFV5WXZha3VRIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6ImJhNGYwODY0LTg5ZDQtNDI3ZS04MzEyLWY3OGM2YzRlNzBmZSIsImF1ZCI6ImlkZW50aXR5IiwiaWF0IjoxNTkyOTMyMTExLCJleHAiOjE1OTI5MzU3MTEsInBvbGljaWVzIjpbeyJyZXNvdXJjZXMiOlsibmZybjoqIl0sImFjdGlvbnMiOlsiKjoqIl19XSwiZ3JhbnRzLXN1cGVyIjoiW3tcImlkXCI6XCI4M2Q0NjI5MS02ZjZhLTRmYzEtOWVhZS1hZGQyMjYyMzczZjFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTF9LHtcImlkXCI6XCIxMzJlMTc4OS1kNDRhLTQ3NjQtYThiMC1kOWMwNTE0NjZkM2VcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTB9LHtcImlkXCI6XCJlZDA3MTE0OS05MDQ4LTQ2YmItYWNjNC1mMDllMzk2ZDM5MjJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJkZmQxYTUyOC1jMjI0LTRiYWMtOWJjNi0wMjU3NDRlYTJlZGVcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTB9LHtcImlkXCI6XCI0YjYzOWNmOC00MDU4LTQ4MDEtYWQzZS05N2M4N2Y3ZWQzNzBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDl9LHtcImlkXCI6XCI1N2FiN2ZmMi00MTQ3LTQ3NWEtOTFhZC04YmM2Nzc3MjRlNjZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCI1YTE0MDg3Ni0wMTQ3LTQ1YjItOWFlYy1iMDQ4ZjAwNDA1ZTZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTF9LHtcImlkXCI6XCIzNGYxMDg0MC1jYmY1LTRjMWQtOWI0Yy1jMjA0OGYzZjQ3NThcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCJiMjgyMjgxNy1hZGVjLTRhNDMtODIzZi0yZTI1MjIwOWI1ZWJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTB9LHtcImlkXCI6XCJjYmY4OTAyMS05ZTUyLTRjOWQtYjA0Yi04YmYzMTdlNmQ1YTBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDl9LHtcImlkXCI6XCIyN2UxNGZiZC1hMDY1LTRlYmItYjRmOC00MGY3ZDg2NGQ0NWRcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTB9LHtcImlkXCI6XCI1OTcyMjcyZS0yZTQwLTQyNzUtYjRjYS1mOGY2ZDgzZTVlOWJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTB9LHtcImlkXCI6XCIxNDU0NjZlOC1hZTRkLTRiNTAtYjczOS04NWMyMThmOTBmZmRcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJhNTViYjIyOS1iZWIxLTRjOWEtOWEwMi02Mjc3NzY0Zjk5MDhcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTB9LHtcImlkXCI6XCJiMTY1Y2MxNS0xNGQ2LTQwYzItODg4My0xZTRiMTU3MTBkMDJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCI1YTk1NzMzZS0wY2YxLTRiZTctYjQ3My1hNTIyYzM5Y2E0OGNcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTB9LHtcImlkXCI6XCJiZDYyYmNlYy02MGY5LTQwNzUtOTExMS1mNjM1NTI0OGE5ZmRcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCI1ZTIzZmI2My00ZWE4LTQzMjQtODU0NS01NGY0Yzc1MTlhODJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCJkMjQ2ODliZC03NWZmLTQ4MzYtOTM0Ni03ODYwOWFlMmZmOGVcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCI4MDY5OTJmNC0yYzc2LTQxMDctOTA5YS0yYWIzOGRmNWVjNTlcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCJjMDJiNDhiMy1iMmI0LTRlZDAtYjhhNC1hNjYxMzIwZTFkM2ZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDl9LHtcImlkXCI6XCIxNjFlOTU2Mi0wMWI2LTRlMTEtYmY0Zi1kNTgzMzhkYzNjZDNcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCI4MTljYzhiZS0zYTk1LTRjMzYtYTAxNC00ZmQ0OGUxMWU3N2JcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDl9LHtcImlkXCI6XCIwODIxMTRiNy1hZGVhLTQ5MjYtOTY3NC1lNjBmZTJhODM2MGJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCI2ODQzOWNlYy0zN2E0LTQ3MmMtYmQ5My01MGIzODRiYmVhZGFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTB9LHtcImlkXCI6XCJiZDM2NjZlMy1lMTJjLTRkMTktODI5MS04MzM3NjY2ZDVhYTBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDl9LHtcImlkXCI6XCIxMDQ3YjBmNy05OWM0LTQ2YTItOGVmZi0yYzY4ZGQwOTI5NDRcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTF9LHtcImlkXCI6XCJlMzNiN2YyYS1mODVhLTQzZWMtOTEwOC02N2Y5M2I4NjFkMmFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCIzOWNiMzVjZi05NzExLTQxNzQtOTg0Zi1jZjgxYWIyNGJmNmJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCJjOTM2NWEwNS04YzMwLTRkMDQtYTAxMy1jZTAwODljNWZlZWNcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCJiNDMyZjMyYy1jMWQ3LTQ1MzctOTI0Ny02MDg3ZjA5NTJjNmZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTF9LHtcImlkXCI6XCJhM2E0NjNhMS02NzlkLTRlMjctYjRjYi1hMDllMTY4OTE4OWFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTB9LHtcImlkXCI6XCJjMGQwZDg4NC1kOWE2LTRjODItYmU1ZC1mY2ExNWFiODUyNTBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCIzZGYzOTU3Ni0yZmZmLTRiYzItYmNiNS03NjNhMWU1ZDg4ZWFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCJiNmYzNTI5Yi04ODc2LTQ5NjUtYmQ2ZC02ODIzY2VhYzdlOGRcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCIyZmNlNzU2My1lYjk0LTRhMjEtOTAzMS02ZDQwNDhmZjE5YTdcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJjMmQxODBiMC04MjdhLTRlYzEtYjU4Zi01NWU0ZjcwMTY5NDZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCI5ZjIyNGUwNS04MmZiLTQ4ODgtOTY1YS0yMmE2ZGE4MjNhOTFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCJjMWRlMjk2Ni0xZmJmLTRmNTEtYmNhMi05YjU3OTYxMzIzMjBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDV9LHtcImlkXCI6XCJkZDUzYWU3NS01MzA2LTRhNDktOWE5Yi1iNjAzZDdmOTM0MDZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCJmOTgxN2Y2YS1lZDY3LTQ5N2QtYjAxMC02NTdkMGEyYjNiNzlcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDl9LHtcImlkXCI6XCI0NzYyYmYyZS1iMDM0LTQ1MjAtYmEyZS1kNTk3OGNmYTQxOTFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDl9XSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbXSIsImdyYW50cy1hY3Rpb24iOiJbXSIsImdyYW50cy1zdGFuZGFyZCI6IltdIn0.RRCPMhKVzhIEglRX7pTIPcX3sj9ikrsd87_YrqEZKdaKHmv-S3zvu3pQEqhzu9N_R3kH_hKJBXSvF-7keBfnY0FKtP1eAlIDO4Yc1YLLitG0mFamr70hsT20CWsTUH_7zIe8qJHH9yox4Zw3K-4jS4QrABGwZ0VjkW6U9fwXLTR2rrOIsWXGzGzv2HoVRDSJm2Oip4XH-8GX3qzMbyU-ZQrLXhsZnDsg0LBbhT1-ZxDterKrD14RVklS9nXjiu6a1tMQlUs1MsFkurwc5hG4V91a5tS4-Ev4CU7niopHRCSrDBojmajya_QSUcBeUPdQOyNdJN3YhuPFa-OnHhu36g'

Example response

HTTP/1.1 200 OK

Map Identity

POST /user-identities/{id}/mapping

Authorization

Valid Authorization Bearer token required, along with a permission grant authorizing access to any referenced resources.

Path parameters

Parameter Type Optional Description

id

Object

false

Client must have create-identity-mapping action on the annotated resource.

Query parameters

No parameters.

Request fields

Path Type Optional Description

auth0UserId

String

false

Size must be between 1 and 128 inclusive.

identityProviderId

String

false

Response fields

No response body.

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/user-identities/fbe4cbc3-38a8-44e1-83cf-b40d68a405cb/mapping' -i -X POST \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiIxU2VWc2VXUkVuMXNyNy1XdlFDanlnIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6ImJhNGYwODY0LTg5ZDQtNDI3ZS04MzEyLWY3OGM2YzRlNzBmZSIsImF1ZCI6ImlkZW50aXR5IiwiaWF0IjoxNTkyOTMyMTEwLCJleHAiOjE1OTI5MzU3MTAsInBvbGljaWVzIjpbeyJyZXNvdXJjZXMiOlsibmZybjoqIl0sImFjdGlvbnMiOlsiKjoqIl19XSwiZ3JhbnRzLXN1cGVyIjoiW3tcImlkXCI6XCIxMzJlMTc4OS1kNDRhLTQ3NjQtYThiMC1kOWMwNTE0NjZkM2VcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTB9LHtcImlkXCI6XCJlZDA3MTE0OS05MDQ4LTQ2YmItYWNjNC1mMDllMzk2ZDM5MjJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJkZmQxYTUyOC1jMjI0LTRiYWMtOWJjNi0wMjU3NDRlYTJlZGVcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTB9LHtcImlkXCI6XCI0YjYzOWNmOC00MDU4LTQ4MDEtYWQzZS05N2M4N2Y3ZWQzNzBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDl9LHtcImlkXCI6XCI1N2FiN2ZmMi00MTQ3LTQ3NWEtOTFhZC04YmM2Nzc3MjRlNjZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCIzNGYxMDg0MC1jYmY1LTRjMWQtOWI0Yy1jMjA0OGYzZjQ3NThcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCJiMjgyMjgxNy1hZGVjLTRhNDMtODIzZi0yZTI1MjIwOWI1ZWJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTB9LHtcImlkXCI6XCJjYmY4OTAyMS05ZTUyLTRjOWQtYjA0Yi04YmYzMTdlNmQ1YTBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDl9LHtcImlkXCI6XCIyN2UxNGZiZC1hMDY1LTRlYmItYjRmOC00MGY3ZDg2NGQ0NWRcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTB9LHtcImlkXCI6XCI1OTcyMjcyZS0yZTQwLTQyNzUtYjRjYS1mOGY2ZDgzZTVlOWJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTB9LHtcImlkXCI6XCIxNDU0NjZlOC1hZTRkLTRiNTAtYjczOS04NWMyMThmOTBmZmRcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJhNTViYjIyOS1iZWIxLTRjOWEtOWEwMi02Mjc3NzY0Zjk5MDhcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTB9LHtcImlkXCI6XCJiMTY1Y2MxNS0xNGQ2LTQwYzItODg4My0xZTRiMTU3MTBkMDJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCI1YTk1NzMzZS0wY2YxLTRiZTctYjQ3My1hNTIyYzM5Y2E0OGNcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTB9LHtcImlkXCI6XCJiZDYyYmNlYy02MGY5LTQwNzUtOTExMS1mNjM1NTI0OGE5ZmRcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCI1ZTIzZmI2My00ZWE4LTQzMjQtODU0NS01NGY0Yzc1MTlhODJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCJkMjQ2ODliZC03NWZmLTQ4MzYtOTM0Ni03ODYwOWFlMmZmOGVcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCI4MDY5OTJmNC0yYzc2LTQxMDctOTA5YS0yYWIzOGRmNWVjNTlcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCJjMDJiNDhiMy1iMmI0LTRlZDAtYjhhNC1hNjYxMzIwZTFkM2ZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDl9LHtcImlkXCI6XCIxNjFlOTU2Mi0wMWI2LTRlMTEtYmY0Zi1kNTgzMzhkYzNjZDNcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCI4MTljYzhiZS0zYTk1LTRjMzYtYTAxNC00ZmQ0OGUxMWU3N2JcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDl9LHtcImlkXCI6XCIwODIxMTRiNy1hZGVhLTQ5MjYtOTY3NC1lNjBmZTJhODM2MGJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCI2ODQzOWNlYy0zN2E0LTQ3MmMtYmQ5My01MGIzODRiYmVhZGFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTB9LHtcImlkXCI6XCJiZDM2NjZlMy1lMTJjLTRkMTktODI5MS04MzM3NjY2ZDVhYTBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDl9LHtcImlkXCI6XCJlMzNiN2YyYS1mODVhLTQzZWMtOTEwOC02N2Y5M2I4NjFkMmFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCIzOWNiMzVjZi05NzExLTQxNzQtOTg0Zi1jZjgxYWIyNGJmNmJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCJjOTM2NWEwNS04YzMwLTRkMDQtYTAxMy1jZTAwODljNWZlZWNcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCJhM2E0NjNhMS02NzlkLTRlMjctYjRjYi1hMDllMTY4OTE4OWFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMTB9LHtcImlkXCI6XCJjMGQwZDg4NC1kOWE2LTRjODItYmU1ZC1mY2ExNWFiODUyNTBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCIzZGYzOTU3Ni0yZmZmLTRiYzItYmNiNS03NjNhMWU1ZDg4ZWFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCJiNmYzNTI5Yi04ODc2LTQ5NjUtYmQ2ZC02ODIzY2VhYzdlOGRcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCIyZmNlNzU2My1lYjk0LTRhMjEtOTAzMS02ZDQwNDhmZjE5YTdcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJjMmQxODBiMC04MjdhLTRlYzEtYjU4Zi01NWU0ZjcwMTY5NDZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCI5ZjIyNGUwNS04MmZiLTQ4ODgtOTY1YS0yMmE2ZGE4MjNhOTFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCJjMWRlMjk2Ni0xZmJmLTRmNTEtYmNhMi05YjU3OTYxMzIzMjBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDV9LHtcImlkXCI6XCJkZDUzYWU3NS01MzA2LTRhNDktOWE5Yi1iNjAzZDdmOTM0MDZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCJmOTgxN2Y2YS1lZDY3LTQ5N2QtYjAxMC02NTdkMGEyYjNiNzlcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDl9LHtcImlkXCI6XCI0NzYyYmYyZS1iMDM0LTQ1MjAtYmEyZS1kNTk3OGNmYTQxOTFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDl9XSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbXSIsImdyYW50cy1hY3Rpb24iOiJbXSIsImdyYW50cy1zdGFuZGFyZCI6IltdIn0.nkL1TbYjsCaglk-Kb5i94ORzH8JlcTwnas-Zpy7vH1BKd1RQtDtrgaaYEKTkDD-pKIXMe9LT8EnoYOeS7yelm0V8CurNbU3kulHywcw2sdXc7yglNkr09TZ_QRe9RlWgBlnW_rhK0HVI6NC6hmLb-5ulFI6liCdBwNUJ7zU4HlDv7OWIqJ2D6kjx3t9CkpwRN1DIlcbcMpcOLFJzqOP0hNbaLrLnAbUco0EGhuWo9jf9tsi892wlhx9pNeghIEGsVQKjdjvb1LQZoQGagW0DYaEWZSCWBbXyG-YygvfO9xp9ePJ8O_aroAIyUYV8rluGvSKkmKb2dOv4otsF73aAiw' \
    -d '{"auth0UserId":"new-auth0-userId:32352192-3a50-4da2-ae22-da5de90ad3a9","identityProviderId":"eb0d6f6a-2950-4f80-b00a-26ccad664f80"}'

Example response

HTTP/1.1 200 OK

API Account Identity

Find Api Account Identities

GET /api-account-identities

Returns a set of {@link ApiAccountIdentity}s that are visible to the requesting client and optionally filtered based on the submitted request parameters.

Authorization

Valid Authorization Bearer token required, along with a permission grant authorizing access to any referenced resources.

Path parameters

No parameters.

Query parameters

Supports standard paging query parameters.

Parameter Type Optional Description

tenantId

Object

true

Deprecated..

organizationId

Object

true

Restricts results to Identities in the specified Organization (by Organization’s id.).

name

String

true

contactEmail

String

true

active

Boolean

true

Restricts results to Identities with a matching active status.

includeDeleted

Boolean

true

Default value: 'false'.

Request fields

No request body.

Response fields

Standard paging response where content field is list of following objects:

Path Type Optional Description

id

String

false

organizationId

String

false

auth0ClientId

String

false

Size must be between 16 and 128 inclusive.

name

String

true

io.netfoundry.common.util.validation.BasicPattern.

contactEmail

String

false

Must be a well-formed email address.
Size must be between 6 and 254 inclusive.

description

String

false

Size must be between 0 and 2048 inclusive.

active

Boolean

true

createdAt

Object

false

updatedAt

Object

false

deletedAt

Object

true

Returns the date that the identity was deleted or null if the identity has not been deleted. Note, identities are marked as deleted and not returned from searches unless explicitly requested.

email

String

true

tenantId

String

true

Deprecated. The Tenant resource has been renamed to Organization. Use getOrganizationId().

Returns the id of the {@link Organization} that this identity is a member of.

type

String

true

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/api-account-identities' -i -X GET \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJjMkJuQlhWY2RnSHI5YVNDdFBaQ3B3IiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6ImJhNGYwODY0LTg5ZDQtNDI3ZS04MzEyLWY3OGM2YzRlNzBmZSIsImF1ZCI6ImlkZW50aXR5IiwiaWF0IjoxNTkyOTMyMTA3LCJleHAiOjE1OTI5MzU3MDcsInBvbGljaWVzIjpbeyJyZXNvdXJjZXMiOlsibmZybjoqIl0sImFjdGlvbnMiOlsiKjoqIl19XSwiZ3JhbnRzLXN1cGVyIjoiW3tcImlkXCI6XCI4MDY5OTJmNC0yYzc2LTQxMDctOTA5YS0yYWIzOGRmNWVjNTlcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCI1N2FiN2ZmMi00MTQ3LTQ3NWEtOTFhZC04YmM2Nzc3MjRlNjZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCIzNGYxMDg0MC1jYmY1LTRjMWQtOWI0Yy1jMjA0OGYzZjQ3NThcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCIyZmNlNzU2My1lYjk0LTRhMjEtOTAzMS02ZDQwNDhmZjE5YTdcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCIwODIxMTRiNy1hZGVhLTQ5MjYtOTY3NC1lNjBmZTJhODM2MGJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJjMmQxODBiMC04MjdhLTRlYzEtYjU4Zi01NWU0ZjcwMTY5NDZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJlZDA3MTE0OS05MDQ4LTQ2YmItYWNjNC1mMDllMzk2ZDM5MjJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJjMWRlMjk2Ni0xZmJmLTRmNTEtYmNhMi05YjU3OTYxMzIzMjBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDV9LHtcImlkXCI6XCIxNDU0NjZlOC1hZTRkLTRiNTAtYjczOS04NWMyMThmOTBmZmRcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJlMzNiN2YyYS1mODVhLTQzZWMtOTEwOC02N2Y5M2I4NjFkMmFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCJiMTY1Y2MxNS0xNGQ2LTQwYzItODg4My0xZTRiMTU3MTBkMDJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9XSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbXSIsImdyYW50cy1hY3Rpb24iOiJbXSIsImdyYW50cy1zdGFuZGFyZCI6IltdIn0.imS5p-tvllDH5HcPGG9KwVBigopsOUwkKKhpitY6H3ZYy4sS_KJQEohr4FtkVgn0CPk4Fp1umvBmZpvUsTOjuOU3wrRBS9PdFgQyjDFgwlbQaX-ke8E46RblEVUV6hQi2yIj6xkHn-flpj-ApiylcZBjRh8-U93CYkgrjmS0mF1M9u2Lzb07fqwsOXKH2Jxaj_7uM4P3mlcbUItZ2Xje8tpLWnEY3cO3G_a8wkk9ZD7ENjS93L7Q4ZKq7tAoMDCxMFyLRokdPgviuPq06lPqSWPePTkSonAwEpLrpd_HZgX1WlrqOErO3J0tu1eZHcahBpabuWumlffknje2BqDZNQ'

Example response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 1855

[ {
  "id" : "109a3049-49a1-418b-9232-125a6a2b6580",
  "organizationId" : "f20456a7-e2c0-4abf-a358-250644369772",
  "auth0ClientId" : "5455b0d9-9a18-4577-8f95-b0bef379fffb",
  "name" : "api-account",
  "contactEmail" : "no-reply@acme.com",
  "description" : "This is an ACME non-interactive API client.",
  "active" : true,
  "createdAt" : {
    "nano" : 857000000,
    "epochSecond" : 1592932105
  },
  "updatedAt" : {
    "nano" : 657000000,
    "epochSecond" : 1592932106
  },
  "deletedAt" : null,
  "email" : "no-reply@acme.com",
  "tenantId" : "f20456a7-e2c0-4abf-a358-250644369772",
  "type" : "ApiAccountIdentity"
}, {
  "id" : "2b8437fd-a043-4c30-bfb8-9a66a855f280",
  "organizationId" : "f20456a7-e2c0-4abf-a358-250644369772",
  "auth0ClientId" : "7ab1ad3f-04f3-43ba-986b-3f7adea995fc",
  "name" : "Robot",
  "contactEmail" : "robot@acme.com",
  "description" : "description here.",
  "active" : true,
  "createdAt" : {
    "nano" : 864000000,
    "epochSecond" : 1592932105
  },
  "updatedAt" : {
    "nano" : 144000000,
    "epochSecond" : 1592932106
  },
  "deletedAt" : null,
  "email" : "robot@acme.com",
  "tenantId" : "f20456a7-e2c0-4abf-a358-250644369772",
  "type" : "ApiAccountIdentity"
}, {
  "id" : "10f18fb8-25d9-408e-85cb-fd851a985940",
  "organizationId" : "f20456a7-e2c0-4abf-a358-250644369772",
  "auth0ClientId" : "43afdffb-a473-40f1-b6ee-c09f978b2aab",
  "name" : "ACME Internal Service-11",
  "contactEmail" : "service.admin-12@acme.com",
  "description" : "updatable API Account description-13",
  "active" : true,
  "createdAt" : {
    "nano" : 953000000,
    "epochSecond" : 1592932106
  },
  "updatedAt" : {
    "nano" : 974000000,
    "epochSecond" : 1592932106
  },
  "deletedAt" : null,
  "email" : "service.admin-12@acme.com",
  "tenantId" : "f20456a7-e2c0-4abf-a358-250644369772",
  "type" : "ApiAccountIdentity"
} ]

Get Api Account Identity

GET /api-account-identities/{id:[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}}

Get an API Account Identity by its id.

Authorization

Valid Authorization Bearer token required, along with a permission grant authorizing access to any referenced resources.

Path parameters

Parameter Type Optional Description

id

Object

false

The id of the desired Identity.

Client must have read action on the annotated resource.

Query parameters

No parameters.

Request fields

No request body.

Response fields

Path Type Optional Description

id

String

false

organizationId

String

false

auth0ClientId

String

false

Size must be between 16 and 128 inclusive.

name

String

true

io.netfoundry.common.util.validation.BasicPattern.

contactEmail

String

false

Must be a well-formed email address.
Size must be between 6 and 254 inclusive.

description

String

false

Size must be between 0 and 2048 inclusive.

active

Boolean

true

createdAt

Object

false

updatedAt

Object

false

deletedAt

Object

true

Returns the date that the identity was deleted or null if the identity has not been deleted. Note, identities are marked as deleted and not returned from searches unless explicitly requested.

email

String

true

tenantId

String

true

Deprecated. The Tenant resource has been renamed to Organization. Use getOrganizationId().

Returns the id of the {@link Organization} that this identity is a member of.

type

String

true

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/api-account-identities/109a3049-49a1-418b-9232-125a6a2b6580' -i -X GET \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJuOTJKMl9YQTJMMS1BVFlXek4yQVBBIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6ImJhNGYwODY0LTg5ZDQtNDI3ZS04MzEyLWY3OGM2YzRlNzBmZSIsImF1ZCI6ImlkZW50aXR5IiwiaWF0IjoxNTkyOTMyMTA3LCJleHAiOjE1OTI5MzU3MDcsInBvbGljaWVzIjpbeyJyZXNvdXJjZXMiOlsibmZybjoqIl0sImFjdGlvbnMiOlsiKjoqIl19XSwiZ3JhbnRzLXN1cGVyIjoiW3tcImlkXCI6XCI4MDY5OTJmNC0yYzc2LTQxMDctOTA5YS0yYWIzOGRmNWVjNTlcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCJjMGQwZDg4NC1kOWE2LTRjODItYmU1ZC1mY2ExNWFiODUyNTBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCI1N2FiN2ZmMi00MTQ3LTQ3NWEtOTFhZC04YmM2Nzc3MjRlNjZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCIzNGYxMDg0MC1jYmY1LTRjMWQtOWI0Yy1jMjA0OGYzZjQ3NThcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCIyZmNlNzU2My1lYjk0LTRhMjEtOTAzMS02ZDQwNDhmZjE5YTdcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCIwODIxMTRiNy1hZGVhLTQ5MjYtOTY3NC1lNjBmZTJhODM2MGJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJjMmQxODBiMC04MjdhLTRlYzEtYjU4Zi01NWU0ZjcwMTY5NDZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJlZDA3MTE0OS05MDQ4LTQ2YmItYWNjNC1mMDllMzk2ZDM5MjJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJjMWRlMjk2Ni0xZmJmLTRmNTEtYmNhMi05YjU3OTYxMzIzMjBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDV9LHtcImlkXCI6XCIxNDU0NjZlOC1hZTRkLTRiNTAtYjczOS04NWMyMThmOTBmZmRcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJlMzNiN2YyYS1mODVhLTQzZWMtOTEwOC02N2Y5M2I4NjFkMmFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCJiMTY1Y2MxNS0xNGQ2LTQwYzItODg4My0xZTRiMTU3MTBkMDJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9XSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbXSIsImdyYW50cy1hY3Rpb24iOiJbXSIsImdyYW50cy1zdGFuZGFyZCI6IltdIn0.xdY3Lt8CB-jTw7OS9DBRrF9wpTS8UvHTGGMCaV64ckVJplJD9i_yx76M3vnea4SlMbrzMbFqkYAP6394ONLhBU27ED9PEzWYB9Koe9WFhQIttnCGK09RIsu19TT7sIEu-ssBI1Wid3NapwiwIiCWA_xArZ2pJ0Z9SaRWK0bsgZx5ZOeGE_GSAhTZ6sv-NrytXSRis5wZ_w0eM49AL5oMvMI0wkbsQmvRebtHkSO1Jjc7IEjRPgeE-0uITMiIq02mqoRSmj0vS8xuvsVkXZDvCnF4mo-Ae_S3RUVCkXZqsJR6h1h1pkVBXRWnYcfrI-8-x2wbZC46jBQ5D4cS4PqYfg'

Example response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 621

{
  "id" : "109a3049-49a1-418b-9232-125a6a2b6580",
  "organizationId" : "f20456a7-e2c0-4abf-a358-250644369772",
  "auth0ClientId" : "5455b0d9-9a18-4577-8f95-b0bef379fffb",
  "name" : "api-account",
  "contactEmail" : "no-reply@acme.com",
  "description" : "This is an ACME non-interactive API client.",
  "active" : true,
  "createdAt" : {
    "nano" : 857000000,
    "epochSecond" : 1592932105
  },
  "updatedAt" : {
    "nano" : 657000000,
    "epochSecond" : 1592932106
  },
  "deletedAt" : null,
  "email" : "no-reply@acme.com",
  "tenantId" : "f20456a7-e2c0-4abf-a358-250644369772",
  "type" : "ApiAccountIdentity"
}

Get Api Account Identity By Mapping

GET /api-account-identities/mapping/{auth0ClientId}

Authorization

Valid Authorization Bearer token required, along with a permission grant authorizing access to any referenced resources.

Path parameters

Parameter Type Optional Description

auth0ClientId

String

false

Query parameters

No parameters.

Request fields

No request body.

Response fields

Path Type Optional Description

id

String

false

organizationId

String

false

auth0ClientId

String

false

Size must be between 16 and 128 inclusive.

name

String

true

io.netfoundry.common.util.validation.BasicPattern.

contactEmail

String

false

Must be a well-formed email address.
Size must be between 6 and 254 inclusive.

description

String

false

Size must be between 0 and 2048 inclusive.

active

Boolean

true

createdAt

Object

false

updatedAt

Object

false

deletedAt

Object

true

Returns the date that the identity was deleted or null if the identity has not been deleted. Note, identities are marked as deleted and not returned from searches unless explicitly requested.

email

String

true

tenantId

String

true

Deprecated. The Tenant resource has been renamed to Organization. Use getOrganizationId().

Returns the id of the {@link Organization} that this identity is a member of.

type

String

true

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/api-account-identities/mapping/77d34a61-435a-4fe8-9d1f-69f6d8b10c06' -i -X GET \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJBV2JkaHBUMTk1NVpDZG5tYlFRQXlRIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6ImJhNGYwODY0LTg5ZDQtNDI3ZS04MzEyLWY3OGM2YzRlNzBmZSIsImF1ZCI6ImlkZW50aXR5IiwiaWF0IjoxNTkyOTMyMTA3LCJleHAiOjE1OTI5MzU3MDcsInBvbGljaWVzIjpbeyJyZXNvdXJjZXMiOlsibmZybjoqIl0sImFjdGlvbnMiOlsiKjoqIl19XSwiZ3JhbnRzLXN1cGVyIjoiW3tcImlkXCI6XCI4MDY5OTJmNC0yYzc2LTQxMDctOTA5YS0yYWIzOGRmNWVjNTlcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCIxNjFlOTU2Mi0wMWI2LTRlMTEtYmY0Zi1kNTgzMzhkYzNjZDNcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCIwODIxMTRiNy1hZGVhLTQ5MjYtOTY3NC1lNjBmZTJhODM2MGJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJlZDA3MTE0OS05MDQ4LTQ2YmItYWNjNC1mMDllMzk2ZDM5MjJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJlMzNiN2YyYS1mODVhLTQzZWMtOTEwOC02N2Y5M2I4NjFkMmFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCJjMGQwZDg4NC1kOWE2LTRjODItYmU1ZC1mY2ExNWFiODUyNTBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCI1N2FiN2ZmMi00MTQ3LTQ3NWEtOTFhZC04YmM2Nzc3MjRlNjZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCIzNGYxMDg0MC1jYmY1LTRjMWQtOWI0Yy1jMjA0OGYzZjQ3NThcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCIyZmNlNzU2My1lYjk0LTRhMjEtOTAzMS02ZDQwNDhmZjE5YTdcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJjMmQxODBiMC04MjdhLTRlYzEtYjU4Zi01NWU0ZjcwMTY5NDZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCI5ZjIyNGUwNS04MmZiLTQ4ODgtOTY1YS0yMmE2ZGE4MjNhOTFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCJjMWRlMjk2Ni0xZmJmLTRmNTEtYmNhMi05YjU3OTYxMzIzMjBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDV9LHtcImlkXCI6XCIxNDU0NjZlOC1hZTRkLTRiNTAtYjczOS04NWMyMThmOTBmZmRcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJiMTY1Y2MxNS0xNGQ2LTQwYzItODg4My0xZTRiMTU3MTBkMDJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCI1ZTIzZmI2My00ZWE4LTQzMjQtODU0NS01NGY0Yzc1MTlhODJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9XSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbXSIsImdyYW50cy1hY3Rpb24iOiJbXSIsImdyYW50cy1zdGFuZGFyZCI6IltdIn0.OrTaFEzvNytpDXpvFdEBRM82yvkTgJj4UhommUuvTI1IQMGpUXHh2qgTVxDmLclybS0adXwc1tmFuUvrOOETwsJ3sv18FFdQykvi3jdLSHjQuBFP9dqWmgtucR7K-te3ArUVLopu07OLToKrv6meCwkYjYOYXwHeFR98lgcjqLzS4V8PBw8Y3NZ-ZhYQcnV4vBxtzAX7mk9R5xdOYy2UAWbQBgWNSvATkQhDGSgDFXkJmdpFbnm0K--2I6DU2weGSg7n_LyPh6J1L3ZS_3anw5StP59A2q4USPIaom6Z_g9Mrf8IhXc5dhr50KAj6o-WzwHc5JbkNRFAjNxZITovsg'

Example response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 587

{
  "id" : "feda1c4e-00ea-420d-babf-46e8d51bdfd2",
  "organizationId" : "f20456a7-e2c0-4abf-a358-250644369772",
  "auth0ClientId" : "77d34a61-435a-4fe8-9d1f-69f6d8b10c06",
  "name" : "ACME Internal Service-26",
  "contactEmail" : "service.admin-27@acme.com",
  "description" : "updatable API Account description-28",
  "active" : true,
  "createdAt" : {
    "nano" : 914000000,
    "epochSecond" : 1592932107
  },
  "updatedAt" : null,
  "deletedAt" : null,
  "email" : "service.admin-27@acme.com",
  "tenantId" : "f20456a7-e2c0-4abf-a358-250644369772",
  "type" : "ApiAccountIdentity"
}

Create Api Account Identity

POST /api-account-identities

Authorization

Valid Authorization Bearer token required, along with a permission grant authorizing access to any referenced resources.

Path parameters

No parameters.

Query parameters

No parameters.

Request fields

Path Type Optional Description

organizationId

String

false

Client must have create action under the annotated resource.

name

String

true

io.netfoundry.common.util.validation.ValidAs.

contactEmail

String

false

Must be a well-formed email address.
Size must be between 6 and 254 inclusive.

description

String

false

Size must be between 0 and 2048 inclusive.

grantDefaultRoles

Boolean

true

Optional flag that when true will result in the API Account Identity being granted the 'default' roles (Organization and Network Group Admin, at this time.) When false, no authorization, roles or otherwise, will be configured, and it is assumed that the caller has permission to manage permissions of this API Account Identity after the fact. This defaults to true if not specified in the request.

Response fields

Path Type Optional Description

apiAccountIdentity

Object

true

apiAccountIdentity.id

String

false

apiAccountIdentity.organizationId

String

false

apiAccountIdentity.auth0ClientId

String

false

Size must be between 16 and 128 inclusive.

apiAccountIdentity.name

String

true

io.netfoundry.common.util.validation.BasicPattern.

apiAccountIdentity.contactEmail

String

false

Must be a well-formed email address.
Size must be between 6 and 254 inclusive.

apiAccountIdentity.description

String

false

Size must be between 0 and 2048 inclusive.

apiAccountIdentity.active

Boolean

true

apiAccountIdentity.createdAt

Object

false

apiAccountIdentity.updatedAt

Object

false

apiAccountIdentity.deletedAt

Object

true

Returns the date that the identity was deleted or null if the identity has not been deleted. Note, identities are marked as deleted and not returned from searches unless explicitly requested.

apiAccountIdentity.email

String

true

apiAccountIdentity.tenantId

String

true

Deprecated. The Tenant resource has been renamed to Organization. Use getOrganizationId().

Returns the id of the {@link Organization} that this identity is a member of.

apiAccountIdentity.type

String

true

password

String

true

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/api-account-identities' -i -X POST \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJZZUtqNmZvMFN1endRb2pMSEFrYWpnIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6ImJhNGYwODY0LTg5ZDQtNDI3ZS04MzEyLWY3OGM2YzRlNzBmZSIsImF1ZCI6ImlkZW50aXR5IiwiaWF0IjoxNTkyOTMyMTA3LCJleHAiOjE1OTI5MzU3MDcsInBvbGljaWVzIjpbeyJyZXNvdXJjZXMiOlsibmZybjoqIl0sImFjdGlvbnMiOlsiKjoqIl19XSwiZ3JhbnRzLXN1cGVyIjoiW3tcImlkXCI6XCI1N2FiN2ZmMi00MTQ3LTQ3NWEtOTFhZC04YmM2Nzc3MjRlNjZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCIzNGYxMDg0MC1jYmY1LTRjMWQtOWI0Yy1jMjA0OGYzZjQ3NThcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCIyZmNlNzU2My1lYjk0LTRhMjEtOTAzMS02ZDQwNDhmZjE5YTdcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCIwODIxMTRiNy1hZGVhLTQ5MjYtOTY3NC1lNjBmZTJhODM2MGJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJjMmQxODBiMC04MjdhLTRlYzEtYjU4Zi01NWU0ZjcwMTY5NDZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJlZDA3MTE0OS05MDQ4LTQ2YmItYWNjNC1mMDllMzk2ZDM5MjJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJjMWRlMjk2Ni0xZmJmLTRmNTEtYmNhMi05YjU3OTYxMzIzMjBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDV9LHtcImlkXCI6XCIxNDU0NjZlOC1hZTRkLTRiNTAtYjczOS04NWMyMThmOTBmZmRcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJiMTY1Y2MxNS0xNGQ2LTQwYzItODg4My0xZTRiMTU3MTBkMDJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9XSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbXSIsImdyYW50cy1hY3Rpb24iOiJbXSIsImdyYW50cy1zdGFuZGFyZCI6IltdIn0.EZXgtZyZkZ2WM_sti1lXoIIEJMbubs15x9QiCdzhycHZx5Ruh7-Ob9OY5VgxTX9J4O767RbmAjdPQa5TWqm1WGv16Excktk-Z1xHbJI-qUAfLMeV1e4CDq2asisEEu9YQ1KI3gBu_HaE_1VBBzyjW96pcY40-yMKpErZhY-7FHw9exTS7N_91mdn9DBMqvueaGVAyuFcUtJWpKnNKkSG6gpUUuMThueKwUD_yw7AtX9R3aobWPCvSGpkEhLvHCvwPkRlF04BjI3hGv5c6YETQQNEcWTFwGwMcVGdIzGcvydZ5gxV4tLd0VTkM1b02mMg0sHSY1o08pKc4wiCIKeMIA' \
    -d '{"organizationId":"f20456a7-e2c0-4abf-a358-250644369772","name":"HR Bridge Service","contactEmail":"hr.director@acme.com","description":"description goes here","grantDefaultRoles":true}'

Example response

HTTP/1.1 201 Created
Content-Type: application/json;charset=UTF-8
Content-Length: 696

{
  "apiAccountIdentity" : {
    "id" : "59713f67-aad6-4360-8050-84b0196becb9",
    "organizationId" : "f20456a7-e2c0-4abf-a358-250644369772",
    "auth0ClientId" : "b379ee5b-a443-4c26-a6e2-fc5d7d56c2d2",
    "name" : "HR Bridge Service",
    "contactEmail" : "hr.director@acme.com",
    "description" : "description goes here",
    "active" : true,
    "createdAt" : {
      "nano" : 281000000,
      "epochSecond" : 1592932107
    },
    "updatedAt" : null,
    "deletedAt" : null,
    "email" : "hr.director@acme.com",
    "tenantId" : "f20456a7-e2c0-4abf-a358-250644369772",
    "type" : "ApiAccountIdentity"
  },
  "password" : "b379ee5b-a443-4c26-a6e2-fc5d7d56c2d2-PASSWORD-1592932107281"
}

Update Identity Info

PUT /api-account-identities/{id}

Authorization

Valid Authorization Bearer token required, along with a permission grant authorizing access to any referenced resources.

Path parameters

Parameter Type Optional Description

id

Object

false

Client must have update action on the annotated resource.

Query parameters

No parameters.

Request fields

Path Type Optional Description

name

String

true

io.netfoundry.common.util.validation.ValidAs.

contactEmail

String

true

Must be a well-formed email address.
Size must be between 6 and 254 inclusive.

description

String

true

Size must be between 0 and 2048 inclusive.

Response fields

Path Type Optional Description

id

String

false

organizationId

String

false

auth0ClientId

String

false

Size must be between 16 and 128 inclusive.

name

String

true

io.netfoundry.common.util.validation.BasicPattern.

contactEmail

String

false

Must be a well-formed email address.
Size must be between 6 and 254 inclusive.

description

String

false

Size must be between 0 and 2048 inclusive.

active

Boolean

true

createdAt

Object

false

updatedAt

Object

false

deletedAt

Object

true

Returns the date that the identity was deleted or null if the identity has not been deleted. Note, identities are marked as deleted and not returned from searches unless explicitly requested.

email

String

true

tenantId

String

true

Deprecated. The Tenant resource has been renamed to Organization. Use getOrganizationId().

Returns the id of the {@link Organization} that this identity is a member of.

type

String

true

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/api-account-identities/2b8437fd-a043-4c30-bfb8-9a66a855f280' -i -X PUT \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJ0Z2s1dDMxNEtzZVFMb255cmg3Znl3IiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6ImJhNGYwODY0LTg5ZDQtNDI3ZS04MzEyLWY3OGM2YzRlNzBmZSIsImF1ZCI6ImlkZW50aXR5IiwiaWF0IjoxNTkyOTMyMTA1LCJleHAiOjE1OTI5MzU3MDUsInBvbGljaWVzIjpbeyJyZXNvdXJjZXMiOlsibmZybjoqIl0sImFjdGlvbnMiOlsiKjoqIl19XSwiZ3JhbnRzLXN1cGVyIjoiW3tcImlkXCI6XCJjMWRlMjk2Ni0xZmJmLTRmNTEtYmNhMi05YjU3OTYxMzIzMjBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDV9XSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbXSIsImdyYW50cy1hY3Rpb24iOiJbXSIsImdyYW50cy1zdGFuZGFyZCI6IltdIn0.m4vZWN2fbyPxiD1NHxGhJ_-PCU6WN24HoNXugdme8WVJhy2T_4MwqKWPVi9pBn_W1_M7VQWux8AnfLI0CEwvslmF9QMUtZYDB_-bpe5MJd0lfMpUlBBF9-1Bu-z4vn24ZHfTVfHDVYqcMtjIJV8s7jGcrKXhpxLuEIu0Xo-8p19Nfv9JIyfXcgKIQ1ZfAGXc6YhNOFb3y6DbHcBieAOcQzOIR9SiqoY7_HOgmi12xw6AqB1lmy912a2XvnNdQQ2fWdlFD7lly5nxgc-mDKbv8enVOiWzgA5uvzpUCbnv0WeMa1-vTwOViWrcLAVWXzE1wiArFAo6sAGe1dRAUD3vYw' \
    -d '{"name":"Robot","contactEmail":"robot@acme.com","description":"description here."}'

Example response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 583

{
  "id" : "2b8437fd-a043-4c30-bfb8-9a66a855f280",
  "organizationId" : "f20456a7-e2c0-4abf-a358-250644369772",
  "auth0ClientId" : "7ab1ad3f-04f3-43ba-986b-3f7adea995fc",
  "name" : "Robot",
  "contactEmail" : "robot@acme.com",
  "description" : "description here.",
  "active" : true,
  "createdAt" : {
    "nano" : 864000000,
    "epochSecond" : 1592932105
  },
  "updatedAt" : {
    "nano" : 144000000,
    "epochSecond" : 1592932106
  },
  "deletedAt" : null,
  "email" : "robot@acme.com",
  "tenantId" : "f20456a7-e2c0-4abf-a358-250644369772",
  "type" : "ApiAccountIdentity"
}

Activate Or Deactivate Api Account Identity

PUT /api-account-identities/{id}/{action:activate|deactivate}

Authorization

Valid Authorization Bearer token required, along with a permission grant authorizing access to any referenced resources.

Path parameters

Parameter Type Optional Description

id

Object

false

Client must have update-active action on the annotated resource.

action

String

false

Query parameters

No parameters.

Request fields

No request body.

Response fields

Path Type Optional Description

id

String

false

organizationId

String

false

auth0ClientId

String

false

Size must be between 16 and 128 inclusive.

name

String

true

io.netfoundry.common.util.validation.BasicPattern.

contactEmail

String

false

Must be a well-formed email address.
Size must be between 6 and 254 inclusive.

description

String

false

Size must be between 0 and 2048 inclusive.

active

Boolean

true

createdAt

Object

false

updatedAt

Object

false

deletedAt

Object

true

Returns the date that the identity was deleted or null if the identity has not been deleted. Note, identities are marked as deleted and not returned from searches unless explicitly requested.

email

String

true

tenantId

String

true

Deprecated. The Tenant resource has been renamed to Organization. Use getOrganizationId().

Returns the id of the {@link Organization} that this identity is a member of.

type

String

true

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/api-account-identities/433eeb53-6b21-4089-9470-31e6a67dffa5/deactivate' -i -X PUT \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJ0WFIzNzkxekxUcXZHb2ItcmVmZnFnIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6ImJhNGYwODY0LTg5ZDQtNDI3ZS04MzEyLWY3OGM2YzRlNzBmZSIsImF1ZCI6ImlkZW50aXR5IiwiaWF0IjoxNTkyOTMyMTA3LCJleHAiOjE1OTI5MzU3MDcsInBvbGljaWVzIjpbeyJyZXNvdXJjZXMiOlsibmZybjoqIl0sImFjdGlvbnMiOlsiKjoqIl19XSwiZ3JhbnRzLXN1cGVyIjoiW3tcImlkXCI6XCI4MDY5OTJmNC0yYzc2LTQxMDctOTA5YS0yYWIzOGRmNWVjNTlcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCIwODIxMTRiNy1hZGVhLTQ5MjYtOTY3NC1lNjBmZTJhODM2MGJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJlZDA3MTE0OS05MDQ4LTQ2YmItYWNjNC1mMDllMzk2ZDM5MjJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJlMzNiN2YyYS1mODVhLTQzZWMtOTEwOC02N2Y5M2I4NjFkMmFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCJjMGQwZDg4NC1kOWE2LTRjODItYmU1ZC1mY2ExNWFiODUyNTBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCI1N2FiN2ZmMi00MTQ3LTQ3NWEtOTFhZC04YmM2Nzc3MjRlNjZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCIzNGYxMDg0MC1jYmY1LTRjMWQtOWI0Yy1jMjA0OGYzZjQ3NThcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCIyZmNlNzU2My1lYjk0LTRhMjEtOTAzMS02ZDQwNDhmZjE5YTdcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJjMmQxODBiMC04MjdhLTRlYzEtYjU4Zi01NWU0ZjcwMTY5NDZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJjMWRlMjk2Ni0xZmJmLTRmNTEtYmNhMi05YjU3OTYxMzIzMjBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDV9LHtcImlkXCI6XCIxNDU0NjZlOC1hZTRkLTRiNTAtYjczOS04NWMyMThmOTBmZmRcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJiMTY1Y2MxNS0xNGQ2LTQwYzItODg4My0xZTRiMTU3MTBkMDJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCI1ZTIzZmI2My00ZWE4LTQzMjQtODU0NS01NGY0Yzc1MTlhODJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9XSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbXSIsImdyYW50cy1hY3Rpb24iOiJbXSIsImdyYW50cy1zdGFuZGFyZCI6IltdIn0.foaxNJ--mOrpH5tRqlZVW4XKDrQHoLjw5JrkxALs7rU-4JwgbeE_lxhjO6M8cS_3v72r-m8AQ-QaXBIu2md_-zh3JsWamPF11Y4CitYqyo_tjVb5BNZSq9FzBdFaWeMa2tp9Wpg_rS9lJu7K4woFj9tZvMWaXD1k4hqkyX_13o4QBCcdoavEKonR3li-YWHrVvvwmYHn5oYl7uEUlZOqN3q3IRvM4ayWN9dsDWNZJATrTTBrd_pNU_OL42-2Wf3YjMKpMUcq64HZ5bKTaVlUyFIF-JBIsyznGlbdMjaxmqhub1KUelD1UV09iDynEtm_7A2daNTfmh-8XcjlCobjVw'

Example response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 644

{
  "id" : "433eeb53-6b21-4089-9470-31e6a67dffa5",
  "organizationId" : "f20456a7-e2c0-4abf-a358-250644369772",
  "auth0ClientId" : "2b5a24e4-bd35-466b-8066-22fef42905b2",
  "name" : "ACME Internal Service-20",
  "contactEmail" : "service.admin-21@acme.com",
  "description" : "updatable API Account description-22",
  "active" : false,
  "createdAt" : {
    "nano" : 701000000,
    "epochSecond" : 1592932107
  },
  "updatedAt" : {
    "nano" : 748000000,
    "epochSecond" : 1592932107
  },
  "deletedAt" : null,
  "email" : "service.admin-21@acme.com",
  "tenantId" : "f20456a7-e2c0-4abf-a358-250644369772",
  "type" : "ApiAccountIdentity"
}

Invitation

Find Invitations

GET /invitations

Returns a set of Invitation instances based on the optional query parameters. The results will be constrained to the invitations that the client has authorization to view. Results may be further constrained by the setting any combination of query parameter values, which will logically AND’d together to form a filter for matching invitations. The states query parameter, unlike others, supports multiple values. For example, to retrieve a list of active invitations, specify states=Open,Declined,Expired.

Authorization

Valid Authorization Bearer token required, along with a permission grant authorizing access to any referenced resources.

Path parameters

No parameters.

Query parameters

Supports standard paging query parameters.

Parameter Type Optional Description

fromIdentityId

Object

true

The id of the identity that created the target invitation(s).

toTenantId

Object

true

Deprecated..

toOrganizationId

Object

true

The id of the organization that the resulting invitations are inviting into.

invitedEmailAddress

String

true

A full (no partial match support) email address to match against.

targetIdentityId

Object

true

The id of the identity that the invitation will/has assumed.

states

Object

true

One or more {@link State} names to restrict the invitations returned.

Request fields

No request body.

Response fields

Standard paging response where content field is list of following objects:

Path Type Optional Description

id

String

false

fromIdentityId

String

false

toOrganizationId

String

false

invitedEmailAddress

String

false

Must be a well-formed email address.
Size must be between 6 and 254 inclusive.

expiration

Object

false

targetUserIdentityId

String

true

Optional. The identity id that the invited party will be mapped to should they accept the invite.

accepted

Boolean

true

revokedAt

Object

true

The date-time that this invitation was revoked. If null, then this invitation has not been revoked. An open invitation (accepted == null) can be revoked, which will prevent the invitation from being accepted or declined by a user. The accepted state remains null to reflect that it was never accepted or declined. A declined or expired invitation can be revoked after the fact. An accepted invitation can not be revoked retroactively. Finally, revoking an invitation is a terminal operation. Once revoked, no other action can be taken.

responseReceivedAt

Object

true

The date-time that this invitation was marked as accepted or declined. If null, then there has been no response (accept or decline) of this invitation. This is effectively the update timestamp of the accepted property of an invitation.

toTenantId

String

true

Deprecated. The Tenant resource has been renamed to Organization. Use getToOrganizationId().

Returns the id of the {@link Organization} that the recipient is being invited to join.

state

String

true

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/invitations' -i -X GET \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJRa3REbVp4cFVzZXhtSHhfUnpjVVB3IiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6ImJhNGYwODY0LTg5ZDQtNDI3ZS04MzEyLWY3OGM2YzRlNzBmZSIsImF1ZCI6ImlkZW50aXR5IiwiaWF0IjoxNTkyOTMyMTA4LCJleHAiOjE1OTI5MzU3MDgsInBvbGljaWVzIjpbeyJyZXNvdXJjZXMiOlsibmZybjoqIl0sImFjdGlvbnMiOlsiKjoqIl19XSwiZ3JhbnRzLXN1cGVyIjoiW3tcImlkXCI6XCI4MDY5OTJmNC0yYzc2LTQxMDctOTA5YS0yYWIzOGRmNWVjNTlcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCIxNjFlOTU2Mi0wMWI2LTRlMTEtYmY0Zi1kNTgzMzhkYzNjZDNcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCIwODIxMTRiNy1hZGVhLTQ5MjYtOTY3NC1lNjBmZTJhODM2MGJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJlZDA3MTE0OS05MDQ4LTQ2YmItYWNjNC1mMDllMzk2ZDM5MjJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJlMzNiN2YyYS1mODVhLTQzZWMtOTEwOC02N2Y5M2I4NjFkMmFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCJjMGQwZDg4NC1kOWE2LTRjODItYmU1ZC1mY2ExNWFiODUyNTBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCI1N2FiN2ZmMi00MTQ3LTQ3NWEtOTFhZC04YmM2Nzc3MjRlNjZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCIzZGYzOTU3Ni0yZmZmLTRiYzItYmNiNS03NjNhMWU1ZDg4ZWFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCIzNGYxMDg0MC1jYmY1LTRjMWQtOWI0Yy1jMjA0OGYzZjQ3NThcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCIyZmNlNzU2My1lYjk0LTRhMjEtOTAzMS02ZDQwNDhmZjE5YTdcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJjMmQxODBiMC04MjdhLTRlYzEtYjU4Zi01NWU0ZjcwMTY5NDZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCI5ZjIyNGUwNS04MmZiLTQ4ODgtOTY1YS0yMmE2ZGE4MjNhOTFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCJjMWRlMjk2Ni0xZmJmLTRmNTEtYmNhMi05YjU3OTYxMzIzMjBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDV9LHtcImlkXCI6XCIxNDU0NjZlOC1hZTRkLTRiNTAtYjczOS04NWMyMThmOTBmZmRcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJiMTY1Y2MxNS0xNGQ2LTQwYzItODg4My0xZTRiMTU3MTBkMDJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCI1ZTIzZmI2My00ZWE4LTQzMjQtODU0NS01NGY0Yzc1MTlhODJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCJkMjQ2ODliZC03NWZmLTQ4MzYtOTM0Ni03ODYwOWFlMmZmOGVcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCJkZDUzYWU3NS01MzA2LTRhNDktOWE5Yi1iNjAzZDdmOTM0MDZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9XSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbXSIsImdyYW50cy1hY3Rpb24iOiJbXSIsImdyYW50cy1zdGFuZGFyZCI6IltdIn0.BVHWUJ1OM_OZLM7SbThzzfCy8zn9nr5ktSejOtk9GR58bIWf20AzAlY_gUcIgy2xrnhz5_NhtEjdq0c22Ffka-LBv5rL8rQsE-vmel_4fgCz08Vi4WgVgAAEHe5aRIuXhpaiAzdlk8fdXsae4F3nTkyCFAde5e7-EC0OfUo8JxRgLWO-AGkZy_RhTljQSja8GOT0fwxKXFe5x_IO12Q3usyqnFYP-xj84Df0wSA3uzvX_pi6CMV8LiRBY6gjCbdkwZS9Kg-NFhYJ7LlTo87-FMYqTjulQKx5k6YFZFIbuW9W40I69HO6Q8SvFr_l0-jyzISgogwHIt39kXg2lAtgfw'

Example response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 527

[ {
  "id" : "1a534fb5-b475-4b3e-adda-5e159e6dd46b",
  "fromIdentityId" : "ba4f0864-89d4-427e-8312-f78c6c4e70fe",
  "toOrganizationId" : "f20456a7-e2c0-4abf-a358-250644369772",
  "invitedEmailAddress" : "new.employee@acme.com",
  "expiration" : {
    "nano" : 189000000,
    "epochSecond" : 1593536908
  },
  "targetUserIdentityId" : "67403fb3-cded-4a20-a146-df4c2b493c45",
  "accepted" : null,
  "revokedAt" : null,
  "responseReceivedAt" : null,
  "toTenantId" : "f20456a7-e2c0-4abf-a358-250644369772",
  "state" : "Open"
} ]

Get Invitation By Id

GET /invitations/{id:[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}}

Authorization

Valid Authorization Bearer token required, along with a permission grant authorizing access to any referenced resources.

Path parameters

Parameter Type Optional Description

id

Object

false

Client must have read action on the annotated resource.

Query parameters

No parameters.

Request fields

No request body.

Response fields

Path Type Optional Description

id

String

false

fromIdentityId

String

false

toOrganizationId

String

false

invitedEmailAddress

String

false

Must be a well-formed email address.
Size must be between 6 and 254 inclusive.

expiration

Object

false

targetUserIdentityId

String

true

Optional. The identity id that the invited party will be mapped to should they accept the invite.

accepted

Boolean

true

revokedAt

Object

true

The date-time that this invitation was revoked. If null, then this invitation has not been revoked. An open invitation (accepted == null) can be revoked, which will prevent the invitation from being accepted or declined by a user. The accepted state remains null to reflect that it was never accepted or declined. A declined or expired invitation can be revoked after the fact. An accepted invitation can not be revoked retroactively. Finally, revoking an invitation is a terminal operation. Once revoked, no other action can be taken.

responseReceivedAt

Object

true

The date-time that this invitation was marked as accepted or declined. If null, then there has been no response (accept or decline) of this invitation. This is effectively the update timestamp of the accepted property of an invitation.

toTenantId

String

true

Deprecated. The Tenant resource has been renamed to Organization. Use getToOrganizationId().

Returns the id of the {@link Organization} that the recipient is being invited to join.

state

String

true

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/invitations/df29fe52-1a89-4871-b0eb-bcba6d7b7987' -i -X GET \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJfcTlMVGwyeEpnTEdqbkNVWVZ5Q0xnIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6ImJhNGYwODY0LTg5ZDQtNDI3ZS04MzEyLWY3OGM2YzRlNzBmZSIsImF1ZCI6ImlkZW50aXR5IiwiaWF0IjoxNTkyOTMyMTA4LCJleHAiOjE1OTI5MzU3MDgsInBvbGljaWVzIjpbeyJyZXNvdXJjZXMiOlsibmZybjoqIl0sImFjdGlvbnMiOlsiKjoqIl19XSwiZ3JhbnRzLXN1cGVyIjoiW3tcImlkXCI6XCI4MDY5OTJmNC0yYzc2LTQxMDctOTA5YS0yYWIzOGRmNWVjNTlcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCIxNjFlOTU2Mi0wMWI2LTRlMTEtYmY0Zi1kNTgzMzhkYzNjZDNcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCIwODIxMTRiNy1hZGVhLTQ5MjYtOTY3NC1lNjBmZTJhODM2MGJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJlZDA3MTE0OS05MDQ4LTQ2YmItYWNjNC1mMDllMzk2ZDM5MjJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJlMzNiN2YyYS1mODVhLTQzZWMtOTEwOC02N2Y5M2I4NjFkMmFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCJjMGQwZDg4NC1kOWE2LTRjODItYmU1ZC1mY2ExNWFiODUyNTBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCI1N2FiN2ZmMi00MTQ3LTQ3NWEtOTFhZC04YmM2Nzc3MjRlNjZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCIzZGYzOTU3Ni0yZmZmLTRiYzItYmNiNS03NjNhMWU1ZDg4ZWFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCJiNmYzNTI5Yi04ODc2LTQ5NjUtYmQ2ZC02ODIzY2VhYzdlOGRcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCIzNGYxMDg0MC1jYmY1LTRjMWQtOWI0Yy1jMjA0OGYzZjQ3NThcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCIyZmNlNzU2My1lYjk0LTRhMjEtOTAzMS02ZDQwNDhmZjE5YTdcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJjMmQxODBiMC04MjdhLTRlYzEtYjU4Zi01NWU0ZjcwMTY5NDZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCI5ZjIyNGUwNS04MmZiLTQ4ODgtOTY1YS0yMmE2ZGE4MjNhOTFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCJjMWRlMjk2Ni0xZmJmLTRmNTEtYmNhMi05YjU3OTYxMzIzMjBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDV9LHtcImlkXCI6XCIxNDU0NjZlOC1hZTRkLTRiNTAtYjczOS04NWMyMThmOTBmZmRcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJiMTY1Y2MxNS0xNGQ2LTQwYzItODg4My0xZTRiMTU3MTBkMDJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCI1ZTIzZmI2My00ZWE4LTQzMjQtODU0NS01NGY0Yzc1MTlhODJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCJiZDYyYmNlYy02MGY5LTQwNzUtOTExMS1mNjM1NTI0OGE5ZmRcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCJkMjQ2ODliZC03NWZmLTQ4MzYtOTM0Ni03ODYwOWFlMmZmOGVcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCJkZDUzYWU3NS01MzA2LTRhNDktOWE5Yi1iNjAzZDdmOTM0MDZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9XSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbXSIsImdyYW50cy1hY3Rpb24iOiJbXSIsImdyYW50cy1zdGFuZGFyZCI6IltdIn0.gVsZ6exUnPk6NIi5UGvYAXuGearmGC7axObtLaAPRmOGkro-vB1XP9L7bCBxS8ICf56gqUI7o05R3lJyTqnthkbf--bA3VZWjredgCRvShSoQ4GRdbvk18cGOvJ3w0O4Z8ml624uGhvzKJGPe6-IPxJa1AN7uRvSPPbO2GESU-XhR_VXgEQZc5hi5P3rEu1RMwOomJPmXSGozcGBx-u5kbrGIWwTegpsVjDtzX26PAY2YijYxoTggu5pKwHcIfeATep2k65j0a0Vudz5iUXCu27UuvCWYeV7yOTM5Ht9pCaxd2ollL6s-w1ctp4qUdJOuI6mfscoMsWieGrjxuAb2w'

Example response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 526

{
  "id" : "df29fe52-1a89-4871-b0eb-bcba6d7b7987",
  "fromIdentityId" : "8fa7308e-175b-40d4-a752-67430695864c",
  "toOrganizationId" : "f20456a7-e2c0-4abf-a358-250644369772",
  "invitedEmailAddress" : "new.employee-37@acme.com",
  "expiration" : {
    "nano" : 610000000,
    "epochSecond" : 1593536908
  },
  "targetUserIdentityId" : "bddbb86f-6f48-4248-9ab2-e2db0c868e15",
  "accepted" : null,
  "revokedAt" : null,
  "responseReceivedAt" : null,
  "toTenantId" : "f20456a7-e2c0-4abf-a358-250644369772",
  "state" : "Open"
}

Create Invitation

POST /invitations

Authorization

Valid Authorization Bearer token required, along with a permission grant authorizing access to any referenced resources.

Path parameters

No parameters.

Query parameters

No parameters.

Request fields

Path Type Optional Description

toOrganizationId

String

false

Client must have create action under the annotated resource.

invitedEmailAddress

String

false

Must be a well-formed email address.
Size must be between 6 and 254 inclusive.

invitationUrl

String

false

targetUserIdentityId

String

true

Client must have read action on the annotated resource.

Response fields

Path Type Optional Description

id

String

false

fromIdentityId

String

false

toOrganizationId

String

false

invitedEmailAddress

String

false

Must be a well-formed email address.
Size must be between 6 and 254 inclusive.

expiration

Object

false

targetUserIdentityId

String

true

Optional. The identity id that the invited party will be mapped to should they accept the invite.

accepted

Boolean

true

revokedAt

Object

true

The date-time that this invitation was revoked. If null, then this invitation has not been revoked. An open invitation (accepted == null) can be revoked, which will prevent the invitation from being accepted or declined by a user. The accepted state remains null to reflect that it was never accepted or declined. A declined or expired invitation can be revoked after the fact. An accepted invitation can not be revoked retroactively. Finally, revoking an invitation is a terminal operation. Once revoked, no other action can be taken.

responseReceivedAt

Object

true

The date-time that this invitation was marked as accepted or declined. If null, then there has been no response (accept or decline) of this invitation. This is effectively the update timestamp of the accepted property of an invitation.

toTenantId

String

true

Deprecated. The Tenant resource has been renamed to Organization. Use getToOrganizationId().

Returns the id of the {@link Organization} that the recipient is being invited to join.

state

String

true

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/invitations' -i -X POST \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJkYXlKX21iU1pfUGI5bnd6YVNDb3JBIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6ImJhNGYwODY0LTg5ZDQtNDI3ZS04MzEyLWY3OGM2YzRlNzBmZSIsImF1ZCI6ImlkZW50aXR5IiwiaWF0IjoxNTkyOTMyMTA4LCJleHAiOjE1OTI5MzU3MDgsInBvbGljaWVzIjpbeyJyZXNvdXJjZXMiOlsibmZybjoqIl0sImFjdGlvbnMiOlsiKjoqIl19XSwiZ3JhbnRzLXN1cGVyIjoiW3tcImlkXCI6XCI4MDY5OTJmNC0yYzc2LTQxMDctOTA5YS0yYWIzOGRmNWVjNTlcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCIxNjFlOTU2Mi0wMWI2LTRlMTEtYmY0Zi1kNTgzMzhkYzNjZDNcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCIwODIxMTRiNy1hZGVhLTQ5MjYtOTY3NC1lNjBmZTJhODM2MGJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJlZDA3MTE0OS05MDQ4LTQ2YmItYWNjNC1mMDllMzk2ZDM5MjJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJlMzNiN2YyYS1mODVhLTQzZWMtOTEwOC02N2Y5M2I4NjFkMmFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCJjMGQwZDg4NC1kOWE2LTRjODItYmU1ZC1mY2ExNWFiODUyNTBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCI1N2FiN2ZmMi00MTQ3LTQ3NWEtOTFhZC04YmM2Nzc3MjRlNjZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCIzNGYxMDg0MC1jYmY1LTRjMWQtOWI0Yy1jMjA0OGYzZjQ3NThcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCIyZmNlNzU2My1lYjk0LTRhMjEtOTAzMS02ZDQwNDhmZjE5YTdcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJjMmQxODBiMC04MjdhLTRlYzEtYjU4Zi01NWU0ZjcwMTY5NDZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCI5ZjIyNGUwNS04MmZiLTQ4ODgtOTY1YS0yMmE2ZGE4MjNhOTFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCJjMWRlMjk2Ni0xZmJmLTRmNTEtYmNhMi05YjU3OTYxMzIzMjBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDV9LHtcImlkXCI6XCIxNDU0NjZlOC1hZTRkLTRiNTAtYjczOS04NWMyMThmOTBmZmRcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJiMTY1Y2MxNS0xNGQ2LTQwYzItODg4My0xZTRiMTU3MTBkMDJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCI1ZTIzZmI2My00ZWE4LTQzMjQtODU0NS01NGY0Yzc1MTlhODJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCJkMjQ2ODliZC03NWZmLTQ4MzYtOTM0Ni03ODYwOWFlMmZmOGVcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCJkZDUzYWU3NS01MzA2LTRhNDktOWE5Yi1iNjAzZDdmOTM0MDZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9XSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbXSIsImdyYW50cy1hY3Rpb24iOiJbXSIsImdyYW50cy1zdGFuZGFyZCI6IltdIn0.t0S0OYc56h9Z-E8Sv5vanMZvAy1dG16PA2OvUEbpWZGrRHDzmLBHiNUq_McBOs78NhtdkJHgppDtOT6voW6KeS0OLeEMlapyBZYnbbTysEWzlHdUI5HfRWYaju_VHjV375nNo5KpXspx4wv_k99hJhaiBPHnmbEMtRaSO9T0OxBDrEpjXCsaWa6a0_4OiRGF6wmUypdc8e8IxKqtRJ_cTb2-twNUKcBoCeXDP9Qk8Loe6Nez7Mx7qRhYRUB17c5coLsJ10rqn6C2B2UIGf2f4vZpsNe8UwEV2Op3x6HX9-pkhdTsldx4m9dSzFdOTSjJA-7I7wvkQIjoizaQVgUaqQ' \
    -d '{"toOrganizationId":"f20456a7-e2c0-4abf-a358-250644369772","invitedEmailAddress":"new.employee@acme.com","invitationUrl":"http://acme.console.netfoundry.io/invitation","targetUserIdentityId":"67403fb3-cded-4a20-a146-df4c2b493c45"}'

Example response

HTTP/1.1 201 Created
Content-Type: application/json;charset=UTF-8
Content-Length: 523

{
  "id" : "1a534fb5-b475-4b3e-adda-5e159e6dd46b",
  "fromIdentityId" : "ba4f0864-89d4-427e-8312-f78c6c4e70fe",
  "toOrganizationId" : "f20456a7-e2c0-4abf-a358-250644369772",
  "invitedEmailAddress" : "new.employee@acme.com",
  "expiration" : {
    "nano" : 189000000,
    "epochSecond" : 1593536908
  },
  "targetUserIdentityId" : "67403fb3-cded-4a20-a146-df4c2b493c45",
  "accepted" : null,
  "revokedAt" : null,
  "responseReceivedAt" : null,
  "toTenantId" : "f20456a7-e2c0-4abf-a358-250644369772",
  "state" : "Open"
}

Respond To Invitation

PUT /invitations/{id:[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}}/{action:accept|decline}

This is not the typical way to accept or decline an invitation. See {@link InvitationFlowController}. This service is a straight update of the Invitation. It does not map the calling user, nor any other related activity. It simply updates the state of the Invitation.

Authorization

Valid Authorization Bearer token required, along with a permission grant authorizing access to any referenced resources.

Path parameters

Parameter Type Optional Description

id

Object

false

Client must have update-respond action on the annotated resource.

action

String

false

Query parameters

No parameters.

Request fields

No request body.

Response fields

Path Type Optional Description

id

String

false

fromIdentityId

String

false

toOrganizationId

String

false

invitedEmailAddress

String

false

Must be a well-formed email address.
Size must be between 6 and 254 inclusive.

expiration

Object

false

targetUserIdentityId

String

true

Optional. The identity id that the invited party will be mapped to should they accept the invite.

accepted

Boolean

true

revokedAt

Object

true

The date-time that this invitation was revoked. If null, then this invitation has not been revoked. An open invitation (accepted == null) can be revoked, which will prevent the invitation from being accepted or declined by a user. The accepted state remains null to reflect that it was never accepted or declined. A declined or expired invitation can be revoked after the fact. An accepted invitation can not be revoked retroactively. Finally, revoking an invitation is a terminal operation. Once revoked, no other action can be taken.

responseReceivedAt

Object

true

The date-time that this invitation was marked as accepted or declined. If null, then there has been no response (accept or decline) of this invitation. This is effectively the update timestamp of the accepted property of an invitation.

toTenantId

String

true

Deprecated. The Tenant resource has been renamed to Organization. Use getToOrganizationId().

Returns the id of the {@link Organization} that the recipient is being invited to join.

state

String

true

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/invitations/b4852dbf-9108-4a7e-aab3-44e573401233/decline' -i -X PUT \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJkRi1XZExSM3gxV0ZoU1JURlRCckFnIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6ImJhNGYwODY0LTg5ZDQtNDI3ZS04MzEyLWY3OGM2YzRlNzBmZSIsImF1ZCI6ImlkZW50aXR5IiwiaWF0IjoxNTkyOTMyMTA4LCJleHAiOjE1OTI5MzU3MDgsInBvbGljaWVzIjpbeyJyZXNvdXJjZXMiOlsibmZybjoqIl0sImFjdGlvbnMiOlsiKjoqIl19XSwiZ3JhbnRzLXN1cGVyIjoiW3tcImlkXCI6XCI4MDY5OTJmNC0yYzc2LTQxMDctOTA5YS0yYWIzOGRmNWVjNTlcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCIxNjFlOTU2Mi0wMWI2LTRlMTEtYmY0Zi1kNTgzMzhkYzNjZDNcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCIwODIxMTRiNy1hZGVhLTQ5MjYtOTY3NC1lNjBmZTJhODM2MGJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJlZDA3MTE0OS05MDQ4LTQ2YmItYWNjNC1mMDllMzk2ZDM5MjJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJlMzNiN2YyYS1mODVhLTQzZWMtOTEwOC02N2Y5M2I4NjFkMmFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCJjMGQwZDg4NC1kOWE2LTRjODItYmU1ZC1mY2ExNWFiODUyNTBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCI1N2FiN2ZmMi00MTQ3LTQ3NWEtOTFhZC04YmM2Nzc3MjRlNjZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCIzZGYzOTU3Ni0yZmZmLTRiYzItYmNiNS03NjNhMWU1ZDg4ZWFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCJiNmYzNTI5Yi04ODc2LTQ5NjUtYmQ2ZC02ODIzY2VhYzdlOGRcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCIzNGYxMDg0MC1jYmY1LTRjMWQtOWI0Yy1jMjA0OGYzZjQ3NThcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCIyZmNlNzU2My1lYjk0LTRhMjEtOTAzMS02ZDQwNDhmZjE5YTdcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJjMmQxODBiMC04MjdhLTRlYzEtYjU4Zi01NWU0ZjcwMTY5NDZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCI5ZjIyNGUwNS04MmZiLTQ4ODgtOTY1YS0yMmE2ZGE4MjNhOTFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCJjMWRlMjk2Ni0xZmJmLTRmNTEtYmNhMi05YjU3OTYxMzIzMjBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDV9LHtcImlkXCI6XCIxNDU0NjZlOC1hZTRkLTRiNTAtYjczOS04NWMyMThmOTBmZmRcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJiMTY1Y2MxNS0xNGQ2LTQwYzItODg4My0xZTRiMTU3MTBkMDJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCI1ZTIzZmI2My00ZWE4LTQzMjQtODU0NS01NGY0Yzc1MTlhODJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCJkMjQ2ODliZC03NWZmLTQ4MzYtOTM0Ni03ODYwOWFlMmZmOGVcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCJkZDUzYWU3NS01MzA2LTRhNDktOWE5Yi1iNjAzZDdmOTM0MDZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9XSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbXSIsImdyYW50cy1hY3Rpb24iOiJbXSIsImdyYW50cy1zdGFuZGFyZCI6IltdIn0.SrkxI9WCXQtmXOiuEDAkW_fCELOFsOh17UwoFT1zu9WbcXgSOQ0MenJe4G3SwhcSAbzW5eXQEEKPcweLv9fd1P6KnZWLUmJb1GkTEUbxuDL1TQk3YJY3nZSIeptRy6r0fTRQwXUyvfOyQVaRnIqyJhE4_8S2oUTjdBJ0xGoW_HrCq6DDZnEf9fBjjwzQqNx4kRaK66E1QCBpTlT0JNk6vJBNGw1BLnC65gbOrZTN4K6nDq4oIQVRTaToukbV8_GjIGlDxTOYuY-JvTcusyEm8pK1vhlyMAU2BEYt-_kokfywuKBRKg4nO6bNVHaFa-aRGt5YHCF5t5fANcbytxOF_g'

Example response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 587

{
  "id" : "b4852dbf-9108-4a7e-aab3-44e573401233",
  "fromIdentityId" : "8fa7308e-175b-40d4-a752-67430695864c",
  "toOrganizationId" : "f20456a7-e2c0-4abf-a358-250644369772",
  "invitedEmailAddress" : "new.employee-34@acme.com",
  "expiration" : {
    "nano" : 467000000,
    "epochSecond" : 1593536908
  },
  "targetUserIdentityId" : "2942636f-7ba4-4c9a-bea3-0b625ad705c2",
  "accepted" : false,
  "revokedAt" : null,
  "responseReceivedAt" : {
    "nano" : 509000000,
    "epochSecond" : 1592932108
  },
  "toTenantId" : "f20456a7-e2c0-4abf-a358-250644369772",
  "state" : "Declined"
}

Revoke Invitation

PUT /invitations/{id:[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}}/revoke

This service will revoke the specified invitation if it is in a state that permits revoke.

Authorization

Valid Authorization Bearer token required, along with a permission grant authorizing access to any referenced resources.

Path parameters

Parameter Type Optional Description

id

Object

false

Client must have update-revoke action on the annotated resource.

Query parameters

No parameters.

Request fields

No request body.

Response fields

Path Type Optional Description

id

String

false

fromIdentityId

String

false

toOrganizationId

String

false

invitedEmailAddress

String

false

Must be a well-formed email address.
Size must be between 6 and 254 inclusive.

expiration

Object

false

targetUserIdentityId

String

true

Optional. The identity id that the invited party will be mapped to should they accept the invite.

accepted

Boolean

true

revokedAt

Object

true

The date-time that this invitation was revoked. If null, then this invitation has not been revoked. An open invitation (accepted == null) can be revoked, which will prevent the invitation from being accepted or declined by a user. The accepted state remains null to reflect that it was never accepted or declined. A declined or expired invitation can be revoked after the fact. An accepted invitation can not be revoked retroactively. Finally, revoking an invitation is a terminal operation. Once revoked, no other action can be taken.

responseReceivedAt

Object

true

The date-time that this invitation was marked as accepted or declined. If null, then there has been no response (accept or decline) of this invitation. This is effectively the update timestamp of the accepted property of an invitation.

toTenantId

String

true

Deprecated. The Tenant resource has been renamed to Organization. Use getToOrganizationId().

Returns the id of the {@link Organization} that the recipient is being invited to join.

state

String

true

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/invitations/544326a0-a6b7-416f-aacd-467f2821c33d/revoke' -i -X PUT \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJxYUdxQkw1NVNBOGFOTFN6VUF0bXNRIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6ImJhNGYwODY0LTg5ZDQtNDI3ZS04MzEyLWY3OGM2YzRlNzBmZSIsImF1ZCI6ImlkZW50aXR5IiwiaWF0IjoxNTkyOTMyMTA4LCJleHAiOjE1OTI5MzU3MDgsInBvbGljaWVzIjpbeyJyZXNvdXJjZXMiOlsibmZybjoqIl0sImFjdGlvbnMiOlsiKjoqIl19XSwiZ3JhbnRzLXN1cGVyIjoiW3tcImlkXCI6XCI4MDY5OTJmNC0yYzc2LTQxMDctOTA5YS0yYWIzOGRmNWVjNTlcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCIxNjFlOTU2Mi0wMWI2LTRlMTEtYmY0Zi1kNTgzMzhkYzNjZDNcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCIwODIxMTRiNy1hZGVhLTQ5MjYtOTY3NC1lNjBmZTJhODM2MGJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJlZDA3MTE0OS05MDQ4LTQ2YmItYWNjNC1mMDllMzk2ZDM5MjJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJlMzNiN2YyYS1mODVhLTQzZWMtOTEwOC02N2Y5M2I4NjFkMmFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCJjOTM2NWEwNS04YzMwLTRkMDQtYTAxMy1jZTAwODljNWZlZWNcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCJjMGQwZDg4NC1kOWE2LTRjODItYmU1ZC1mY2ExNWFiODUyNTBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCI1N2FiN2ZmMi00MTQ3LTQ3NWEtOTFhZC04YmM2Nzc3MjRlNjZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCIzZGYzOTU3Ni0yZmZmLTRiYzItYmNiNS03NjNhMWU1ZDg4ZWFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCJiNmYzNTI5Yi04ODc2LTQ5NjUtYmQ2ZC02ODIzY2VhYzdlOGRcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCIzNGYxMDg0MC1jYmY1LTRjMWQtOWI0Yy1jMjA0OGYzZjQ3NThcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCIyZmNlNzU2My1lYjk0LTRhMjEtOTAzMS02ZDQwNDhmZjE5YTdcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJjMmQxODBiMC04MjdhLTRlYzEtYjU4Zi01NWU0ZjcwMTY5NDZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCI5ZjIyNGUwNS04MmZiLTQ4ODgtOTY1YS0yMmE2ZGE4MjNhOTFcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCJjMWRlMjk2Ni0xZmJmLTRmNTEtYmNhMi05YjU3OTYxMzIzMjBcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDV9LHtcImlkXCI6XCIxNDU0NjZlOC1hZTRkLTRiNTAtYjczOS04NWMyMThmOTBmZmRcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDZ9LHtcImlkXCI6XCJiMTY1Y2MxNS0xNGQ2LTQwYzItODg4My0xZTRiMTU3MTBkMDJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCI1ZTIzZmI2My00ZWE4LTQzMjQtODU0NS01NGY0Yzc1MTlhODJcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDd9LHtcImlkXCI6XCJiZDYyYmNlYy02MGY5LTQwNzUtOTExMS1mNjM1NTI0OGE5ZmRcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCJkMjQ2ODliZC03NWZmLTQ4MzYtOTM0Ni03ODYwOWFlMmZmOGVcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9LHtcImlkXCI6XCJkZDUzYWU3NS01MzA2LTRhNDktOWE5Yi1iNjAzZDdmOTM0MDZcIixcImxhc3RNb2RpZmllZFwiOjE1OTI5MzIxMDh9XSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbXSIsImdyYW50cy1hY3Rpb24iOiJbXSIsImdyYW50cy1zdGFuZGFyZCI6IltdIn0.XCwL7uD--UEsUPhWASPz8ZLMGif8AFP45BNpQmg7rpoxWrdsOwKeQjtMGU18x2hlkyz38rRzDMFWiCjFOKzoHnU--yCnteaoA8TC9A9jtBJ2Y1dGMksnhOVg5IbJxXFVUtbEM0XR_A-JB2amJwrVExtKJSEcimSh06q7wxGh9zfZt0icQ2fmHrq29jR6JRgN1IICvfeSzKtqLt4RbWJPOJOKJHwyZRNEOfCW8WniiY9GOYVIPMmaXQ-3M975x2DFV6bC1FpJogIyzicZeSbeP_UrOWRATlJkpvlfzho4r2wyRByg5A2H-3ZVDsmpKL2ErmyYMyM_OHqom54aVpR_Bg'

Example response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 641

{
  "id" : "544326a0-a6b7-416f-aacd-467f2821c33d",
  "fromIdentityId" : "8fa7308e-175b-40d4-a752-67430695864c",
  "toOrganizationId" : "f20456a7-e2c0-4abf-a358-250644369772",
  "invitedEmailAddress" : "new.employee-40@acme.com",
  "expiration" : {
    "nano" : 826000000,
    "epochSecond" : 1593536908
  },
  "targetUserIdentityId" : "ed1348eb-a87f-4ad1-b7fd-8c6a4968a5c6",
  "accepted" : null,
  "revokedAt" : {
    "nano" : 873000000,
    "epochSecond" : 1592932108
  },
  "responseReceivedAt" : {
    "nano" : 873000000,
    "epochSecond" : 1592932108
  },
  "toTenantId" : "f20456a7-e2c0-4abf-a358-250644369772",
  "state" : "Revoked"
}

Support

Create Support Request

POST /nfconsole/support/requests

Authorization

Authorization not required for this request.

Path parameters

No parameters.

Query parameters

No parameters.

Request fields

Path Type Optional Description

name

String

true

The name of the user. This is a required value if the request is submitted by a client that is not currently authenticated. In this unauthenticated case, this name is used in the support request ticket that is created. If the request comes from an authenticated client, then this property should be ignored (not sent), as the API will overwrite it with the name of the authenticated identity.

Size must be between 1 and 2147483647 inclusive.

email

String

true

The email of the user. This is a required value if the request is submitted by a client that is not currently authenticated. In this unauthenticated case, this email is used in the support request ticket that is created. If the request comes from an authenticated client, then this property should be ignored (not sent), as the API will overwrite it with the email of the authenticated identity.

Must be a well-formed email address.

selectedOrganizationId

String

true

The id of an organization which the current user has selected as his working context at the time that this support request is being generated. This value may be null in most cases as it only applies to users with access to more than one organization. This value is ignored if the support request comes from a user that is not logged in.

selectedNetworkId

String

true

The id of a network which the current user has selected as his working context at the time that this support request is being generated. This value may be null, particularly if the client is submitting the support request from a context that is not network specific. However, if the user is working in a context (ie, a 'page' that lists AppWans) that is network specific, then this value can help support agents when reviewing the support request. This value is ignored if the support request comes from a user that is not logged in.

subject

String

false

The support request subject. This value is required and can not be empty.

comment

String

false

The support request message. This value is required and can not be empty.

type

String

true

The type of the support request. If not specified, the type will default to "question".

Must be one of [problem, incident, question, task].

priority

String

true

The priority of the support request. If not specified, the type will default to "normal".

Must be one of [urgent, high, normal, low].

recentErrorMessages

Array[String]

true

An optional list of error messages received from the API by the client. These should be in order from most recent to oldest. These provide contextual information for the agent handling the support request. These are not required, but clients are encouraged to track and supply such error messages to aid in support. Note, an interactive user (ie human) should not provide this information; it should be tracked and added by the client agent on their behalf.

Response fields

No response body.

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/nfconsole/support/requests' -i -X POST \
    -H 'Content-Type: application/json' \
    -d '{"name":"Curious George","email":"george@curious-client.com","selectedOrganizationId":null,"selectedNetworkId":null,"subject":"Sales Contact Request","comment":"This looks great!  I'd like a sales rep to contact me.","type":"question","priority":"high","recentErrorMessages":null}'

Example response

HTTP/1.1 200 OK

Sign-up Flow

Check Email

GET /signup

This service allows a client to validate that the submitted email may be used during the sign-up process. Not all email addresses are supported, and clients are encouraged to use this service to check before getting an error from the sign-up service.

Authorization

Authorization not required for this request.

Path parameters

No parameters.

Query parameters

Parameter Type Optional Description

checkEmail

String

false

The email address to check.

Must be a well-formed email address.
Size must be between 6 and 254 inclusive.

provider

String

true

Request fields

No request body.

Response fields

Path Type Optional Description

checkEmail

String

false

The email address that whose status was checked.

Must be a well-formed email address.
Size must be between 6 and 254 inclusive.

status

String

false

The current status of the checked email address.

Must be one of [VALID, BLACKLISTED].

Example request, valid

$ curl 'https://gateway.netFoundry.io/identity/v1/signup?checkEmail=white.hat@trusted.com' -i -X GET

Example response, valid

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 66

{
  "checkEmail" : "white.hat@trusted.com",
  "status" : "VALID"
}

Example request, blacklisted

$ curl 'https://gateway.netFoundry.io/identity/v1/signup?checkEmail=black.hat@untrusted.com' -i -X GET

Example response, blacklisted

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 74

{
  "checkEmail" : "black.hat@untrusted.com",
  "status" : "BLACKLISTED"
}

Find Identity Provider Types

GET /identity-provider-types

This service provides a list of available IdentityProviderTypes. It does not require authentication, as any client that is preparing to create a new Organization via the sign-up process must be able to list the set of IdentityProviderTypes to the user prior to creation of the Organization.

Authorization

Authorization not required for this request.

Path parameters

No parameters.

Query parameters

No parameters.

Request fields

No request body.

Response fields

Path Type Optional Description

[].id

String

false

Unique id of this IdentityProviderType instance.

[].identityProviderTypeName

String

false

A simple label for display to a human user.

Size must be between 1 and 128 inclusive.

[].auth0ConnectionId

String

false

An opaque value used by Auth0 to identify their Identity Provider.

Size must be between 1 and 128 inclusive.

[].auth0ConnectionType

String

false

One of four types of connections that Auth0 supports.

Must be one of [Database, Social, Enterprise, Passwordless].

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/identity-provider-types' -i -X GET

Example response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 391

[ {
  "id" : "474342c9-9d52-4da8-ba20-3ad04a9666b1",
  "identityProviderTypeName" : "Google Account",
  "auth0ConnectionId" : "google-oauth2",
  "auth0ConnectionType" : "Social"
}, {
  "id" : "91cff470-70d9-4e99-bfd8-3c7920d6a552",
  "identityProviderTypeName" : "Simple Username/Password",
  "auth0ConnectionId" : "Username-Password-Authentication",
  "auth0ConnectionType" : "Database"
} ]

Signup

POST /signup

This service can be used to create a new Organization. The client specifies a basic set of Organization information, such as a descriptive name and a site label, as well as other configuration details. The client must specify how the Organization wishes to authenticate its users by passing one or more specifications for an IdentityProvider. A client may call the Find Identity Provider Types service to preview a list of available authentication mechanisms. Finally, the client must specify user information for the initial 'root' user of the Organization. Upon successful completion of the service request, the API Server will send the user an email with instructions to complete the sign-up process. Note, the API Server does not permit sending invitations to all email addresses. A client may check to see if an email address is supported by calling the Check Email Address service prior to calling this sign-up service.

Authorization

Authorization not required for this request.

Path parameters

No parameters.

Query parameters

No parameters.

Request fields

Path Type Optional Description

organizationName

String

false

A human friendly name for the Organization. This will become the Organization’s name property.

Size must be between 1 and 128 inclusive.

organizationLabel

String

false

A domain name label, used to compose the Organization’s custom site domain. The value can be 1 to 63 alpha-numeric or hyphen characters, but may not begin or end with a hyphen.

Must match the regular expression \p{Alnum}|\p{Alnum}[-\p{Alnum}]{0,61}\p{Alnum}.

identityProviders

Array[Object]

false

A non-empty set of identity providers that the Organization should allow users to login through.

identityProviders[].name

String

false

A human friendly name for the IdentityProvider. This value is specific to the Organization, even if the authentication mechanism is shared across many Organizations (social based authentication being a prime example.).

Size must be between 1 and 128 inclusive.

identityProviders[].identityProviderTypeId

String

false

The IdentityProviderType.id of the IdentityProviderType to create and use within the Organization. See service to get a list of available IdentityProviderTypes.

signupUrl

String

false

A fully qualified http or https url where the sign-up email will link to, so that the sign-up user may complete the sign-up process.

billingInfo

Object

true

billingInfo.type

String

true
true
true
true
true

If type is trial, then the Billing organization will be setup as trial.
If type is Enterprise, then the Billing organization will be setup as Enterprise.

Must be one of [Trial, AWS, Stripe, Enterprise].
Must be one of [Trial, AWS, Stripe, Enterprise].
Must be one of [Trial, AWS, Stripe, Enterprise].
Must be one of [Trial, AWS, Stripe, Enterprise].

billingInfo.customerEmail

String

true
true

billingInfo.productId

String

true
false

The product Id to use for billing AWS market place customer.

billingInfo.customerId

String

false

The customer Id to use for billing aws market place customer. If the type is AWS and customer Id is provided, then the Billing organization will be setup as enterprise.

billingInfo.stripeCardToken

String

false

The token from Stripe for the card to use for billing. If the type is stripe and stripeCardToken is provided, then the Billing organization will be setup as self-service.

adminUsers

Array[Object]

false

An ordered list of initial user accounts to create within this organization. All will be granted administrative access. The first will be the primary billing contact.

adminUsers[].firstName

String

false

The given name to assign to the initial user Identity.

Size must be between 0 and 128 inclusive.

adminUsers[].lastName

String

false

The family name to assign to the initial user Identity.

Size must be between 1 and 128 inclusive.

adminUsers[].email

String

false

The email address to assign to the initial user Identity. This is also the email address when the sign-up invitation will be sent.

Must be a well-formed email address.
Size must be between 6 and 254 inclusive.

adminUsers[].countryCode

String

true

The country name to assign to the hubspot contact.

Must be one of [AF, AX, AL, DZ, AS, AD, AO, AI, AQ, AG, AR, AM, AW, AU, AT, AZ, BS, BH, BD, BB, BY, BE, BZ, BJ, BM, BT, BO, BQ, BA, BW, BV, BR, IO, UM, VG, VI, BN, BG, BF, BI, KH, CM, CA, CV, KY, CF, TD, CL, CN, CX, CC, CO, KM, CG, CD, CK, CR, HR, CU, CW, CY, CZ, DK, DJ, DM, DO, EC, EG, SV, GQ, ER, EE, ET, FK, FO, FJ, FI, FR, GF, PF, TF, GA, GM, GE, DE, GH, GI, GR, GL, GD, GP, GU, GT, GG, GN, GW, GY, HT, HM, VA, HN, HK, HU, IS, IN, ID, CI, IR, IQ, IE, IM, IL, IT, JM, JP, JE, JO, KZ, KE, KI, KW, KG, LA, LV, LB, LS, LR, LY, LI, LT, LU, MO, MK, MG, MW, MY, MV, ML, MT, MH, MQ, MR, MU, YT, MX, FM, MD, MC, MN, ME, MS, MA, MZ, MM, NA, NR, NP, NL, NC, NZ, NI, NE, NG, NU, NF, KP, MP, NO, OM, PK, PW, PS, PA, PG, PY, PE, PH, PN, PL, PT, PR, QA, XK, RE, RO, RU, RW, BL, SH, KN, LC, MF, PM, VC, WS, SM, ST, SA, SN, RS, SC, SL, SG, SX, SK, SI, SB, SO, ZA, GS, KR, SS, ES, LK, SD, SR, SJ, SZ, SE, CH, SY, TW, TJ, TZ, TH, TL, TG, TK, TO, TT, TN, TR, TM, TC, TV, UG, UA, AE, GB, US, UY, UZ, VU, VE, VN, WF, EH, YE, ZM, ZW].

adminUsers[].zip

String

true

The zip code used to retrieve a US based customer’s state.

Size must be between 0 and 32 inclusive.

Response fields

Path Type Optional Description

success

Boolean

true

error

String

true

Must be one of [TenantLabelTaken, InvalidIdentityProviderType, EmailBlocked, BillingError, UnknownServerError].

errorDetail

String

true

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/signup' -i -X POST \
    -H 'Content-Type: application/json' \
    -d '{"organizationName":"Global Gadgets, Inc.-79","organizationLabel":"Global-Gadgets-80","identityProviders":[{"name":"GG Auth2-78","identityProviderTypeId":"91cff470-70d9-4e99-bfd8-3c7920d6a552"},{"name":"GG Auth1-77","identityProviderTypeId":"474342c9-9d52-4da8-ba20-3ad04a9666b1"}],"signupUrl":"https://nfadmin.console.netfoundry.io/signup","billingInfo":{"type":"Trial","customerEmail":"user@email.com","productId":"plan01","type":"Trial"},"adminUsers":[{"firstName":"Sally","lastName":"Cook","email":"sally.cook@globalGadgets.com","countryCode":"US","zip":"14530"}]}'

Example response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 64

{
  "success" : true,
  "error" : null,
  "errorDetail" : null
}

Invitation Flow

Get Invitation By Key

GET /invitations/key/{key:[\p{Alnum}]{36}}

Authorization

Authorization not required for this request.

Path parameters

Parameter Type Optional Description

key

String

false

Query parameters

No parameters.

Request fields

No request body.

Response fields

Path Type Optional Description

fromIdentity

Object

false

fromIdentity.name

String

true

fromIdentity.email

String

false

Size must be between 6 and 254 inclusive.

targetIdentity

Object

true

targetIdentity.name

String

true

targetIdentity.email

String

false

Size must be between 6 and 254 inclusive.

invitedEmailAddress

String

false

Must be a well-formed email address.

toOrganizationName

String

false

toOrganizationLabel

String

false

expiration

Object

false

accepted

Boolean

true

state

String

false

Must be one of [Open, Accepted, Declined, Expired, Revoked].

toTenantName

String

true

Deprecated..

toTenantLabel

String

true

Deprecated..

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/invitations/key/dNcOugAhbTCSiFXv8ohrApi3FzrFdQSNfYTn' -i -X GET

Example response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 517

{
  "fromIdentity" : {
    "name" : "John Doe",
    "email" : "john.doe@acme.com"
  },
  "targetIdentity" : {
    "name" : "First Last",
    "email" : "random-88@acme.com"
  },
  "invitedEmailAddress" : "new.employee-90@acme.com",
  "toOrganizationName" : "ACME International, Inc.",
  "toOrganizationLabel" : "ACME-0",
  "expiration" : {
    "nano" : 504000000,
    "epochSecond" : 1593536913
  },
  "accepted" : null,
  "state" : "Open",
  "toTenantName" : "ACME International, Inc.",
  "toTenantLabel" : "ACME-0"
}

Decline Invitation

PUT /invitations/key/{key:[\p{Alnum}]{36}}/decline

Authorization

Authorization not required for this request.

Path parameters

Parameter Type Optional Description

key

String

false

Query parameters

No parameters.

Request fields

No request body.

Response fields

Path Type Optional Description

fromIdentity

Object

false

fromIdentity.name

String

true

fromIdentity.email

String

false

Size must be between 6 and 254 inclusive.

targetIdentity

Object

true

targetIdentity.name

String

true

targetIdentity.email

String

false

Size must be between 6 and 254 inclusive.

invitedEmailAddress

String

false

Must be a well-formed email address.

toOrganizationName

String

false

toOrganizationLabel

String

false

expiration

Object

false

accepted

Boolean

true

state

String

false

Must be one of [Open, Accepted, Declined, Expired, Revoked].

toTenantName

String

true

Deprecated..

toTenantLabel

String

true

Deprecated..

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/invitations/key/jrHmijVerroL1nT24wuPKPYnBuRUX9YukjB6/decline' -i -X PUT

Example response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 522

{
  "fromIdentity" : {
    "name" : "John Doe",
    "email" : "john.doe@acme.com"
  },
  "targetIdentity" : {
    "name" : "First Last",
    "email" : "random-85@acme.com"
  },
  "invitedEmailAddress" : "new.employee-87@acme.com",
  "toOrganizationName" : "ACME International, Inc.",
  "toOrganizationLabel" : "ACME-0",
  "expiration" : {
    "nano" : 436000000,
    "epochSecond" : 1593536913
  },
  "accepted" : false,
  "state" : "Declined",
  "toTenantName" : "ACME International, Inc.",
  "toTenantLabel" : "ACME-0"
}

Initiate Accept Invitation

POST /invitations/key/{key:[\p{Alnum}]{36}}/accept-initiate

Authorization

Authorization not required for this request.

Path parameters

Parameter Type Optional Description

key

String

false

Query parameters

No parameters.

Request fields

Path Type Optional Description

intermediateReturnUrl

String

false

Response fields

Path Type Optional Description

nfToken

String

false

auth0ConnectionIds

Array[String]

false

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/invitations/key/rw2WQux0UWZd12aoFAdYrVbv80rHyiwS9Y1t/accept-initiate' -i -X POST \
    -H 'Content-Type: application/json' \
    -d '{"intermediateReturnUrl":"http://console.nfadmin.netfoundry.io/invitation"}'

Example response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 981

{
  "nfToken" : "eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdXRoMENvbm5lY3Rpb25JZHMiOlsiYXV0aDAtb3BhcXVlLWNvbm5lY3Rpb25JZC0yIiwiYXV0aDAtb3BhcXVlLWNvbm5lY3Rpb25JZC0xIl0sImF1ZCI6Imh0dHBzOi8vbmV0Zm91bmRyeS1zYW5kYm94LmF1dGgwLmNvbS8iLCJyZWRpcmVjdFVybCI6Imh0dHA6Ly9jb25zb2xlLm5mYWRtaW4ubmV0Zm91bmRyeS5pby9pbnZpdGF0aW9uIiwiaXNzIjoiaHR0cDovL2xvY2FsaG9zdDo4MDgwL2lkZW50aXR5L3YxIiwidGVuYW50TGFiZWwiOiJBQ01FLTAiLCJpbnZpdGF0aW9uSWQiOiJmZDVlYzUxNC1hOGI3LTQ5MjktYTdhZS1hMjdiMjM0ZmNlNDciLCJleHAiOjE1OTI5MzMwMTMsImlhdCI6MTU5MjkzMjExMywiZmxvdyI6Imludml0YXRpb24ifQ.lrrLqFPbfTek3BAf2aFEzK4BEi7yQaJxg5pyx3xLNrrzyZnx-lmzrw5aw9EUTjeGbGJWByMDjRRJHSUmdzhzsukmR0RqBJxsFKJ04C2KF3teWOx6ra2piz994ddXI5ofB26hYmBz7UCBzzTpThYR5koNF8F7lVr-c1gfzrKgdWDZDQ7cnG-hUVSGEwH6wd3RI5VK_v2mnxK-UaR5mmQJCNVQWcGnvh4dE-qbdZMvhEGvGnQeTcaNMvgOuKPPJxFr3wq6Ioefl-NtHS2L7_BGK_nosxFoEwA0mqnmpysp50KBJ_sSju7lXLClHvplzC5ySqjj2-01IyA0gsJ7uHMo5w",
  "auth0ConnectionIds" : [ "auth0-opaque-connectionId-2", "auth0-opaque-connectionId-1" ]
}

Login Flow

Initiate Interactive Authorization

POST /organizations/authorize-initiate

Authorization

Authorization not required for this request.

Path parameters

No parameters.

Query parameters

No parameters.

Request fields

Path Type Optional Description

label

String

false

Must match the regular expression \p{Alnum}|\p{Alnum}[-\p{Alnum}]{0,61}\p{Alnum}.

intermediateReturnUrl

String

false

Response fields

Path Type Optional Description

nfToken

String

false

auth0ConnectionIds

Array[String]

false

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/organizations/authorize-initiate' -i -X POST \
    -H 'Content-Type: application/json' \
    -d '{"label":"ACME-0","intermediateReturnUrl":"http://console.nfadmin.netfoundry.io/invitation"}'

Example response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 902

{
  "nfToken" : "eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdXRoMENvbm5lY3Rpb25JZHMiOlsiYXV0aDAtb3BhcXVlLWNvbm5lY3Rpb25JZC0yIiwiYXV0aDAtb3BhcXVlLWNvbm5lY3Rpb25JZC0xIl0sImF1ZCI6Imh0dHBzOi8vbmV0Zm91bmRyeS1zYW5kYm94LmF1dGgwLmNvbS8iLCJyZWRpcmVjdFVybCI6Imh0dHA6Ly9jb25zb2xlLm5mYWRtaW4ubmV0Zm91bmRyeS5pby9pbnZpdGF0aW9uIiwiaXNzIjoiaHR0cDovL2xvY2FsaG9zdDo4MDgwL2lkZW50aXR5L3YxIiwidGVuYW50TGFiZWwiOiJBQ01FLTAiLCJleHAiOjE1OTI5MzMwMTIsImlhdCI6MTU5MjkzMjExMiwiZmxvdyI6ImxvZ2luIn0.E9SmZIrCDH41OT0eVC1CR4Dwmf2tLjVck4OFix2_Ss6xkjy7M2BZVa7Ic0HezivmF0iFAaxHbfJ5RNurSgNH-uIwd7P0X45gdpaFrOH_C6JMcOzuR3J1DUqIZHgT8_jTwysokcq0Jz325zJVpJ2vurBfJzp2quiL-O-BtbnnlIC24R4VWEpDpdCRhoCxtE2KHr44sXAeY0yFThOSeaEwxI6qhK92woRn7FUeH4cHtbjrYkna951FM-ezITHlw8rcekSy-hketOvil-ZWIklXy3Fpq7sX6Y1P3wgh8qv9wvtbtRy0PHFci_G284qjupSaDyG-tEa9xl4T3cJwvO_fZQ",
  "auth0ConnectionIds" : [ "auth0-opaque-connectionId-2", "auth0-opaque-connectionId-1" ]
}