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

This endpoint requires:

  • read action on this organization resource.

Query parameters

Supports standard paging query parameters.

Parameter Type Optional Description

realmId

Object

true

name

String

true

active

Boolean

true

mfaProviders

Object

true

Must be one of [None, GoogleAuthenticator].

includeDeleted

Boolean

true

Default value: 'false'.

Response fields

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

Path Type Optional Description

id

String

true

realmId

String

true

name

String

true

label

String

true

identityProviders

Array[Object]

true

identityProviders[].id

String

true

identityProviders[].organizationId

String

true

identityProviders[].auth0ConnectionId

String

true

identityProviders[].name

String

true

identityProviders[].auth0ConnectionType

String

true

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

identityProviders[].active

Boolean

true

identityProviders[].createdAt

Object

true

identityProviders[].updatedAt

Object

true

identityProviders[].deletedAt

Object

true

defaultRoles

Array[Object]

true

defaultRoles[].id

String

true

defaultRoles[].organizationId

String

true

defaultRoles[].name

String

true

defaultRoles[].roleType

String

true

Must be one of [Standard, Custom].

defaultRoles[].roleId

String

true

defaultRoles[].createdBy

String

true

defaultRoles[].createdAt

Object

true

defaultRoles[].deletedAt

Object

true

defaultRoles[].deletedBy

String

true

defaultRoles[].deleted

Boolean

true

active

Boolean

true

mfaProvider

String

true

Must be one of [None, GoogleAuthenticator].

createdAt

Object

true

updatedAt

Object

true

deletedBy

String

true

deletedAt

Object

true

deleted

Boolean

true

Example request

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

Example response

HTTP/1.1 200 OK
Link: <https://gateway.netFoundry.io/identity/v1/organizations?page=1>; rel="next", <https://gateway.netFoundry.io/identity/v1/organizations?page=1>; rel="last"
Content-Type: application/json
Content-Length: 3482

[ {
  "id" : "0778bf21-4412-4a1a-b8d4-2470a464e73b",
  "realmId" : "f78825d9-7084-4654-a8ed-d4ff27cba801",
  "name" : "World Wide Imports",
  "label" : "WW-Imports-89",
  "identityProviders" : [ {
    "id" : "21444ed7-b44a-46a8-b7d9-4090598151ee",
    "organizationId" : "0778bf21-4412-4a1a-b8d4-2470a464e73b",
    "auth0ConnectionId" : "auth0-opaque-connectionId-90",
    "name" : "Username/Password",
    "auth0ConnectionType" : "Database",
    "active" : true,
    "createdAt" : {
      "nano" : 10487000,
      "epochSecond" : 1760045350
    },
    "updatedAt" : null,
    "deletedAt" : null
  } ],
  "defaultRoles" : [ {
    "id" : "71d8358c-cffb-4d74-a0cf-54c1141b577e",
    "organizationId" : "0778bf21-4412-4a1a-b8d4-2470a464e73b",
    "name" : "Standard Role - b1c205d6-8025-4a73-8ba8-58318b2414d7",
    "roleType" : "Standard",
    "roleId" : "b1c205d6-8025-4a73-8ba8-58318b2414d7",
    "createdBy" : "3d074e5b-4f7e-41ef-bda9-62119862fcd8",
    "createdAt" : {
      "nano" : 25159000,
      "epochSecond" : 1760045350
    },
    "deletedAt" : null,
    "deletedBy" : null,
    "deleted" : false
  } ],
  "active" : true,
  "mfaProvider" : null,
  "createdAt" : {
    "nano" : 8726000,
    "epochSecond" : 1760045350
  },
  "updatedAt" : null,
  "deletedBy" : null,
  "deletedAt" : null,
  "deleted" : false
}, {
  "id" : "0c9eb71e-af2f-452d-8986-14f45d40e69c",
  "realmId" : "f78825d9-7084-4654-a8ed-d4ff27cba801",
  "name" : "World Wide Imports",
  "label" : "WW-Imports-114",
  "identityProviders" : [ {
    "id" : "688ab02d-59d8-464d-b3b3-818fa9a2e2f6",
    "organizationId" : "0c9eb71e-af2f-452d-8986-14f45d40e69c",
    "auth0ConnectionId" : "auth0-opaque-connectionId-115",
    "name" : "Username/Password",
    "auth0ConnectionType" : "Database",
    "active" : true,
    "createdAt" : {
      "nano" : 372567000,
      "epochSecond" : 1760045351
    },
    "updatedAt" : null,
    "deletedAt" : null
  } ],
  "defaultRoles" : [ ],
  "active" : true,
  "mfaProvider" : null,
  "createdAt" : {
    "nano" : 370598000,
    "epochSecond" : 1760045351
  },
  "updatedAt" : null,
  "deletedBy" : null,
  "deletedAt" : null,
  "deleted" : false
}, {
  "id" : "20e5b9ad-40b8-4206-ad0b-fb2d47f6d0e7",
  "realmId" : "f78825d9-7084-4654-a8ed-d4ff27cba801",
  "name" : "World Wide Imports",
  "label" : "WW-Imports-80",
  "identityProviders" : [ {
    "id" : "b9bf3423-4e48-484f-9b9f-912d85be307d",
    "organizationId" : "20e5b9ad-40b8-4206-ad0b-fb2d47f6d0e7",
    "auth0ConnectionId" : "auth0-opaque-connectionId-81",
    "name" : "Username/Password",
    "auth0ConnectionType" : "Database",
    "active" : true,
    "createdAt" : {
      "nano" : 859199000,
      "epochSecond" : 1760045349
    },
    "updatedAt" : null,
    "deletedAt" : null
  } ],
  "defaultRoles" : [ {
    "id" : "43bb69a7-1137-459d-af1f-9caf13631428",
    "organizationId" : "20e5b9ad-40b8-4206-ad0b-fb2d47f6d0e7",
    "name" : "Standard Role - 68402c93-79ce-4a68-adbf-85c2129ba94b",
    "roleType" : "Standard",
    "roleId" : "68402c93-79ce-4a68-adbf-85c2129ba94b",
    "createdBy" : "bcaaf58c-c1b5-4ebb-b9b9-4c51fec5de89",
    "createdAt" : {
      "nano" : 897384000,
      "epochSecond" : 1760045349
    },
    "deletedAt" : null,
    "deletedBy" : null,
    "deleted" : false
  } ],
  "active" : true,
  "mfaProvider" : null,
  "createdAt" : {
    "nano" : 856691000,
    "epochSecond" : 1760045349
  },
  "updatedAt" : null,
  "deletedBy" : null,
  "deletedAt" : null,
  "deleted" : false
} ]

Get Organization By Self

GET /organizations/self

Authorization

This endpoint requires:

  • read action on this organization resource.

Response fields

No response body.

Example request

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

Example response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 2217

{
  "id" : "74a69a21-ed9c-48cb-8880-4f3284eeb5d7",
  "realmId" : "2b551792-324e-4200-ab38-3d17f27ac13d",
  "name" : "ACME International, Inc.",
  "label" : "ACME-2",
  "identityProviders" : [ {
    "id" : "cb62e527-82a2-4b4c-874e-c2ca3ca550c7",
    "organizationId" : "74a69a21-ed9c-48cb-8880-4f3284eeb5d7",
    "auth0ConnectionId" : "auth0-opaque-connectionId-3",
    "name" : "ACME Federated Active Directory",
    "auth0ConnectionType" : "Enterprise",
    "active" : true,
    "createdAt" : {
      "nano" : 81477000,
      "epochSecond" : 1760045302
    },
    "updatedAt" : null,
    "deletedAt" : null
  }, {
    "id" : "baf0acbc-1766-4357-a996-d31c3f1c603a",
    "organizationId" : "74a69a21-ed9c-48cb-8880-4f3284eeb5d7",
    "auth0ConnectionId" : "auth0-opaque-connectionId-4",
    "name" : "Google-Account",
    "auth0ConnectionType" : "Social",
    "active" : true,
    "createdAt" : {
      "nano" : 96409000,
      "epochSecond" : 1760045302
    },
    "updatedAt" : null,
    "deletedAt" : null
  } ],
  "defaultRoles" : [ {
    "id" : "0576f72e-9f6c-41ec-9186-5669343ca036",
    "organizationId" : "74a69a21-ed9c-48cb-8880-4f3284eeb5d7",
    "name" : "Custom Role - 3457a135-9587-4baf-bbf3-401a1315f802",
    "roleType" : "Custom",
    "roleId" : "3457a135-9587-4baf-bbf3-401a1315f802",
    "createdBy" : "3b6995dc-56e8-4652-a9e2-330919a3631c",
    "createdAt" : {
      "nano" : 215542000,
      "epochSecond" : 1760045302
    },
    "deletedAt" : null,
    "deletedBy" : null,
    "deleted" : false
  }, {
    "id" : "92c9647a-d889-426f-86cc-f8895689dd60",
    "organizationId" : "74a69a21-ed9c-48cb-8880-4f3284eeb5d7",
    "name" : "Standard Role - bf718d89-bf9a-4510-acf9-0f791832c38d",
    "roleType" : "Standard",
    "roleId" : "bf718d89-bf9a-4510-acf9-0f791832c38d",
    "createdBy" : "c0b625a2-0d1d-4c72-9e6a-75974b7f429a",
    "createdAt" : {
      "nano" : 203660000,
      "epochSecond" : 1760045302
    },
    "deletedAt" : null,
    "deletedBy" : null,
    "deleted" : false
  } ],
  "active" : true,
  "mfaProvider" : null,
  "createdAt" : {
    "nano" : 74362000,
    "epochSecond" : 1760045302
  },
  "updatedAt" : null,
  "deletedBy" : 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

This endpoint requires:

  • read action on this organization resource.

Path parameters

Parameter Type Optional Description

id

Object

false

Response fields

Path Type Optional Description

id

String

true

realmId

String

true

name

String

true

label

String

true

identityProviders

Array[Object]

true

identityProviders[].id

String

true

identityProviders[].organizationId

String

true

identityProviders[].auth0ConnectionId

String

true

identityProviders[].name

String

true

identityProviders[].auth0ConnectionType

String

true

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

identityProviders[].active

Boolean

true

identityProviders[].createdAt

Object

true

identityProviders[].updatedAt

Object

true

identityProviders[].deletedAt

Object

true

defaultRoles

Array[Object]

true

defaultRoles[].id

String

true

defaultRoles[].organizationId

String

true

defaultRoles[].name

String

true

defaultRoles[].roleType

String

true

Must be one of [Standard, Custom].

defaultRoles[].roleId

String

true

defaultRoles[].createdBy

String

true

defaultRoles[].createdAt

Object

true

defaultRoles[].deletedAt

Object

true

defaultRoles[].deletedBy

String

true

defaultRoles[].deleted

Boolean

true

active

Boolean

true

mfaProvider

String

true

Must be one of [None, GoogleAuthenticator].

createdAt

Object

true

updatedAt

Object

true

deletedBy

String

true

deletedAt

Object

true

deleted

Boolean

true

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/organizations/74a69a21-ed9c-48cb-8880-4f3284eeb5d7' -i -X GET

Example response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 2217

{
  "id" : "74a69a21-ed9c-48cb-8880-4f3284eeb5d7",
  "realmId" : "2b551792-324e-4200-ab38-3d17f27ac13d",
  "name" : "ACME International, Inc.",
  "label" : "ACME-2",
  "identityProviders" : [ {
    "id" : "cb62e527-82a2-4b4c-874e-c2ca3ca550c7",
    "organizationId" : "74a69a21-ed9c-48cb-8880-4f3284eeb5d7",
    "auth0ConnectionId" : "auth0-opaque-connectionId-3",
    "name" : "ACME Federated Active Directory",
    "auth0ConnectionType" : "Enterprise",
    "active" : true,
    "createdAt" : {
      "nano" : 81477000,
      "epochSecond" : 1760045302
    },
    "updatedAt" : null,
    "deletedAt" : null
  }, {
    "id" : "baf0acbc-1766-4357-a996-d31c3f1c603a",
    "organizationId" : "74a69a21-ed9c-48cb-8880-4f3284eeb5d7",
    "auth0ConnectionId" : "auth0-opaque-connectionId-4",
    "name" : "Google-Account",
    "auth0ConnectionType" : "Social",
    "active" : true,
    "createdAt" : {
      "nano" : 96409000,
      "epochSecond" : 1760045302
    },
    "updatedAt" : null,
    "deletedAt" : null
  } ],
  "defaultRoles" : [ {
    "id" : "0576f72e-9f6c-41ec-9186-5669343ca036",
    "organizationId" : "74a69a21-ed9c-48cb-8880-4f3284eeb5d7",
    "name" : "Custom Role - 3457a135-9587-4baf-bbf3-401a1315f802",
    "roleType" : "Custom",
    "roleId" : "3457a135-9587-4baf-bbf3-401a1315f802",
    "createdBy" : "3b6995dc-56e8-4652-a9e2-330919a3631c",
    "createdAt" : {
      "nano" : 215542000,
      "epochSecond" : 1760045302
    },
    "deletedAt" : null,
    "deletedBy" : null,
    "deleted" : false
  }, {
    "id" : "92c9647a-d889-426f-86cc-f8895689dd60",
    "organizationId" : "74a69a21-ed9c-48cb-8880-4f3284eeb5d7",
    "name" : "Standard Role - bf718d89-bf9a-4510-acf9-0f791832c38d",
    "roleType" : "Standard",
    "roleId" : "bf718d89-bf9a-4510-acf9-0f791832c38d",
    "createdBy" : "c0b625a2-0d1d-4c72-9e6a-75974b7f429a",
    "createdAt" : {
      "nano" : 203660000,
      "epochSecond" : 1760045302
    },
    "deletedAt" : null,
    "deletedBy" : null,
    "deleted" : false
  } ],
  "active" : true,
  "mfaProvider" : null,
  "createdAt" : {
    "nano" : 74362000,
    "epochSecond" : 1760045302
  },
  "updatedAt" : null,
  "deletedBy" : null,
  "deletedAt" : null,
  "deleted" : false
}

Get Organization By Label

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

Authorization

This endpoint requires:

  • read action on this organization resource.

Path parameters

Parameter Type Optional Description

label

String

false

Query parameters

Parameter Type Optional Description

realm

String

true

Response fields

Path Type Optional Description

id

String

true

realmId

String

true

name

String

true

label

String

true

active

Boolean

true

identityProviders

Array[Object]

true

identityProviders[].id

String

true

identityProviders[].organizationId

String

true

identityProviders[].auth0ConnectionId

String

true

identityProviders[].name

String

true

identityProviders[].auth0ConnectionType

String

true

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

identityProviders[].active

Boolean

true

identityProviders[].createdAt

Object

true

identityProviders[].updatedAt

Object

true

identityProviders[].deletedAt

Object

true

mfaProvider

String

true

Must be one of [None, GoogleAuthenticator].

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/organizations/label/ACME-2' -i -X GET

Example response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 1058

{
  "id" : "74a69a21-ed9c-48cb-8880-4f3284eeb5d7",
  "realmId" : "2b551792-324e-4200-ab38-3d17f27ac13d",
  "name" : "ACME International, Inc.",
  "label" : "ACME-2",
  "active" : true,
  "identityProviders" : [ {
    "id" : "cb62e527-82a2-4b4c-874e-c2ca3ca550c7",
    "organizationId" : "74a69a21-ed9c-48cb-8880-4f3284eeb5d7",
    "auth0ConnectionId" : "auth0-opaque-connectionId-3",
    "name" : "ACME Federated Active Directory",
    "auth0ConnectionType" : "Enterprise",
    "active" : true,
    "createdAt" : {
      "nano" : 81477000,
      "epochSecond" : 1760045302
    },
    "updatedAt" : null,
    "deletedAt" : null
  }, {
    "id" : "baf0acbc-1766-4357-a996-d31c3f1c603a",
    "organizationId" : "74a69a21-ed9c-48cb-8880-4f3284eeb5d7",
    "auth0ConnectionId" : "auth0-opaque-connectionId-4",
    "name" : "Google-Account",
    "auth0ConnectionType" : "Social",
    "active" : true,
    "createdAt" : {
      "nano" : 96409000,
      "epochSecond" : 1760045302
    },
    "updatedAt" : null,
    "deletedAt" : null
  } ],
  "mfaProvider" : null
}

Create Organization

POST /organizations

Authorization

This endpoint requires:

  • create action on this organization resource.

Request fields

Path Type Optional Description

realmId

String

true

name

String

true

label

String

true

auth0ConnectionId

String

true

identityProviderName

String

true

auth0ConnectionType

String

true

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

Response fields

Path Type Optional Description

id

String

true

realmId

String

true

name

String

true

label

String

true

identityProviders

Array[Object]

true

identityProviders[].id

String

true

identityProviders[].organizationId

String

true

identityProviders[].auth0ConnectionId

String

true

identityProviders[].name

String

true

identityProviders[].auth0ConnectionType

String

true

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

identityProviders[].active

Boolean

true

identityProviders[].createdAt

Object

true

identityProviders[].updatedAt

Object

true

identityProviders[].deletedAt

Object

true

defaultRoles

Array[Object]

true

defaultRoles[].id

String

true

defaultRoles[].organizationId

String

true

defaultRoles[].name

String

true

defaultRoles[].roleType

String

true

Must be one of [Standard, Custom].

defaultRoles[].roleId

String

true

defaultRoles[].createdBy

String

true

defaultRoles[].createdAt

Object

true

defaultRoles[].deletedAt

Object

true

defaultRoles[].deletedBy

String

true

defaultRoles[].deleted

Boolean

true

active

Boolean

true

mfaProvider

String

true

Must be one of [None, GoogleAuthenticator].

createdAt

Object

true

updatedAt

Object

true

deletedBy

String

true

deletedAt

Object

true

deleted

Boolean

true

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/organizations' -i -X POST \
    -H 'Content-Type: application/json' \
    -d '{
  "realmId" : "7034efb9-ea92-440f-8ce3-432193c064a9",
  "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
Content-Length: 812

{
  "id" : "6544f031-5afc-4359-9f8d-02591c61a79e",
  "realmId" : "7034efb9-ea92-440f-8ce3-432193c064a9",
  "name" : "Best Corp.",
  "label" : "BEST-CORP",
  "identityProviders" : [ {
    "id" : "f09efd67-282d-4469-8df0-5884c3e5ee1f",
    "organizationId" : "6544f031-5afc-4359-9f8d-02591c61a79e",
    "auth0ConnectionId" : "auth0-opaque-connection",
    "name" : "Best Corp.",
    "auth0ConnectionType" : "Enterprise",
    "active" : true,
    "createdAt" : {
      "nano" : 108038000,
      "epochSecond" : 1760045359
    },
    "updatedAt" : null,
    "deletedAt" : null
  } ],
  "defaultRoles" : [ ],
  "active" : true,
  "mfaProvider" : null,
  "createdAt" : {
    "nano" : 105826000,
    "epochSecond" : 1760045359
  },
  "updatedAt" : null,
  "deletedBy" : null,
  "deletedAt" : null,
  "deleted" : false
}

Activate Or Deactivate Organization

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

Authorization

This endpoint requires:

  • update-active action on this organization resource.

Path parameters

Parameter Type Optional Description

id

Object

false

action

String

false

Response fields

Path Type Optional Description

id

String

true

realmId

String

true

name

String

true

label

String

true

identityProviders

Array[Object]

true

identityProviders[].id

String

true

identityProviders[].organizationId

String

true

identityProviders[].auth0ConnectionId

String

true

identityProviders[].name

String

true

identityProviders[].auth0ConnectionType

String

true

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

identityProviders[].active

Boolean

true

identityProviders[].createdAt

Object

true

identityProviders[].updatedAt

Object

true

identityProviders[].deletedAt

Object

true

defaultRoles

Array[Object]

true

defaultRoles[].id

String

true

defaultRoles[].organizationId

String

true

defaultRoles[].name

String

true

defaultRoles[].roleType

String

true

Must be one of [Standard, Custom].

defaultRoles[].roleId

String

true

defaultRoles[].createdBy

String

true

defaultRoles[].createdAt

Object

true

defaultRoles[].deletedAt

Object

true

defaultRoles[].deletedBy

String

true

defaultRoles[].deleted

Boolean

true

active

Boolean

true

mfaProvider

String

true

Must be one of [None, GoogleAuthenticator].

createdAt

Object

true

updatedAt

Object

true

deletedBy

String

true

deletedAt

Object

true

deleted

Boolean

true

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/organizations/d699e8f0-c187-472b-bfd3-aa307c7a34cd/deactivate' -i -X PUT

Example response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 893

{
  "id" : "d699e8f0-c187-472b-bfd3-aa307c7a34cd",
  "realmId" : "f78825d9-7084-4654-a8ed-d4ff27cba801",
  "name" : "World Wide Imports",
  "label" : "WW-Imports-275",
  "identityProviders" : [ {
    "id" : "89764bb1-a24f-46f5-9678-bc46259ba37a",
    "organizationId" : "d699e8f0-c187-472b-bfd3-aa307c7a34cd",
    "auth0ConnectionId" : "auth0-opaque-connectionId-276",
    "name" : "Username/Password",
    "auth0ConnectionType" : "Database",
    "active" : true,
    "createdAt" : {
      "nano" : 395084000,
      "epochSecond" : 1760045360
    },
    "updatedAt" : null,
    "deletedAt" : null
  } ],
  "defaultRoles" : [ ],
  "active" : false,
  "mfaProvider" : null,
  "createdAt" : {
    "nano" : 393435000,
    "epochSecond" : 1760045360
  },
  "updatedAt" : {
    "nano" : 444662000,
    "epochSecond" : 1760045360
  },
  "deletedBy" : null,
  "deletedAt" : null,
  "deleted" : false
}

Add Identity Provider

POST /organizations/{id}/identity-providers

Authorization

This endpoint requires:

  • create-identity-provider action on this organization resource.

Path parameters

Parameter Type Optional Description

id

Object

false

Request fields

Path Type Optional Description

auth0ConnectionId

String

true

identityProviderName

String

true

auth0ConnectionType

String

true

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

Response fields

Path Type Optional Description

id

String

true

realmId

String

true

name

String

true

label

String

true

identityProviders

Array[Object]

true

identityProviders[].id

String

true

identityProviders[].organizationId

String

true

identityProviders[].auth0ConnectionId

String

true

identityProviders[].name

String

true

identityProviders[].auth0ConnectionType

String

true

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

identityProviders[].active

Boolean

true

identityProviders[].createdAt

Object

true

identityProviders[].updatedAt

Object

true

identityProviders[].deletedAt

Object

true

defaultRoles

Array[Object]

true

defaultRoles[].id

String

true

defaultRoles[].organizationId

String

true

defaultRoles[].name

String

true

defaultRoles[].roleType

String

true

Must be one of [Standard, Custom].

defaultRoles[].roleId

String

true

defaultRoles[].createdBy

String

true

defaultRoles[].createdAt

Object

true

defaultRoles[].deletedAt

Object

true

defaultRoles[].deletedBy

String

true

defaultRoles[].deleted

Boolean

true

active

Boolean

true

mfaProvider

String

true

Must be one of [None, GoogleAuthenticator].

createdAt

Object

true

updatedAt

Object

true

deletedBy

String

true

deletedAt

Object

true

deleted

Boolean

true

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/organizations/b5238050-63f8-46bb-935f-07b82a361121/identity-providers' -i -X POST \
    -H 'Content-Type: application/json' \
    -d '{
  "auth0ConnectionId" : "auth0-opaque-connection",
  "identityProviderName" : "Corp SAML",
  "auth0ConnectionType" : "Enterprise"
}'

Example response

HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 1230

{
  "id" : "b5238050-63f8-46bb-935f-07b82a361121",
  "realmId" : "f78825d9-7084-4654-a8ed-d4ff27cba801",
  "name" : "World Wide Imports",
  "label" : "WW-Imports-271",
  "identityProviders" : [ {
    "id" : "6a4268a8-f116-48cf-92c8-3e85d1092441",
    "organizationId" : "b5238050-63f8-46bb-935f-07b82a361121",
    "auth0ConnectionId" : "auth0-opaque-connection",
    "name" : "Corp SAML",
    "auth0ConnectionType" : "Enterprise",
    "active" : true,
    "createdAt" : {
      "nano" : 119437000,
      "epochSecond" : 1760045360
    },
    "updatedAt" : null,
    "deletedAt" : null
  }, {
    "id" : "a61cf88b-448f-4bb9-9932-0e1f76ebe2d2",
    "organizationId" : "b5238050-63f8-46bb-935f-07b82a361121",
    "auth0ConnectionId" : "auth0-opaque-connectionId-272",
    "name" : "Username/Password",
    "auth0ConnectionType" : "Database",
    "active" : true,
    "createdAt" : {
      "nano" : 91583000,
      "epochSecond" : 1760045360
    },
    "updatedAt" : null,
    "deletedAt" : null
  } ],
  "defaultRoles" : [ ],
  "active" : true,
  "mfaProvider" : null,
  "createdAt" : {
    "nano" : 89796000,
    "epochSecond" : 1760045360
  },
  "updatedAt" : null,
  "deletedBy" : null,
  "deletedAt" : null,
  "deleted" : false
}

OIDC Issuers

Find Oidc Issuers

GET /oidc-issuers

Authorization

This endpoint requires:

  • read action on this oidc-issuer resource.

Response fields

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

Path Type Optional Description

id

String

true

issuer

String

true

jwksUri

String

true

active

Boolean

true

createdBy

String

true

createdAt

Object

true

deletedAt

Object

true

deletedBy

String

true

deleted

Boolean

true

Example request

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

Example response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 1265

[ {
  "id" : "32c94d20-e439-4fce-b731-656d75a07d7a",
  "issuer" : "https://da912c3d-6caf-4bd9-9742-82a2ec66e470.issuer.idp",
  "jwksUri" : "https://da912c3d-6caf-4bd9-9742-82a2ec66e470.issuer.idp/jwks",
  "active" : true,
  "createdBy" : "a5424d2b-427d-4032-a6f8-d7d274ba62cc",
  "createdAt" : {
    "nano" : 378109000,
    "epochSecond" : 1760045357
  },
  "deletedAt" : null,
  "deletedBy" : null,
  "deleted" : false
}, {
  "id" : "53bc750a-5ad5-4f0f-8f70-69045d4ec2e4",
  "issuer" : "https://dba50ca8-37a7-4bed-a589-b49de9769d5b.issuer.idp",
  "jwksUri" : "https://dba50ca8-37a7-4bed-a589-b49de9769d5b.issuer.idp/jwks",
  "active" : true,
  "createdBy" : "158597fb-8001-4165-93f9-86cf164a6825",
  "createdAt" : {
    "nano" : 131941000,
    "epochSecond" : 1760045357
  },
  "deletedAt" : null,
  "deletedBy" : null,
  "deleted" : false
}, {
  "id" : "67e7dcbd-069b-48b9-b131-ef230da13c96",
  "issuer" : "https://60354098-bebe-4cff-944f-2a73c1fc7a99.issuer.idp",
  "jwksUri" : "https://60354098-bebe-4cff-944f-2a73c1fc7a99.issuer.idp/jwks",
  "active" : true,
  "createdBy" : "4ded0fe1-7120-4f9b-8abb-ab7750dabf2f",
  "createdAt" : {
    "nano" : 899181000,
    "epochSecond" : 1760045356
  },
  "deletedAt" : null,
  "deletedBy" : null,
  "deleted" : false
} ]

Get Oidc Issuer

GET /oidc-issuers/{id}

Authorization

This endpoint requires:

  • read action on this oidc-issuer resource.

Path parameters

Parameter Type Optional Description

id

Object

false

Response fields

Path Type Optional Description

id

String

true

issuer

String

true

jwksUri

String

true

active

Boolean

true

createdBy

String

true

createdAt

Object

true

deletedAt

Object

true

deletedBy

String

true

deleted

Boolean

true

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/oidc-issuers/78bb404c-9365-430f-828a-c8aeea0328eb' -i -X GET

Example response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 419

{
  "id" : "78bb404c-9365-430f-828a-c8aeea0328eb",
  "issuer" : "https://51bc3831-ccdc-47c7-8c44-c1ec2aa58829.issuer.idp",
  "jwksUri" : "https://51bc3831-ccdc-47c7-8c44-c1ec2aa58829.issuer.idp/jwks",
  "active" : true,
  "createdBy" : "ab7278ea-6bef-44ce-8533-2644fb363515",
  "createdAt" : {
    "nano" : 995697000,
    "epochSecond" : 1760045357
  },
  "deletedAt" : null,
  "deletedBy" : null,
  "deleted" : false
}

Create Oidc Issuer

POST /oidc-issuers

Authorization

This endpoint requires:

  • create action on this oidc-issuer resource.

Request fields

Path Type Optional Description

issuer

String

true

jwksUri

String

true

active

Boolean

true

Response fields

Path Type Optional Description

id

String

true

issuer

String

true

jwksUri

String

true

active

Boolean

true

createdBy

String

true

createdAt

Object

true

deletedAt

Object

true

deletedBy

String

true

deleted

Boolean

true

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/oidc-issuers' -i -X POST \
    -H 'Content-Type: application/json' \
    -d '{
  "issuer" : "https://237fe432-8321-4ce7-a9c9-ca18cfeb63b9.issuer.idp",
  "jwksUri" : "https://237fe432-8321-4ce7-a9c9-ca18cfeb63b9.issuer.idp/jwks",
  "active" : true
}'

Example response

HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 419

{
  "id" : "30ce42b5-6f34-478f-91ad-629eef8011a5",
  "issuer" : "https://237fe432-8321-4ce7-a9c9-ca18cfeb63b9.issuer.idp",
  "jwksUri" : "https://237fe432-8321-4ce7-a9c9-ca18cfeb63b9.issuer.idp/jwks",
  "active" : true,
  "createdBy" : "23559d79-b3d4-41d5-bd74-932e89f84974",
  "createdAt" : {
    "nano" : 940169000,
    "epochSecond" : 1760045357
  },
  "deletedAt" : null,
  "deletedBy" : null,
  "deleted" : false
}

Update Oidc Issuer

PATCH /oidc-issuers/{id}

Authorization

This endpoint requires:

  • update action on this oidc-issuer resource.

Path parameters

Parameter Type Optional Description

id

Object

false

Request fields

Path Type Optional Description

issuer

String

true

jwksUri

String

true

active

Boolean

true

Response fields

Path Type Optional Description

id

String

true

issuer

String

true

jwksUri

String

true

active

Boolean

true

createdBy

String

true

createdAt

Object

true

deletedAt

Object

true

deletedBy

String

true

deleted

Boolean

true

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/oidc-issuers/26038713-71d2-4f0f-a055-16357b65073b' -i -X PATCH \
    -H 'Content-Type: application/json' \
    -d '{
  "issuer" : "https://631d38a6-bba7-4f0c-b086-230df8da237a.issuer.idp",
  "jwksUri" : "https://631d38a6-bba7-4f0c-b086-230df8da237a.issuer.idp/jwks",
  "active" : false
}'

Example response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 420

{
  "id" : "26038713-71d2-4f0f-a055-16357b65073b",
  "issuer" : "https://631d38a6-bba7-4f0c-b086-230df8da237a.issuer.idp",
  "jwksUri" : "https://631d38a6-bba7-4f0c-b086-230df8da237a.issuer.idp/jwks",
  "active" : false,
  "createdBy" : "fce0502e-7bfc-413b-8ee7-b6dcbdb40b84",
  "createdAt" : {
    "nano" : 862772000,
    "epochSecond" : 1760045357
  },
  "deletedAt" : null,
  "deletedBy" : null,
  "deleted" : false
}

Delete Oidc Issuer

DELETE /oidc-issuers/{id}

Authorization

This endpoint requires:

  • delete action on this oidc-issuer resource.

Path parameters

Parameter Type Optional Description

id

Object

false

Response fields

Path Type Optional Description

id

String

true

issuer

String

true

jwksUri

String

true

active

Boolean

true

createdBy

String

true

createdAt

Object

true

deletedAt

Object

true

deletedBy

String

true

deleted

Boolean

true

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/oidc-issuers/d0a1e43d-92ac-430f-be33-e571236dfb68' -i -X DELETE

Example response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 506

{
  "id" : "d0a1e43d-92ac-430f-be33-e571236dfb68",
  "issuer" : "https://4eb2b4e1-975d-4157-b3cf-22cc50a0ab03.issuer.idp",
  "jwksUri" : "https://4eb2b4e1-975d-4157-b3cf-22cc50a0ab03.issuer.idp/jwks",
  "active" : true,
  "createdBy" : "d535c100-8887-49f2-9a2e-1c6ff03f3b7a",
  "createdAt" : {
    "nano" : 60296000,
    "epochSecond" : 1760045358
  },
  "deletedAt" : {
    "nano" : 72967000,
    "epochSecond" : 1760045358
  },
  "deletedBy" : "ac0a61d8-12a2-4540-9edb-cc3a758f5665",
  "deleted" : true
}

OIDC Public Clients

Find Oidc Public Clients

GET /oidc-public-clients

Authorization

This endpoint requires:

  • read action on this oidc-public-client resource.

Response fields

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

Path Type Optional Description

id

String

true

oidcIssuerId

String

true

clientId

String

true

clientSecret

String

true

authorizationEndpoint

String

true

tokenEndpoint

String

true

userInfoEndpoint

String

true

restrictedToOrganizationIds

Array[Object]

true

active

Boolean

true

createdBy

String

true

createdAt

Object

true

deletedAt

Object

true

deletedBy

String

true

deleted

Boolean

true

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/oidc-public-clients' -i -X GET

Example response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 2070

[ {
  "id" : "290cc71d-cbd0-4c44-bf9e-a9d33a7314e6",
  "oidcIssuerId" : "fc221f2c-e97f-4994-a29e-afc26395f6b6",
  "clientId" : "{clientId}",
  "clientSecret" : "{clientSecret}",
  "authorizationEndpoint" : "https://{auth0-tenant}.auth0.com/authorize",
  "tokenEndpoint" : "https://{auth0-tenant}.auth0.com/oauth/token",
  "userInfoEndpoint" : "https://{auth0-tenant}.auth0.com/userinfo",
  "restrictedToOrganizationIds" : [ ],
  "active" : true,
  "createdBy" : "2b6f496d-36f1-4e66-a205-8abcf1d41d74",
  "createdAt" : {
    "nano" : 996673000,
    "epochSecond" : 1760045297
  },
  "deletedAt" : null,
  "deletedBy" : null,
  "deleted" : false
}, {
  "id" : "79c1c317-50d0-420c-a066-451b147f5d72",
  "oidcIssuerId" : "cf29e05e-0368-4780-811c-16ce11c30ced",
  "clientId" : "clientId-2489ee00-4f08-4bc5-bc8f-a008dd8227d4",
  "clientSecret" : "clientSecret-0b24b637-7235-4f97-8a31-8562abd96c96",
  "authorizationEndpoint" : "https://925e6585-327b-4b7c-8456-e11adae4221f.issuer.idp/authorize",
  "tokenEndpoint" : "https://925e6585-327b-4b7c-8456-e11adae4221f.issuer.idp/token",
  "userInfoEndpoint" : "https://925e6585-327b-4b7c-8456-e11adae4221f.issuer.idp/userinfo",
  "restrictedToOrganizationIds" : [ ],
  "active" : true,
  "createdBy" : "754de15d-0193-4117-ac26-e287855774d9",
  "createdAt" : {
    "nano" : 197934000,
    "epochSecond" : 1760045358
  },
  "deletedAt" : null,
  "deletedBy" : null,
  "deleted" : false
}, {
  "id" : "f4e6fcd0-1839-4566-8828-856e42b8f156",
  "oidcIssuerId" : "6c72dba0-a155-4804-9a70-89da12149793",
  "clientId" : "{clientId}",
  "clientSecret" : "{clientSecret}",
  "authorizationEndpoint" : "https://accounts.google.com/o/oauth2/v2/auth",
  "tokenEndpoint" : "https://oauth2.googleapis.com/token",
  "userInfoEndpoint" : "https://openidconnect.googleapis.com/v1/userinfo",
  "restrictedToOrganizationIds" : [ ],
  "active" : true,
  "createdBy" : "2b6f496d-36f1-4e66-a205-8abcf1d41d74",
  "createdAt" : {
    "nano" : 996673000,
    "epochSecond" : 1760045297
  },
  "deletedAt" : null,
  "deletedBy" : null,
  "deleted" : false
} ]

Get Oidc Public Client

GET /oidc-public-clients/{id}

Authorization

This endpoint requires:

  • read action on this oidc-public-client resource.

Path parameters

Parameter Type Optional Description

id

Object

false

Response fields

Path Type Optional Description

id

String

true

oidcIssuerId

String

true

clientId

String

true

clientSecret

String

true

authorizationEndpoint

String

true

tokenEndpoint

String

true

userInfoEndpoint

String

true

restrictedToOrganizationIds

Array[Object]

true

active

Boolean

true

createdBy

String

true

createdAt

Object

true

deletedAt

Object

true

deletedBy

String

true

deleted

Boolean

true

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/oidc-public-clients/5fd0c906-dcd2-4316-8208-3d84ffd248c6' -i -X GET

Example response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 776

{
  "id" : "5fd0c906-dcd2-4316-8208-3d84ffd248c6",
  "oidcIssuerId" : "c22b0d5f-88d0-4f01-8404-e6c62cc731da",
  "clientId" : "clientId-ba73edf4-6571-41c6-9dd6-328010427549",
  "clientSecret" : "clientSecret-7f46daed-dcf9-4461-ac8c-8c57c3afe13f",
  "authorizationEndpoint" : "https://8f5b4d9c-f52a-4617-91fe-50d9437fe60c.issuer.idp/authorize",
  "tokenEndpoint" : "https://8f5b4d9c-f52a-4617-91fe-50d9437fe60c.issuer.idp/token",
  "userInfoEndpoint" : "https://8f5b4d9c-f52a-4617-91fe-50d9437fe60c.issuer.idp/userinfo",
  "restrictedToOrganizationIds" : [ ],
  "active" : true,
  "createdBy" : "9ecd7af1-7c38-48d7-9370-57005d2c129a",
  "createdAt" : {
    "nano" : 735720000,
    "epochSecond" : 1760045358
  },
  "deletedAt" : null,
  "deletedBy" : null,
  "deleted" : false
}

Create Oidc Public Client

POST /oidc-public-clients

Authorization

This endpoint requires:

  • create action on this oidc-public-client resource.

Request fields

Path Type Optional Description

oidcIssuerId

String

true

clientId

String

true

clientSecret

String

true

authorizationEndpoint

String

true

tokenEndpoint

String

true

userInfoEndpoint

String

true

restrictedToOrganizationIds

Array[Object]

true

active

Boolean

true

Response fields

Path Type Optional Description

id

String

true

oidcIssuerId

String

true

clientId

String

true

clientSecret

String

true

authorizationEndpoint

String

true

tokenEndpoint

String

true

userInfoEndpoint

String

true

restrictedToOrganizationIds

Array[Object]

true

active

Boolean

true

createdBy

String

true

createdAt

Object

true

deletedAt

Object

true

deletedBy

String

true

deleted

Boolean

true

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/oidc-public-clients' -i -X POST \
    -H 'Content-Type: application/json' \
    -d '{
  "oidcIssuerId" : "ba1d9040-6908-4976-8361-203b66a868a8",
  "clientId" : "clientId-037cc59a-2352-43b6-b45a-54a3d8a12733",
  "clientSecret" : "clientSecret-6db4028d-7a07-48a8-b63a-604b2b4fede6",
  "authorizationEndpoint" : "https://1e9c0eef-1b25-42d2-a7e4-5c5eaadbd6e0.issuer.idp/authorize",
  "tokenEndpoint" : "https://1e9c0eef-1b25-42d2-a7e4-5c5eaadbd6e0.issuer.idp/token",
  "userInfoEndpoint" : "https://1e9c0eef-1b25-42d2-a7e4-5c5eaadbd6e0.issuer.idp/userinfo",
  "restrictedToOrganizationIds" : [ ],
  "active" : true
}'

Example response

HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 776

{
  "id" : "43b32ae2-1855-4c8c-b8d5-62d5670eb1e9",
  "oidcIssuerId" : "ba1d9040-6908-4976-8361-203b66a868a8",
  "clientId" : "clientId-037cc59a-2352-43b6-b45a-54a3d8a12733",
  "clientSecret" : "clientSecret-6db4028d-7a07-48a8-b63a-604b2b4fede6",
  "authorizationEndpoint" : "https://1e9c0eef-1b25-42d2-a7e4-5c5eaadbd6e0.issuer.idp/authorize",
  "tokenEndpoint" : "https://1e9c0eef-1b25-42d2-a7e4-5c5eaadbd6e0.issuer.idp/token",
  "userInfoEndpoint" : "https://1e9c0eef-1b25-42d2-a7e4-5c5eaadbd6e0.issuer.idp/userinfo",
  "restrictedToOrganizationIds" : [ ],
  "active" : true,
  "createdBy" : "d7c263f8-33e2-4ccc-b65f-b9711619e3e7",
  "createdAt" : {
    "nano" : 684787000,
    "epochSecond" : 1760045358
  },
  "deletedAt" : null,
  "deletedBy" : null,
  "deleted" : false
}

Update Oidc Public Client

PATCH /oidc-public-clients/{id}

Authorization

This endpoint requires:

  • update action on this oidc-public-client resource.

Path parameters

Parameter Type Optional Description

id

Object

false

Request fields

Path Type Optional Description

clientId

String

true

clientSecret

String

true

authorizationEndpoint

String

true

tokenEndpoint

String

true

userInfoEndpoint

String

true

restrictedToOrganizationIds

Array[Object]

true

active

Boolean

true

Response fields

Path Type Optional Description

id

String

true

oidcIssuerId

String

true

clientId

String

true

clientSecret

String

true

authorizationEndpoint

String

true

tokenEndpoint

String

true

userInfoEndpoint

String

true

restrictedToOrganizationIds

Array[Object]

true

active

Boolean

true

createdBy

String

true

createdAt

Object

true

deletedAt

Object

true

deletedBy

String

true

deleted

Boolean

true

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/oidc-public-clients/e5c238ac-0303-4415-8652-776004727ac3' -i -X PATCH \
    -H 'Content-Type: application/json' \
    -d '{
  "clientId" : "clientId-ed5bbb65-ce89-4106-bd1a-44699e270141",
  "clientSecret" : "clientSecret-122a09ec-e40c-4b58-8d53-c37af8d7fc5c",
  "authorizationEndpoint" : "https://e1eee767-ee06-4f33-bac8-a39ce10b225a.issuer.idp/authorize",
  "tokenEndpoint" : "https://e1eee767-ee06-4f33-bac8-a39ce10b225a.issuer.idp/token",
  "userInfoEndpoint" : "https://e1eee767-ee06-4f33-bac8-a39ce10b225a.issuer.idp/userinfo",
  "restrictedToOrganizationIds" : [ ],
  "active" : false
}'

Example response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 777

{
  "id" : "e5c238ac-0303-4415-8652-776004727ac3",
  "oidcIssuerId" : "7d765c5e-5220-4cc1-870f-ee7b4c521934",
  "clientId" : "clientId-ed5bbb65-ce89-4106-bd1a-44699e270141",
  "clientSecret" : "clientSecret-122a09ec-e40c-4b58-8d53-c37af8d7fc5c",
  "authorizationEndpoint" : "https://e1eee767-ee06-4f33-bac8-a39ce10b225a.issuer.idp/authorize",
  "tokenEndpoint" : "https://e1eee767-ee06-4f33-bac8-a39ce10b225a.issuer.idp/token",
  "userInfoEndpoint" : "https://e1eee767-ee06-4f33-bac8-a39ce10b225a.issuer.idp/userinfo",
  "restrictedToOrganizationIds" : [ ],
  "active" : false,
  "createdBy" : "1b0d08a1-4831-466d-a53d-ecbe75db7e70",
  "createdAt" : {
    "nano" : 562269000,
    "epochSecond" : 1760045358
  },
  "deletedAt" : null,
  "deletedBy" : null,
  "deleted" : false
}

Delete Oidc Public Client

DELETE /oidc-public-clients/{id}

Authorization

This endpoint requires:

  • delete action on this oidc-public-client resource.

Path parameters

Parameter Type Optional Description

id

Object

false

Response fields

Path Type Optional Description

id

String

true

oidcIssuerId

String

true

clientId

String

true

clientSecret

String

true

authorizationEndpoint

String

true

tokenEndpoint

String

true

userInfoEndpoint

String

true

restrictedToOrganizationIds

Array[Object]

true

active

Boolean

true

createdBy

String

true

createdAt

Object

true

deletedAt

Object

true

deletedBy

String

true

deleted

Boolean

true

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/oidc-public-clients/226f2567-02c2-4d0a-b1a9-b8479a230df9' -i -X DELETE

Example response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 865

{
  "id" : "226f2567-02c2-4d0a-b1a9-b8479a230df9",
  "oidcIssuerId" : "992ef1ee-1110-44c6-86cf-4a48e659f5fa",
  "clientId" : "clientId-39987f18-56e0-4a59-abbb-8f5e7f946b20",
  "clientSecret" : "clientSecret-2ac946aa-8b2c-4e9a-a7de-ef44aaa6b98e",
  "authorizationEndpoint" : "https://0a552e17-282b-49e7-9bcc-1b5192546553.issuer.idp/authorize",
  "tokenEndpoint" : "https://0a552e17-282b-49e7-9bcc-1b5192546553.issuer.idp/token",
  "userInfoEndpoint" : "https://0a552e17-282b-49e7-9bcc-1b5192546553.issuer.idp/userinfo",
  "restrictedToOrganizationIds" : [ ],
  "active" : true,
  "createdBy" : "ad5906c0-42b4-4774-9781-dcf5cbfab4af",
  "createdAt" : {
    "nano" : 790782000,
    "epochSecond" : 1760045358
  },
  "deletedAt" : {
    "nano" : 802154000,
    "epochSecond" : 1760045358
  },
  "deletedBy" : "e858f138-8cd7-4511-bf70-8e9e35dcc1b6",
  "deleted" : true
}

Organization to OIDC Public Client Mappings

Find Organization Oidc Public Client Mappings

GET /organization-oidc-public-client-mappings

Authorization

This endpoint requires:

  • read action on this organization-oidc-public-client-mapping resource.

Response fields

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

Path Type Optional Description

id

String

true

organizationId

String

true

oidcPublicClientId

String

true

name

String

true

active

Boolean

true

customQueryParameters

String

true

createdBy

String

true

createdAt

Object

true

deletedAt

Object

true

deletedBy

String

true

deleted

Boolean

true

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/organization-oidc-public-client-mappings' -i -X GET

Example response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 1499

[ {
  "id" : "04f34ed1-314d-4cc4-aa13-edf55ac1edee",
  "organizationId" : "74a69a21-ed9c-48cb-8880-4f3284eeb5d7",
  "oidcPublicClientId" : "f4e6fcd0-1839-4566-8828-856e42b8f156",
  "name" : "Google-Account",
  "active" : true,
  "customQueryParameters" : "{}",
  "createdBy" : "d1600c5e-6d3f-4102-8b58-c7afb2a8898d",
  "createdAt" : {
    "nano" : 197678000,
    "epochSecond" : 1760045302
  },
  "deletedAt" : null,
  "deletedBy" : null,
  "deleted" : false
}, {
  "id" : "18ba0d73-e2e0-4394-a498-52d6687272e9",
  "organizationId" : "74a69a21-ed9c-48cb-8880-4f3284eeb5d7",
  "oidcPublicClientId" : "290cc71d-cbd0-4c44-bf9e-a9d33a7314e6",
  "name" : "ACME Federated Active Directory",
  "active" : true,
  "customQueryParameters" : "{}",
  "createdBy" : "fa45d03d-a2ea-4014-8059-38490df89f32",
  "createdAt" : {
    "nano" : 178073000,
    "epochSecond" : 1760045302
  },
  "deletedAt" : null,
  "deletedBy" : null,
  "deleted" : false
}, {
  "id" : "44e8f0c0-0c29-4968-9891-90efdc928c3d",
  "organizationId" : "95068bb0-864b-4930-b06e-9acf4957c826",
  "oidcPublicClientId" : "290cc71d-cbd0-4c44-bf9e-a9d33a7314e6",
  "name" : "NetFoundry Google Account",
  "active" : true,
  "customQueryParameters" : "{\"audience\": \"https://gateway.{env}.netfoundry.io/\", \"connection\": \"google-oauth2\"}",
  "createdBy" : "2b6f496d-36f1-4e66-a205-8abcf1d41d74",
  "createdAt" : {
    "nano" : 759182000,
    "epochSecond" : 1760045297
  },
  "deletedAt" : null,
  "deletedBy" : null,
  "deleted" : false
} ]

Get Organization Oidc Public Client Mapping

GET /organization-oidc-public-client-mappings/{id}

Authorization

This endpoint requires:

  • read action on this organization-oidc-public-client-mapping resource.

Path parameters

Parameter Type Optional Description

id

Object

false

Response fields

Path Type Optional Description

id

String

true

organizationId

String

true

oidcPublicClientId

String

true

name

String

true

active

Boolean

true

customQueryParameters

String

true

createdBy

String

true

createdAt

Object

true

deletedAt

Object

true

deletedBy

String

true

deleted

Boolean

true

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/organization-oidc-public-client-mappings/08883d56-ecc5-4c53-9ef8-0fb5a3ff7641' -i -X GET

Example response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 495

{
  "id" : "08883d56-ecc5-4c53-9ef8-0fb5a3ff7641",
  "organizationId" : "58184ab6-3a60-4511-9ade-dd00c5c733a4",
  "oidcPublicClientId" : "79b78164-1e87-409d-8cac-2d84ee19aea5",
  "name" : "console-client-37f4754a-cf1f-46f2-b219-342887e8bc45",
  "active" : true,
  "customQueryParameters" : "{}",
  "createdBy" : "f3db62e7-ad25-41c9-a95b-ae6a66e6b466",
  "createdAt" : {
    "nano" : 388518000,
    "epochSecond" : 1760045361
  },
  "deletedAt" : null,
  "deletedBy" : null,
  "deleted" : false
}

Create Organization Oidc Public Client Mapping

POST /organization-oidc-public-client-mappings

Authorization

This endpoint requires:

  • create action on this organization-oidc-public-client-mapping resource.

  • read action on the oidc-public-client resource identified by the oidcPublicClientId property.

Request fields

Path Type Optional Description

organizationId

String

true

oidcPublicClientId

String

true

name

String

true

active

Boolean

true

customQueryParameters

String

true

Response fields

Path Type Optional Description

id

String

true

organizationId

String

true

oidcPublicClientId

String

true

name

String

true

active

Boolean

true

customQueryParameters

String

true

createdBy

String

true

createdAt

Object

true

deletedAt

Object

true

deletedBy

String

true

deleted

Boolean

true

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/organization-oidc-public-client-mappings' -i -X POST \
    -H 'Content-Type: application/json' \
    -d '{
  "organizationId" : "8cbc3fe7-411b-47ad-b616-680de419fc54",
  "oidcPublicClientId" : "8c6f4ad4-fa4e-4495-a1d7-3db27426ed7a",
  "name" : "console-client-5ab8fea6-8c2e-41c6-81b2-ab6d5180adef",
  "active" : true,
  "customQueryParameters" : "{}"
}'

Example response

HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 495

{
  "id" : "e73df42a-911a-4033-9216-f001048393ff",
  "organizationId" : "8cbc3fe7-411b-47ad-b616-680de419fc54",
  "oidcPublicClientId" : "8c6f4ad4-fa4e-4495-a1d7-3db27426ed7a",
  "name" : "console-client-5ab8fea6-8c2e-41c6-81b2-ab6d5180adef",
  "active" : true,
  "customQueryParameters" : "{}",
  "createdBy" : "0b12db6a-18ef-4fe8-af3a-5aeb51bb10f5",
  "createdAt" : {
    "nano" : 321899000,
    "epochSecond" : 1760045361
  },
  "deletedAt" : null,
  "deletedBy" : null,
  "deleted" : false
}

Update Organization Oidc Public Client Mapping

PATCH /organization-oidc-public-client-mappings/{id}

Authorization

This endpoint requires:

  • update action on this organization-oidc-public-client-mapping resource.

Path parameters

Parameter Type Optional Description

id

Object

false

Request fields

Path Type Optional Description

name

String

true

active

Boolean

true

customQueryParameters

String

true

Response fields

Path Type Optional Description

id

String

true

organizationId

String

true

oidcPublicClientId

String

true

name

String

true

active

Boolean

true

customQueryParameters

String

true

createdBy

String

true

createdAt

Object

true

deletedAt

Object

true

deletedBy

String

true

deleted

Boolean

true

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/organization-oidc-public-client-mappings/556e47fa-89ba-42b7-ba20-642f5a5a06fe' -i -X PATCH \
    -H 'Content-Type: application/json' \
    -d '{
  "name" : "custom-client-7bfb136b-588e-4436-a8cf-4947060cb467",
  "active" : true,
  "customQueryParameters" : "{}"
}'

Example response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 494

{
  "id" : "556e47fa-89ba-42b7-ba20-642f5a5a06fe",
  "organizationId" : "8ad1dff0-6ff9-4869-8828-a2cd8820b7c6",
  "oidcPublicClientId" : "74d575ab-ca29-492d-aab1-2c3486dbdbf7",
  "name" : "custom-client-7bfb136b-588e-4436-a8cf-4947060cb467",
  "active" : true,
  "customQueryParameters" : "{}",
  "createdBy" : "570f54f6-e626-4914-ac9a-75beea59df4b",
  "createdAt" : {
    "nano" : 229448000,
    "epochSecond" : 1760045361
  },
  "deletedAt" : null,
  "deletedBy" : null,
  "deleted" : false
}

Delete Organization Oidc Public Client Mapping

DELETE /organization-oidc-public-client-mappings/{id}

Authorization

This endpoint requires:

  • delete action on this organization-oidc-public-client-mapping resource.

Path parameters

Parameter Type Optional Description

id

Object

false

Response fields

Path Type Optional Description

id

String

true

organizationId

String

true

oidcPublicClientId

String

true

name

String

true

active

Boolean

true

customQueryParameters

String

true

createdBy

String

true

createdAt

Object

true

deletedAt

Object

true

deletedBy

String

true

deleted

Boolean

true

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/organization-oidc-public-client-mappings/712e4ff4-a049-408c-b956-258a3ade4665' -i -X DELETE

Example response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 543

{
  "id" : "712e4ff4-a049-408c-b956-258a3ade4665",
  "organizationId" : "8e306bef-6795-41e8-9f0e-1d08f1cc6826",
  "oidcPublicClientId" : "ce76e74d-0035-4a22-af0f-783bb1fe8e5e",
  "name" : "number two",
  "active" : true,
  "customQueryParameters" : "{}",
  "createdBy" : "018492b5-1e62-4f02-a03d-f44b6464c64e",
  "createdAt" : {
    "nano" : 477481000,
    "epochSecond" : 1760045361
  },
  "deletedAt" : {
    "nano" : 489745000,
    "epochSecond" : 1760045361
  },
  "deletedBy" : "f7773ead-b340-4804-84eb-2fecaf60dbb9",
  "deleted" : true
}

OIDC Audiences

Find Oidc Audiences

GET /oidc-audiences

Authorization

This endpoint requires:

  • read action on this oidc-audience resource.

Response fields

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

Path Type Optional Description

id

String

true

oidcIssuerId

String

true

audience

String

true

restrictedToOrganizationIds

Array[Object]

true

active

Boolean

true

createdBy

String

true

createdAt

Object

true

deletedAt

Object

true

deletedBy

String

true

deleted

Boolean

true

Example request

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

Example response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 1278

[ {
  "id" : "6a4f65ad-9db8-4ea7-b404-1d5c5f85cbdf",
  "oidcIssuerId" : "fc221f2c-e97f-4994-a29e-afc26395f6b6",
  "audience" : "https://gateway.{env}.netfoundry.io/",
  "restrictedToOrganizationIds" : [ ],
  "active" : true,
  "createdBy" : "2b6f496d-36f1-4e66-a205-8abcf1d41d74",
  "createdAt" : {
    "nano" : 3366000,
    "epochSecond" : 1760045298
  },
  "deletedAt" : null,
  "deletedBy" : null,
  "deleted" : false
}, {
  "id" : "8f3d2670-c386-453d-84f1-f2a685e0a011",
  "oidcIssuerId" : "b91a58e5-5c67-43fd-97b0-17212d0066d3",
  "audience" : "mop-aud-3aea3cb3-f9a6-4d36-be91-50fe0b0493d2",
  "restrictedToOrganizationIds" : [ ],
  "active" : true,
  "createdBy" : "1789a7d1-7e7e-4b46-8656-d80318214b10",
  "createdAt" : {
    "nano" : 546525000,
    "epochSecond" : 1760045356
  },
  "deletedAt" : null,
  "deletedBy" : null,
  "deleted" : false
}, {
  "id" : "b71d8edd-6bf1-4ed3-84e8-f3b5fe82868f",
  "oidcIssuerId" : "6c72dba0-a155-4804-9a70-89da12149793",
  "audience" : "https://gateway.{env}.netfoundry.io/",
  "restrictedToOrganizationIds" : [ ],
  "active" : true,
  "createdBy" : "2b6f496d-36f1-4e66-a205-8abcf1d41d74",
  "createdAt" : {
    "nano" : 3366000,
    "epochSecond" : 1760045298
  },
  "deletedAt" : null,
  "deletedBy" : null,
  "deleted" : false
} ]

Get Oidc Audience

GET /oidc-audiences/{id}

Authorization

This endpoint requires:

  • read action on this oidc-audience resource.

Path parameters

Parameter Type Optional Description

id

Object

false

Response fields

Path Type Optional Description

id

String

true

oidcIssuerId

String

true

audience

String

true

restrictedToOrganizationIds

Array[Object]

true

active

Boolean

true

createdBy

String

true

createdAt

Object

true

deletedAt

Object

true

deletedBy

String

true

deleted

Boolean

true

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/oidc-audiences/4cb51751-3a6a-45a1-bc60-b1d395d0146b' -i -X GET

Example response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 430

{
  "id" : "4cb51751-3a6a-45a1-bc60-b1d395d0146b",
  "oidcIssuerId" : "b9e8154e-0520-44db-9c36-7dfb3870c078",
  "audience" : "mop-aud-1b0e665b-f259-450b-81cf-67cc61bdc712",
  "restrictedToOrganizationIds" : [ ],
  "active" : true,
  "createdBy" : "4d2cca2d-54bb-416d-b49d-2683a7005009",
  "createdAt" : {
    "nano" : 295694000,
    "epochSecond" : 1760045357
  },
  "deletedAt" : null,
  "deletedBy" : null,
  "deleted" : false
}

Create Oidc Audience

POST /oidc-audiences

Authorization

This endpoint requires:

  • create action on this oidc-audience resource.

Request fields

Path Type Optional Description

oidcIssuerId

String

true

audience

String

true

restrictedToOrganizationIds

Array[Object]

true

active

Boolean

true

Response fields

Path Type Optional Description

id

String

true

oidcIssuerId

String

true

audience

String

true

restrictedToOrganizationIds

Array[Object]

true

active

Boolean

true

createdBy

String

true

createdAt

Object

true

deletedAt

Object

true

deletedBy

String

true

deleted

Boolean

true

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/oidc-audiences' -i -X POST \
    -H 'Content-Type: application/json' \
    -d '{
  "oidcIssuerId" : "b2c8e47c-9218-44b2-85a5-d1c02e3f3ae6",
  "audience" : "mop-aud-91430481-eca0-4ca4-9ebb-b28013848252",
  "restrictedToOrganizationIds" : [ ],
  "active" : true
}'

Example response

HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 430

{
  "id" : "0db40c79-ce3c-4ae2-b49f-6cd4ecb73c40",
  "oidcIssuerId" : "b2c8e47c-9218-44b2-85a5-d1c02e3f3ae6",
  "audience" : "mop-aud-91430481-eca0-4ca4-9ebb-b28013848252",
  "restrictedToOrganizationIds" : [ ],
  "active" : true,
  "createdBy" : "b4f3a3bd-9962-4954-a385-a519abe31a0c",
  "createdAt" : {
    "nano" : 233751000,
    "epochSecond" : 1760045357
  },
  "deletedAt" : null,
  "deletedBy" : null,
  "deleted" : false
}

Update Oidc Audience

PATCH /oidc-audiences/{id}

Authorization

This endpoint requires:

  • update action on this oidc-audience resource.

Path parameters

Parameter Type Optional Description

id

Object

false

Request fields

Path Type Optional Description

audience

String

true

restrictedToOrganizationIds

Array[Object]

true

active

Boolean

true

Response fields

Path Type Optional Description

id

String

true

oidcIssuerId

String

true

audience

String

true

restrictedToOrganizationIds

Array[Object]

true

active

Boolean

true

createdBy

String

true

createdAt

Object

true

deletedAt

Object

true

deletedBy

String

true

deleted

Boolean

true

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/oidc-audiences/537fd6f8-aedb-432a-87dd-76695f43605b' -i -X PATCH \
    -H 'Content-Type: application/json' \
    -d '{
  "audience" : "mop-aud-1e647b86-0488-4044-94f4-993b32609ac0",
  "restrictedToOrganizationIds" : [ ],
  "active" : false
}'

Example response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 431

{
  "id" : "537fd6f8-aedb-432a-87dd-76695f43605b",
  "oidcIssuerId" : "53bc750a-5ad5-4f0f-8f70-69045d4ec2e4",
  "audience" : "mop-aud-1e647b86-0488-4044-94f4-993b32609ac0",
  "restrictedToOrganizationIds" : [ ],
  "active" : false,
  "createdBy" : "d068ef52-2411-4a11-86ea-eb8a76b9311d",
  "createdAt" : {
    "nano" : 134802000,
    "epochSecond" : 1760045357
  },
  "deletedAt" : null,
  "deletedBy" : null,
  "deleted" : false
}

Delete Oidc Audience

DELETE /oidc-audiences/{id}

Authorization

This endpoint requires:

  • delete action on this oidc-audience resource.

Path parameters

Parameter Type Optional Description

id

Object

false

Response fields

Path Type Optional Description

id

String

true

oidcIssuerId

String

true

audience

String

true

restrictedToOrganizationIds

Array[Object]

true

active

Boolean

true

createdBy

String

true

createdAt

Object

true

deletedAt

Object

true

deletedBy

String

true

deleted

Boolean

true

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/oidc-audiences/ee9e63c9-89bc-47de-8a54-1002a468d498' -i -X DELETE

Example response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 519

{
  "id" : "ee9e63c9-89bc-47de-8a54-1002a468d498",
  "oidcIssuerId" : "32c94d20-e439-4fce-b731-656d75a07d7a",
  "audience" : "mop-aud-b2efd099-b94c-4edd-84cc-b6b8656a2e03",
  "restrictedToOrganizationIds" : [ ],
  "active" : true,
  "createdBy" : "d2d376d9-b105-4191-ab0a-c912ef0ae2e8",
  "createdAt" : {
    "nano" : 380902000,
    "epochSecond" : 1760045357
  },
  "deletedAt" : {
    "nano" : 393446000,
    "epochSecond" : 1760045357
  },
  "deletedBy" : "52d7e4a2-9824-4574-bcb4-b11cd53da8d0",
  "deleted" : true
}

User Identity to OIDC Audience Mappings

Find User Identity Audience Mappings

GET /user-identity-oidc-audience-mappings

Authorization

This endpoint requires:

  • read action on this user-identity-oidc-audience-mapping resource.

Response fields

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

Path Type Optional Description

id

String

true

userIdentityId

String

true

oidcAudienceId

String

true

subject

String

true

active

Boolean

true

createdBy

String

true

createdAt

Object

true

deletedAt

Object

true

deletedBy

String

true

deleted

Boolean

true

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/user-identity-oidc-audience-mappings' -i -X GET

Example response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 3

[ ]

Get User Identity Audience Mapping

GET /user-identity-oidc-audience-mappings/{id}

Authorization

This endpoint requires:

  • read action on this user-identity-oidc-audience-mapping resource.

Path parameters

Parameter Type Optional Description

id

Object

false

Response fields

Path Type Optional Description

id

String

true

userIdentityId

String

true

oidcAudienceId

String

true

subject

String

true

active

Boolean

true

createdBy

String

true

createdAt

Object

true

deletedAt

Object

true

deletedBy

String

true

deleted

Boolean

true

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/user-identity-oidc-audience-mappings/0e04b5eb-734d-46d2-9fab-73c27d02bd15' -i -X GET

Example response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 460

{
  "id" : "0e04b5eb-734d-46d2-9fab-73c27d02bd15",
  "userIdentityId" : "18d086e2-2ccc-49eb-919d-e960966f2326",
  "oidcAudienceId" : "1c6b27e2-3fc6-40b1-aab9-9c545c1a103f",
  "subject" : "console-client-c19db1c8-a657-43bf-a588-5641223862f6",
  "active" : true,
  "createdBy" : "1b22809c-9e47-4073-a9fb-81554f937c3a",
  "createdAt" : {
    "nano" : 290340000,
    "epochSecond" : 1760045369
  },
  "deletedAt" : null,
  "deletedBy" : null,
  "deleted" : false
}

Create User Identity Audience Mapping

POST /user-identity-oidc-audience-mappings

Authorization

This endpoint requires:

  • create action on this user-identity-oidc-audience-mapping resource.

  • create-identity-mapping action on the user-identity resource identified by the userIdentityId property.

  • read action on the oidc-audience resource identified by the oidcAudienceId property.

Request fields

Path Type Optional Description

userIdentityId

String

true

oidcAudienceId

String

true

subject

String

true

active

Boolean

true

Response fields

Path Type Optional Description

id

String

true

userIdentityId

String

true

oidcAudienceId

String

true

subject

String

true

active

Boolean

true

createdBy

String

true

createdAt

Object

true

deletedAt

Object

true

deletedBy

String

true

deleted

Boolean

true

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/user-identity-oidc-audience-mappings' -i -X POST \
    -H 'Content-Type: application/json' \
    -d '{
  "userIdentityId" : "5dbfdc6b-5df7-4fb6-8e57-cfca303afea4",
  "oidcAudienceId" : "fc40aced-7353-498a-96ad-96b7207849cf",
  "subject" : "console-client-71676e82-42de-4c36-95f3-41cea3865659",
  "active" : true
}'

Example response

HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 460

{
  "id" : "37a797fa-d986-4656-86d6-0f65bd19cc82",
  "userIdentityId" : "5dbfdc6b-5df7-4fb6-8e57-cfca303afea4",
  "oidcAudienceId" : "fc40aced-7353-498a-96ad-96b7207849cf",
  "subject" : "console-client-71676e82-42de-4c36-95f3-41cea3865659",
  "active" : true,
  "createdBy" : "3a672542-2077-4a4e-ad57-f1529ec3244a",
  "createdAt" : {
    "nano" : 238000000,
    "epochSecond" : 1760045369
  },
  "deletedAt" : null,
  "deletedBy" : null,
  "deleted" : false
}

Update User Identity Audience Mapping

PATCH /user-identity-oidc-audience-mappings/{id}

Authorization

This endpoint requires:

  • update action on this user-identity-oidc-audience-mapping resource.

Path parameters

Parameter Type Optional Description

id

Object

false

Request fields

Path Type Optional Description

active

Boolean

true

Response fields

Path Type Optional Description

id

String

true

userIdentityId

String

true

oidcAudienceId

String

true

subject

String

true

active

Boolean

true

createdBy

String

true

createdAt

Object

true

deletedAt

Object

true

deletedBy

String

true

deleted

Boolean

true

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/user-identity-oidc-audience-mappings/2512c93a-2120-48c1-ad2d-b73ef99feb0a' -i -X PATCH \
    -H 'Content-Type: application/json' \
    -d '{
  "active" : false
}'

Example response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 461

{
  "id" : "2512c93a-2120-48c1-ad2d-b73ef99feb0a",
  "userIdentityId" : "2d4ae139-cde3-4484-82f3-1a1ed76c055b",
  "oidcAudienceId" : "08282349-dda8-4f20-ac22-508ddad6ffe4",
  "subject" : "console-client-17fbfd03-483a-4469-bb9f-9703527ef670",
  "active" : false,
  "createdBy" : "9bb70881-063b-4426-9946-30cba0252740",
  "createdAt" : {
    "nano" : 127460000,
    "epochSecond" : 1760045369
  },
  "deletedAt" : null,
  "deletedBy" : null,
  "deleted" : false
}

Delete User Identity Audience Mapping

DELETE /user-identity-oidc-audience-mappings/{id}

Authorization

This endpoint requires:

  • delete action on this user-identity-oidc-audience-mapping resource.

Path parameters

Parameter Type Optional Description

id

Object

false

Response fields

Path Type Optional Description

id

String

true

userIdentityId

String

true

oidcAudienceId

String

true

subject

String

true

active

Boolean

true

createdBy

String

true

createdAt

Object

true

deletedAt

Object

true

deletedBy

String

true

deleted

Boolean

true

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/user-identity-oidc-audience-mappings/56a03119-c8ac-47ae-a7d1-26b9c78f76c2' -i -X DELETE

Example response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 549

{
  "id" : "56a03119-c8ac-47ae-a7d1-26b9c78f76c2",
  "userIdentityId" : "6abdacd0-fd0b-4481-ab59-cce40fec1b44",
  "oidcAudienceId" : "04f1eefa-7d13-4b29-b792-be42b2cf502d",
  "subject" : "console-client-21a73365-bd5f-4f03-9b9f-eca7c8a998eb",
  "active" : true,
  "createdBy" : "60ccd706-19ca-46f1-b87c-0ec78b0145d0",
  "createdAt" : {
    "nano" : 361342000,
    "epochSecond" : 1760045369
  },
  "deletedAt" : {
    "nano" : 379609000,
    "epochSecond" : 1760045369
  },
  "deletedBy" : "fc279b0f-d6a7-47af-a597-fd2ddb7c73e9",
  "deleted" : true
}

Identity Providers

Find Identity Providers

GET /identity-providers

Authorization

This endpoint requires:

  • read action on this identity-provider resource.

Query parameters

Supports standard paging query parameters.

Parameter Type Optional Description

name

String

true

organizationId

Object

true

auth0ConnectionId

Object

true

auth0ConnectionType

Object

true

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

active

Boolean

true

deleted

Object

true

Response fields

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

Path Type Optional Description

id

String

true

organizationId

String

true

auth0ConnectionId

String

true

name

String

true

auth0ConnectionType

String

true

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

active

Boolean

true

createdAt

Object

true

updatedAt

Object

true

deletedAt

Object

true

Example request

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

Example response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 1145

[ {
  "id" : "14f1de54-5627-4843-97f0-625f9cc78a94",
  "organizationId" : "7c91704e-47a1-4cdb-b657-79ee8cba11ce",
  "auth0ConnectionId" : "auth0-opaque-connectionId-133",
  "name" : "Username/Password",
  "auth0ConnectionType" : "Database",
  "active" : true,
  "createdAt" : {
    "nano" : 89718000,
    "epochSecond" : 1760045352
  },
  "updatedAt" : null,
  "deletedAt" : null
}, {
  "id" : "1677d34a-774a-448d-bc24-f0981cfe5e63",
  "organizationId" : "6187b46a-90c2-4ed3-84d4-3fe6ac803c09",
  "auth0ConnectionId" : "auth0-opaque-connectionId-136",
  "name" : "Username/Password",
  "auth0ConnectionType" : "Database",
  "active" : true,
  "createdAt" : {
    "nano" : 196205000,
    "epochSecond" : 1760045352
  },
  "updatedAt" : null,
  "deletedAt" : null
}, {
  "id" : "21444ed7-b44a-46a8-b7d9-4090598151ee",
  "organizationId" : "0778bf21-4412-4a1a-b8d4-2470a464e73b",
  "auth0ConnectionId" : "auth0-opaque-connectionId-90",
  "name" : "Username/Password",
  "auth0ConnectionType" : "Database",
  "active" : true,
  "createdAt" : {
    "nano" : 10487000,
    "epochSecond" : 1760045350
  },
  "updatedAt" : null,
  "deletedAt" : null
} ]

Get Identity Provider

GET /identity-providers/{id}

Authorization

This endpoint requires:

  • read action on this identity-provider resource.

Path parameters

Parameter Type Optional Description

id

Object

false

Response fields

Path Type Optional Description

id

String

true

organizationId

String

true

auth0ConnectionId

String

true

name

String

true

auth0ConnectionType

String

true

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

active

Boolean

true

createdAt

Object

true

updatedAt

Object

true

deletedAt

Object

true

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/identity-providers/cb62e527-82a2-4b4c-874e-c2ca3ca550c7' -i -X GET

Example response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 393

{
  "id" : "cb62e527-82a2-4b4c-874e-c2ca3ca550c7",
  "organizationId" : "74a69a21-ed9c-48cb-8880-4f3284eeb5d7",
  "auth0ConnectionId" : "auth0-opaque-connectionId-3",
  "name" : "ACME Federated Active Directory",
  "auth0ConnectionType" : "Enterprise",
  "active" : true,
  "createdAt" : {
    "nano" : 81477000,
    "epochSecond" : 1760045302
  },
  "updatedAt" : null,
  "deletedAt" : null
}

Create Identity Provider

POST /identity-providers

Authorization

This endpoint requires:

  • create action on this identity-provider resource.

Request fields

Path Type Optional Description

organizationId

String

true

auth0ConnectionId

String

true

name

String

true

auth0ConnectionType

String

true

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

Response fields

Path Type Optional Description

id

String

true

organizationId

String

true

auth0ConnectionId

String

true

name

String

true

auth0ConnectionType

String

true

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

active

Boolean

true

createdAt

Object

true

updatedAt

Object

true

deletedAt

Object

true

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/identity-providers' -i -X POST \
    -H 'Content-Type: application/json' \
    -d '{
  "organizationId" : "be55cd06-f3b9-41e3-aebb-b1879b82ace2",
  "auth0ConnectionId" : "auth0-opaque-connection",
  "name" : "Corp SAML",
  "auth0ConnectionType" : "Enterprise"
}'

Example response

HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 368

{
  "id" : "9c6df8ed-2bdd-4850-85e8-907c31399248",
  "organizationId" : "be55cd06-f3b9-41e3-aebb-b1879b82ace2",
  "auth0ConnectionId" : "auth0-opaque-connection",
  "name" : "Corp SAML",
  "auth0ConnectionType" : "Enterprise",
  "active" : true,
  "createdAt" : {
    "nano" : 477957000,
    "epochSecond" : 1760045354
  },
  "updatedAt" : null,
  "deletedAt" : null
}

Update Identity Provider

PUT /identity-providers/{id}

Authorization

This endpoint requires:

  • update action on this identity-provider resource.

Path parameters

Parameter Type Optional Description

id

Object

false

Request fields

Path Type Optional Description

name

String

true

Response fields

Path Type Optional Description

id

String

true

organizationId

String

true

auth0ConnectionId

String

true

name

String

true

auth0ConnectionType

String

true

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

active

Boolean

true

createdAt

Object

true

updatedAt

Object

true

deletedAt

Object

true

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/identity-providers/e609b390-ffc8-4de2-8676-19205bd482e4' -i -X PUT \
    -H 'Content-Type: application/json' \
    -d '{
  "name" : "New IdP Name"
}'

Example response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 431

{
  "id" : "e609b390-ffc8-4de2-8676-19205bd482e4",
  "organizationId" : "d37e274a-91a8-42b5-b421-f5fb152eedc3",
  "auth0ConnectionId" : "auth0-opaque-connectionId-226",
  "name" : "New IdP Name",
  "auth0ConnectionType" : "Database",
  "active" : true,
  "createdAt" : {
    "nano" : 879431000,
    "epochSecond" : 1760045354
  },
  "updatedAt" : {
    "nano" : 896759000,
    "epochSecond" : 1760045354
  },
  "deletedAt" : null
}

Activate Or Deactivate Identity Provider

PUT /identity-providers/{id}/{action:activate|deactivate}

Authorization

This endpoint requires:

  • update action on this identity-provider resource.

Path parameters

Parameter Type Optional Description

id

Object

false

action

String

false

Response fields

Path Type Optional Description

id

String

true

organizationId

String

true

auth0ConnectionId

String

true

name

String

true

auth0ConnectionType

String

true

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

active

Boolean

true

createdAt

Object

true

updatedAt

Object

true

deletedAt

Object

true

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/identity-providers/fbc3c85d-2fc6-4cd7-9b43-1ca3622b5a71/activate' -i -X PUT

Example response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 380

{
  "id" : "fbc3c85d-2fc6-4cd7-9b43-1ca3622b5a71",
  "organizationId" : "b71321f0-b3cc-4531-9666-63879f088b32",
  "auth0ConnectionId" : "auth0-opaque-connectionId-220",
  "name" : "Username/Password",
  "auth0ConnectionType" : "Database",
  "active" : true,
  "createdAt" : {
    "nano" : 607307000,
    "epochSecond" : 1760045354
  },
  "updatedAt" : null,
  "deletedAt" : null
}

Delete Identity Provider

DELETE /identity-providers/{id}

Authorization

This endpoint requires:

  • delete action on this identity-provider resource.

Path parameters

Parameter Type Optional Description

id

Object

false

Response fields

Path Type Optional Description

id

String

true

organizationId

String

true

auth0ConnectionId

String

true

name

String

true

auth0ConnectionType

String

true

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

active

Boolean

true

createdAt

Object

true

updatedAt

Object

true

deletedAt

Object

true

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/identity-providers/0aef4217-3684-4ce7-a851-dc10592dc61d' -i -X DELETE

Example response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 492

{
  "id" : "0aef4217-3684-4ce7-a851-dc10592dc61d",
  "organizationId" : "b7f2a3b2-19cd-4815-bf3b-1996966fb089",
  "auth0ConnectionId" : "auth0-opaque-connectionId-224",
  "name" : "Username/Password",
  "auth0ConnectionType" : "Database",
  "active" : true,
  "createdAt" : {
    "nano" : 818762000,
    "epochSecond" : 1760045354
  },
  "updatedAt" : {
    "nano" : 831908000,
    "epochSecond" : 1760045354
  },
  "deletedAt" : {
    "nano" : 831000000,
    "epochSecond" : 1760045354
  }
}

Default Roles

Find Default Roles

GET /default-roles

Authorization

This endpoint requires:

  • read action on this default-role resource.

Response fields

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

Path Type Optional Description

id

String

true

organizationId

String

true

name

String

true

roleType

String

true

Must be one of [Standard, Custom].

roleId

String

true

createdBy

String

true

createdAt

Object

true

deletedAt

Object

true

deletedBy

String

true

deleted

Boolean

true

Example request

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

Example response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 1341

[ {
  "id" : "0576f72e-9f6c-41ec-9186-5669343ca036",
  "organizationId" : "74a69a21-ed9c-48cb-8880-4f3284eeb5d7",
  "name" : "Custom Role - 3457a135-9587-4baf-bbf3-401a1315f802",
  "roleType" : "Custom",
  "roleId" : "3457a135-9587-4baf-bbf3-401a1315f802",
  "createdBy" : "3b6995dc-56e8-4652-a9e2-330919a3631c",
  "createdAt" : {
    "nano" : 215542000,
    "epochSecond" : 1760045302
  },
  "deletedAt" : null,
  "deletedBy" : null,
  "deleted" : false
}, {
  "id" : "1f14b39f-17f2-48ca-a409-c1d4e0ff5101",
  "organizationId" : "b9c46231-0564-4138-bb25-b5a1dd98da7f",
  "name" : "Standard Role - ae3f1410-3cff-44cf-8754-c5120acfb1b0",
  "roleType" : "Standard",
  "roleId" : "ae3f1410-3cff-44cf-8754-c5120acfb1b0",
  "createdBy" : "62d23c2d-b50c-4e1e-b238-1c7d640b8a66",
  "createdAt" : {
    "nano" : 291832000,
    "epochSecond" : 1760045349
  },
  "deletedAt" : null,
  "deletedBy" : null,
  "deleted" : false
}, {
  "id" : "4d4b9458-8af3-487c-b422-1c67b8b0b51d",
  "organizationId" : "95068bb0-864b-4930-b06e-9acf4957c826",
  "name" : "Cloud Engineering",
  "roleType" : "Custom",
  "roleId" : "8f1493a4-29ca-4b34-8d04-b6ef954b097c",
  "createdBy" : "2b6f496d-36f1-4e66-a205-8abcf1d41d74",
  "createdAt" : {
    "nano" : 760695000,
    "epochSecond" : 1760045297
  },
  "deletedAt" : null,
  "deletedBy" : null,
  "deleted" : false
} ]

Get Default Role

GET /default-roles/{id}

Authorization

This endpoint requires:

  • read action on this default-role resource.

Path parameters

Parameter Type Optional Description

id

Object

false

Response fields

Path Type Optional Description

id

String

true

organizationId

String

true

name

String

true

roleType

String

true

Must be one of [Standard, Custom].

roleId

String

true

createdBy

String

true

createdAt

Object

true

deletedAt

Object

true

deletedBy

String

true

deleted

Boolean

true

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/default-roles/0576f72e-9f6c-41ec-9186-5669343ca036' -i -X GET

Example response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 454

{
  "id" : "0576f72e-9f6c-41ec-9186-5669343ca036",
  "organizationId" : "74a69a21-ed9c-48cb-8880-4f3284eeb5d7",
  "name" : "Custom Role - 3457a135-9587-4baf-bbf3-401a1315f802",
  "roleType" : "Custom",
  "roleId" : "3457a135-9587-4baf-bbf3-401a1315f802",
  "createdBy" : "3b6995dc-56e8-4652-a9e2-330919a3631c",
  "createdAt" : {
    "nano" : 215542000,
    "epochSecond" : 1760045302
  },
  "deletedAt" : null,
  "deletedBy" : null,
  "deleted" : false
}

Create Default Role

POST /default-roles

Authorization

This endpoint requires:

  • create action on this default-role resource.

  • update action on the organization resource identified by the organization property.

Request fields

Path Type Optional Description

organizationId

String

true

roleType

String

true

Must be one of [Standard, Custom].

roleId

String

true

Response fields

Path Type Optional Description

id

String

true

organizationId

String

true

name

String

true

roleType

String

true

Must be one of [Standard, Custom].

roleId

String

true

createdBy

String

true

createdAt

Object

true

deletedAt

Object

true

deletedBy

String

true

deleted

Boolean

true

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/default-roles' -i -X POST \
    -H 'Content-Type: application/json' \
    -d '{
  "organizationId" : "20e5b9ad-40b8-4206-ad0b-fb2d47f6d0e7",
  "roleType" : "Standard",
  "roleId" : "68402c93-79ce-4a68-adbf-85c2129ba94b"
}'

Example response

HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 458

{
  "id" : "43bb69a7-1137-459d-af1f-9caf13631428",
  "organizationId" : "20e5b9ad-40b8-4206-ad0b-fb2d47f6d0e7",
  "name" : "Standard Role - 68402c93-79ce-4a68-adbf-85c2129ba94b",
  "roleType" : "Standard",
  "roleId" : "68402c93-79ce-4a68-adbf-85c2129ba94b",
  "createdBy" : "bcaaf58c-c1b5-4ebb-b9b9-4c51fec5de89",
  "createdAt" : {
    "nano" : 897384000,
    "epochSecond" : 1760045349
  },
  "deletedAt" : null,
  "deletedBy" : null,
  "deleted" : false
}

Delete Default Role

DELETE /default-roles/{id}

Authorization

This endpoint requires:

  • delete action on this default-role resource.

Path parameters

Parameter Type Optional Description

id

Object

false

Response fields

Path Type Optional Description

id

String

true

organizationId

String

true

name

String

true

roleType

String

true

Must be one of [Standard, Custom].

roleId

String

true

createdBy

String

true

createdAt

Object

true

deletedAt

Object

true

deletedBy

String

true

deleted

Boolean

true

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/default-roles/9c2da648-0cef-4697-8704-d999a2ac70ce' -i -X DELETE

Example response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 547

{
  "id" : "9c2da648-0cef-4697-8704-d999a2ac70ce",
  "organizationId" : "74a69a21-ed9c-48cb-8880-4f3284eeb5d7",
  "name" : "Standard Role - 47e0ab67-4ada-4b94-9626-ee1b2ea780e9",
  "roleType" : "Standard",
  "roleId" : "47e0ab67-4ada-4b94-9626-ee1b2ea780e9",
  "createdBy" : "67a86339-b4bb-4e32-ac54-b2a1429ab7da",
  "createdAt" : {
    "nano" : 646475000,
    "epochSecond" : 1760045349
  },
  "deletedAt" : {
    "nano" : 659000000,
    "epochSecond" : 1760045349
  },
  "deletedBy" : "01c668e0-cb08-4a55-9e09-a5205cb7b3b0",
  "deleted" : true
}

Grant Default Role

POST /default-roles/{id}/grant

Authorization

This endpoint requires:

  • read action on this default-role resource.

  • create action on the invitation resource identified by the organization property.

Path parameters

Parameter Type Optional Description

id

Object

false

Request fields

No request body.

Response fields

No response body.

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/default-roles/1f14b39f-17f2-48ca-a409-c1d4e0ff5101/grant' -i -X POST \
    -H 'Content-Type: application/json' \
    -d '{
  "includeIdentityIds" : [ "f6c0b0f0-5ee6-42e9-90a4-e7e939a28429", "e6bd60e9-3889-492d-8de0-59edfe3507dc", "f2fda0f3-2e3a-414a-ba31-dc829d5b18a2" ],
  "excludeIdentityIds" : [ "e6bd60e9-3889-492d-8de0-59edfe3507dc", "cc774745-b54a-4d78-b348-32df72ad750a", "f2fda0f3-2e3a-414a-ba31-dc829d5b18a2" ]
}'

Example response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 51

{
  "f6c0b0f0-5ee6-42e9-90a4-e7e939a28429" : true
}

User Identity

Get Identity

GET /identities/self

Authorization

This endpoint requires no specific permission, only an authenticated client.

Response fields

Path Type Optional Description

name

String

true

id

String

true

type

String

true

active

Boolean

true

email

String

true

deletedAt

Object

true

tenantId

String

true

Deprecated..

organizationId

String

true

createdAt

Object

true

Example request

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

Example response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 717

{
  "id" : "92fc31bf-69ad-46de-91e9-7fe6c291e30d",
  "organizationId" : "74a69a21-ed9c-48cb-8880-4f3284eeb5d7",
  "firstName" : "First",
  "lastName" : "Last",
  "email" : "random-356@acme.com",
  "identityMappings" : [ {
    "id" : "63d7b05a-29ff-4a1a-b1ec-3824f90b024c",
    "auth0UserId" : "auth0-opaque-userId-357",
    "identityProviderId" : "cb62e527-82a2-4b4c-874e-c2ca3ca550c7",
    "userIdentityId" : "92fc31bf-69ad-46de-91e9-7fe6c291e30d"
  } ],
  "identityAudienceMappings" : [ ],
  "active" : true,
  "createdAt" : {
    "nano" : 22162000,
    "epochSecond" : 1760045368
  },
  "deletedAt" : null,
  "name" : "First Last",
  "tenantId" : "74a69a21-ed9c-48cb-8880-4f3284eeb5d7",
  "type" : "UserIdentity"
}

Get Identity

GET /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}}

Authorization

This endpoint requires:

  • read action on this user-identity resource.

Path parameters

Parameter Type Optional Description

id

Object

false

Response fields

Path Type Optional Description

name

String

true

id

String

true

type

String

true

active

Boolean

true

email

String

true

deletedAt

Object

true

tenantId

String

true

Deprecated..

organizationId

String

true

createdAt

Object

true

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/identities/0e29c7b6-0dc9-4d05-8cd0-ccb651cebeb8' -i -X GET

Example response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 710

{
  "id" : "0e29c7b6-0dc9-4d05-8cd0-ccb651cebeb8",
  "organizationId" : "74a69a21-ed9c-48cb-8880-4f3284eeb5d7",
  "firstName" : "John",
  "lastName" : "Doe",
  "email" : "john.doe@acme.com",
  "identityMappings" : [ {
    "id" : "ba870987-a3e0-4469-aff1-20f88bb64601",
    "auth0UserId" : "auth0-opaque-userId-5",
    "identityProviderId" : "cb62e527-82a2-4b4c-874e-c2ca3ca550c7",
    "userIdentityId" : "0e29c7b6-0dc9-4d05-8cd0-ccb651cebeb8"
  } ],
  "identityAudienceMappings" : [ ],
  "active" : true,
  "createdAt" : {
    "nano" : 247797000,
    "epochSecond" : 1760045302
  },
  "deletedAt" : null,
  "name" : "John Doe",
  "tenantId" : "74a69a21-ed9c-48cb-8880-4f3284eeb5d7",
  "type" : "UserIdentity"
}

Find User Identities

GET /user-identities

Authorization

This endpoint requires:

  • read action on this user-identity resource.

Response fields

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

Path Type Optional Description

id

String

true

organizationId

String

true

firstName

String

true

lastName

String

true

email

String

true

identityMappings

Array[Object]

true

identityMappings[].id

String

true

identityMappings[].auth0UserId

String

true

identityMappings[].identityProviderId

String

true

identityMappings[].userIdentityId

String

true

identityAudienceMappings

Array[Object]

true

identityAudienceMappings[].id

String

true

identityAudienceMappings[].userIdentityId

String

true

identityAudienceMappings[].oidcAudienceId

String

true

identityAudienceMappings[].subject

String

true

identityAudienceMappings[].active

Boolean

true

identityAudienceMappings[].createdBy

String

true

identityAudienceMappings[].createdAt

Object

true

identityAudienceMappings[].deletedAt

Object

true

identityAudienceMappings[].deletedBy

String

true

identityAudienceMappings[].deleted

Boolean

true

active

Boolean

true

createdAt

Object

true

deletedAt

Object

true

name

String

true

tenantId

String

true

Deprecated..

type

String

true

Example request

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

Example response

HTTP/1.1 200 OK
Link: <https://gateway.netFoundry.io/identity/v1/user-identities?page=1>; rel="next", <https://gateway.netFoundry.io/identity/v1/user-identities?page=4>; rel="last"
Content-Type: application/json
Content-Length: 2153

[ {
  "id" : "0e29c7b6-0dc9-4d05-8cd0-ccb651cebeb8",
  "organizationId" : "74a69a21-ed9c-48cb-8880-4f3284eeb5d7",
  "firstName" : "John",
  "lastName" : "Doe",
  "email" : "john.doe@acme.com",
  "identityMappings" : [ {
    "id" : "ba870987-a3e0-4469-aff1-20f88bb64601",
    "auth0UserId" : "auth0-opaque-userId-5",
    "identityProviderId" : "cb62e527-82a2-4b4c-874e-c2ca3ca550c7",
    "userIdentityId" : "0e29c7b6-0dc9-4d05-8cd0-ccb651cebeb8"
  } ],
  "identityAudienceMappings" : [ ],
  "active" : true,
  "createdAt" : {
    "nano" : 247797000,
    "epochSecond" : 1760045302
  },
  "deletedAt" : null,
  "name" : "John Doe",
  "tenantId" : "74a69a21-ed9c-48cb-8880-4f3284eeb5d7",
  "type" : "UserIdentity"
}, {
  "id" : "23117f5c-2fc8-4064-8dd9-0da2b2f8a337",
  "organizationId" : "74a69a21-ed9c-48cb-8880-4f3284eeb5d7",
  "firstName" : "First",
  "lastName" : "Last",
  "email" : "random-102@acme.com",
  "identityMappings" : [ {
    "id" : "3e12d606-eae8-42a1-8a4f-a12f0b121993",
    "auth0UserId" : "auth0-opaque-userId-103",
    "identityProviderId" : "cb62e527-82a2-4b4c-874e-c2ca3ca550c7",
    "userIdentityId" : "23117f5c-2fc8-4064-8dd9-0da2b2f8a337"
  } ],
  "identityAudienceMappings" : [ ],
  "active" : false,
  "createdAt" : {
    "nano" : 626548000,
    "epochSecond" : 1760045350
  },
  "deletedAt" : null,
  "name" : "First Last",
  "tenantId" : "74a69a21-ed9c-48cb-8880-4f3284eeb5d7",
  "type" : "UserIdentity"
}, {
  "id" : "24f70d75-8701-4e1e-89b3-57d62a6ff830",
  "organizationId" : "5eaf0531-ae5f-4360-804a-2b5b2c6200f7",
  "firstName" : "First",
  "lastName" : "Last",
  "email" : "random-66@acme.com",
  "identityMappings" : [ {
    "id" : "32f59de0-1f27-44d1-96b2-6082caac5c93",
    "auth0UserId" : "auth0-opaque-userId-67",
    "identityProviderId" : "3262910b-fb16-44f5-b22e-907471c82de6",
    "userIdentityId" : "24f70d75-8701-4e1e-89b3-57d62a6ff830"
  } ],
  "identityAudienceMappings" : [ ],
  "active" : true,
  "createdAt" : {
    "nano" : 543353000,
    "epochSecond" : 1760045349
  },
  "deletedAt" : null,
  "name" : "First Last",
  "tenantId" : "5eaf0531-ae5f-4360-804a-2b5b2c6200f7",
  "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}}

Authorization

This endpoint requires:

  • read action on this user-identity resource.

Path parameters

Parameter Type Optional Description

id

Object

false

Response fields

Path Type Optional Description

id

String

true

organizationId

String

true

firstName

String

true

lastName

String

true

email

String

true

identityMappings

Array[Object]

true

identityMappings[].id

String

true

identityMappings[].auth0UserId

String

true

identityMappings[].identityProviderId

String

true

identityMappings[].userIdentityId

String

true

identityAudienceMappings

Array[Object]

true

identityAudienceMappings[].id

String

true

identityAudienceMappings[].userIdentityId

String

true

identityAudienceMappings[].oidcAudienceId

String

true

identityAudienceMappings[].subject

String

true

identityAudienceMappings[].active

Boolean

true

identityAudienceMappings[].createdBy

String

true

identityAudienceMappings[].createdAt

Object

true

identityAudienceMappings[].deletedAt

Object

true

identityAudienceMappings[].deletedBy

String

true

identityAudienceMappings[].deleted

Boolean

true

active

Boolean

true

createdAt

Object

true

deletedAt

Object

true

name

String

true

tenantId

String

true

Deprecated..

type

String

true

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/user-identities/0e29c7b6-0dc9-4d05-8cd0-ccb651cebeb8' -i -X GET

Example response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 710

{
  "id" : "0e29c7b6-0dc9-4d05-8cd0-ccb651cebeb8",
  "organizationId" : "74a69a21-ed9c-48cb-8880-4f3284eeb5d7",
  "firstName" : "John",
  "lastName" : "Doe",
  "email" : "john.doe@acme.com",
  "identityMappings" : [ {
    "id" : "ba870987-a3e0-4469-aff1-20f88bb64601",
    "auth0UserId" : "auth0-opaque-userId-5",
    "identityProviderId" : "cb62e527-82a2-4b4c-874e-c2ca3ca550c7",
    "userIdentityId" : "0e29c7b6-0dc9-4d05-8cd0-ccb651cebeb8"
  } ],
  "identityAudienceMappings" : [ ],
  "active" : true,
  "createdAt" : {
    "nano" : 247797000,
    "epochSecond" : 1760045302
  },
  "deletedAt" : null,
  "name" : "John Doe",
  "tenantId" : "74a69a21-ed9c-48cb-8880-4f3284eeb5d7",
  "type" : "UserIdentity"
}

Get User Identity By Mapping

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

Authorization

This endpoint requires:

  • read action on this user-identity resource.

Path parameters

Parameter Type Optional Description

auth0UserId

String

false

identityProviderId

Object

false

Response fields

Path Type Optional Description

id

String

true

organizationId

String

true

firstName

String

true

lastName

String

true

email

String

true

identityMappings

Array[Object]

true

identityMappings[].id

String

true

identityMappings[].auth0UserId

String

true

identityMappings[].identityProviderId

String

true

identityMappings[].userIdentityId

String

true

identityAudienceMappings

Array[Object]

true

identityAudienceMappings[].id

String

true

identityAudienceMappings[].userIdentityId

String

true

identityAudienceMappings[].oidcAudienceId

String

true

identityAudienceMappings[].subject

String

true

identityAudienceMappings[].active

Boolean

true

identityAudienceMappings[].createdBy

String

true

identityAudienceMappings[].createdAt

Object

true

identityAudienceMappings[].deletedAt

Object

true

identityAudienceMappings[].deletedBy

String

true

identityAudienceMappings[].deleted

Boolean

true

active

Boolean

true

createdAt

Object

true

deletedAt

Object

true

name

String

true

tenantId

String

true

Deprecated..

type

String

true

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/user-identities/mapping/auth0-opaque-userId-5/cb62e527-82a2-4b4c-874e-c2ca3ca550c7' -i -X GET

Example response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 710

{
  "id" : "0e29c7b6-0dc9-4d05-8cd0-ccb651cebeb8",
  "organizationId" : "74a69a21-ed9c-48cb-8880-4f3284eeb5d7",
  "firstName" : "John",
  "lastName" : "Doe",
  "email" : "john.doe@acme.com",
  "identityMappings" : [ {
    "id" : "ba870987-a3e0-4469-aff1-20f88bb64601",
    "auth0UserId" : "auth0-opaque-userId-5",
    "identityProviderId" : "cb62e527-82a2-4b4c-874e-c2ca3ca550c7",
    "userIdentityId" : "0e29c7b6-0dc9-4d05-8cd0-ccb651cebeb8"
  } ],
  "identityAudienceMappings" : [ ],
  "active" : true,
  "createdAt" : {
    "nano" : 247797000,
    "epochSecond" : 1760045302
  },
  "deletedAt" : null,
  "name" : "John Doe",
  "tenantId" : "74a69a21-ed9c-48cb-8880-4f3284eeb5d7",
  "type" : "UserIdentity"
}

Create Identity

POST /user-identities

Authorization

This endpoint requires:

  • create action on this user-identity resource.

Request fields

Path Type Optional Description

organizationId

String

true

firstName

String

true

lastName

String

true

email

String

true

Response fields

Path Type Optional Description

id

String

true

organizationId

String

true

firstName

String

true

lastName

String

true

email

String

true

identityMappings

Array[Object]

true

identityMappings[].id

String

true

identityMappings[].auth0UserId

String

true

identityMappings[].identityProviderId

String

true

identityMappings[].userIdentityId

String

true

identityAudienceMappings

Array[Object]

true

identityAudienceMappings[].id

String

true

identityAudienceMappings[].userIdentityId

String

true

identityAudienceMappings[].oidcAudienceId

String

true

identityAudienceMappings[].subject

String

true

identityAudienceMappings[].active

Boolean

true

identityAudienceMappings[].createdBy

String

true

identityAudienceMappings[].createdAt

Object

true

identityAudienceMappings[].deletedAt

Object

true

identityAudienceMappings[].deletedBy

String

true

identityAudienceMappings[].deleted

Boolean

true

active

Boolean

true

createdAt

Object

true

deletedAt

Object

true

name

String

true

tenantId

String

true

Deprecated..

type

String

true

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/user-identities' -i -X POST \
    -H 'Content-Type: application/json' \
    -d '{
  "organizationId" : "74a69a21-ed9c-48cb-8880-4f3284eeb5d7",
  "firstName" : "Jane",
  "lastName" : "Doe",
  "email" : "jane.doe@acme.com"
}'

Example response

HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 479

{
  "id" : "a4561619-4640-4fcd-9f41-0113a6ff0b20",
  "organizationId" : "74a69a21-ed9c-48cb-8880-4f3284eeb5d7",
  "firstName" : "Jane",
  "lastName" : "Doe",
  "email" : "jane.doe@acme.com",
  "identityMappings" : [ ],
  "identityAudienceMappings" : [ ],
  "active" : true,
  "createdAt" : {
    "nano" : 746141000,
    "epochSecond" : 1760045368
  },
  "deletedAt" : null,
  "name" : "Jane Doe",
  "tenantId" : "74a69a21-ed9c-48cb-8880-4f3284eeb5d7",
  "type" : "UserIdentity"
}

Update

PUT /user-identities/{id}

Authorization

This endpoint requires:

  • update action on this user-identity resource.

Path parameters

Parameter Type Optional Description

id

Object

false

Request fields

Path Type Optional Description

firstName

String

true

lastName

String

true

email

String

true

Response fields

Path Type Optional Description

id

String

true

organizationId

String

true

firstName

String

true

lastName

String

true

email

String

true

identityMappings

Array[Object]

true

identityMappings[].id

String

true

identityMappings[].auth0UserId

String

true

identityMappings[].identityProviderId

String

true

identityMappings[].userIdentityId

String

true

identityAudienceMappings

Array[Object]

true

identityAudienceMappings[].id

String

true

identityAudienceMappings[].userIdentityId

String

true

identityAudienceMappings[].oidcAudienceId

String

true

identityAudienceMappings[].subject

String

true

identityAudienceMappings[].active

Boolean

true

identityAudienceMappings[].createdBy

String

true

identityAudienceMappings[].createdAt

Object

true

identityAudienceMappings[].deletedAt

Object

true

identityAudienceMappings[].deletedBy

String

true

identityAudienceMappings[].deleted

Boolean

true

active

Boolean

true

createdAt

Object

true

deletedAt

Object

true

name

String

true

tenantId

String

true

Deprecated..

type

String

true

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/user-identities/4268b3d6-edfc-4eb4-a1f4-baf80e639b94' -i -X PUT \
    -H 'Content-Type: application/json' \
    -d '{
  "firstName" : "Bobby",
  "lastName" : "White",
  "email" : "bobby.white@acme.com"
}'

Example response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 721

{
  "id" : "4268b3d6-edfc-4eb4-a1f4-baf80e639b94",
  "organizationId" : "74a69a21-ed9c-48cb-8880-4f3284eeb5d7",
  "firstName" : "Bobby",
  "lastName" : "White",
  "email" : "bobby.white@acme.com",
  "identityMappings" : [ {
    "id" : "6f1ba235-0b79-4ddc-aabd-ebf218669cee",
    "auth0UserId" : "auth0-opaque-userId-361",
    "identityProviderId" : "cb62e527-82a2-4b4c-874e-c2ca3ca550c7",
    "userIdentityId" : "4268b3d6-edfc-4eb4-a1f4-baf80e639b94"
  } ],
  "identityAudienceMappings" : [ ],
  "active" : true,
  "createdAt" : {
    "nano" : 225020000,
    "epochSecond" : 1760045368
  },
  "deletedAt" : null,
  "name" : "Bobby White",
  "tenantId" : "74a69a21-ed9c-48cb-8880-4f3284eeb5d7",
  "type" : "UserIdentity"
}

Activate Or Deactivate User Identity

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

Authorization

This endpoint requires:

  • update-active action on this user-identity resource.

Path parameters

Parameter Type Optional Description

id

Object

false

action

String

false

Response fields

Path Type Optional Description

id

String

true

organizationId

String

true

firstName

String

true

lastName

String

true

email

String

true

identityMappings

Array[Object]

true

identityMappings[].id

String

true

identityMappings[].auth0UserId

String

true

identityMappings[].identityProviderId

String

true

identityMappings[].userIdentityId

String

true

identityAudienceMappings

Array[Object]

true

identityAudienceMappings[].id

String

true

identityAudienceMappings[].userIdentityId

String

true

identityAudienceMappings[].oidcAudienceId

String

true

identityAudienceMappings[].subject

String

true

identityAudienceMappings[].active

Boolean

true

identityAudienceMappings[].createdBy

String

true

identityAudienceMappings[].createdAt

Object

true

identityAudienceMappings[].deletedAt

Object

true

identityAudienceMappings[].deletedBy

String

true

identityAudienceMappings[].deleted

Boolean

true

active

Boolean

true

createdAt

Object

true

deletedAt

Object

true

name

String

true

tenantId

String

true

Deprecated..

type

String

true

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/user-identities/a48991b1-6b24-4cfe-bc6a-348a86ac8bb1/deactivate' -i -X PUT

Example response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 719

{
  "id" : "a48991b1-6b24-4cfe-bc6a-348a86ac8bb1",
  "organizationId" : "74a69a21-ed9c-48cb-8880-4f3284eeb5d7",
  "firstName" : "First",
  "lastName" : "Last",
  "email" : "random-362@acme.com",
  "identityMappings" : [ {
    "id" : "434a4c1f-8433-4409-a184-f71775e74cac",
    "auth0UserId" : "auth0-opaque-userId-363",
    "identityProviderId" : "cb62e527-82a2-4b4c-874e-c2ca3ca550c7",
    "userIdentityId" : "a48991b1-6b24-4cfe-bc6a-348a86ac8bb1"
  } ],
  "identityAudienceMappings" : [ ],
  "active" : false,
  "createdAt" : {
    "nano" : 288058000,
    "epochSecond" : 1760045368
  },
  "deletedAt" : null,
  "name" : "First Last",
  "tenantId" : "74a69a21-ed9c-48cb-8880-4f3284eeb5d7",
  "type" : "UserIdentity"
}

Reset User Identity Mfa Settings

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

Authorization

This endpoint requires:

  • update-reset-mfa action on this user-identity resource.

Path parameters

Parameter Type Optional Description

id

Object

false

Response fields

No response body.

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/user-identities/4d076b65-ebb3-4853-8952-e5ae14633031/reset-mfa' -i -X PUT

Example response

HTTP/1.1 200 OK

Map Identity

POST /user-identities/{id}/mapping

Authorization

This endpoint requires:

  • create-identity-mapping action on this user-identity resource.

Path parameters

Parameter Type Optional Description

id

Object

false

Request fields

Path Type Optional Description

auth0UserId

String

true

identityProviderId

String

true

Response fields

No response body.

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/user-identities/c25d130f-ad9d-4d4c-beaa-ae257b5f07b5/mapping' -i -X POST \
    -H 'Content-Type: application/json' \
    -d '{
  "auth0UserId" : "new-auth0-userId:dcc10eea-65de-4f6b-8ee5-d8c5c6e7c9dd",
  "identityProviderId" : "baf0acbc-1766-4357-a996-d31c3f1c603a"
}'

Example response

HTTP/1.1 200 OK

API Account Identity

Find Api Account Identities

GET /api-account-identities

Authorization

This endpoint requires:

  • read action on this api-account-identity resource.

Query parameters

Supports standard paging query parameters.

Parameter Type Optional Description

tenantId

Object

true

Deprecated..

organizationId

Object

true

name

String

true

contactEmail

String

true

active

Boolean

true

includeDeleted

Boolean

true

Default value: 'false'.

provider

String

true

Must be one of [Auth0, Cognito].

Response fields

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

Path Type Optional Description

id

String

true

organizationId

String

true

auth0ClientId

String

true

awsCognitoClientId

String

true

authenticationUrl

String

true

name

String

true

contactEmail

String

true

description

String

true

active

Boolean

true

createdAt

Object

true

updatedAt

Object

true

deletedAt

Object

true

email

String

true

tenantId

String

true

Deprecated..

type

String

true

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/api-account-identities' -i -X GET

Example response

HTTP/1.1 200 OK
Link: <https://gateway.netFoundry.io/identity/v1/api-account-identities?page=1>; rel="next", <https://gateway.netFoundry.io/identity/v1/api-account-identities?page=2>; rel="last"
Content-Type: application/json
Content-Length: 2005

[ {
  "id" : "11bbe461-ce39-4f15-860d-e57edaf18786",
  "organizationId" : "74a69a21-ed9c-48cb-8880-4f3284eeb5d7",
  "auth0ClientId" : null,
  "awsCognitoClientId" : "aa1ab976-bd74-485b-9ca5-6f5371073338|haqfbvjn",
  "authenticationUrl" : "https://netfoundry-test-cyvklj.auth.us-east-1.amazoncognito.com/oauth2/token",
  "name" : "Testing Limits",
  "contactEmail" : "a@acme.com",
  "description" : "description",
  "active" : true,
  "createdAt" : {
    "nano" : 329736000,
    "epochSecond" : 1760045313
  },
  "updatedAt" : null,
  "deletedAt" : null,
  "email" : "a@acme.com",
  "tenantId" : "74a69a21-ed9c-48cb-8880-4f3284eeb5d7",
  "type" : "ApiAccountIdentity"
}, {
  "id" : "23427dc1-7ba8-4227-bb2d-5c49c125f76f",
  "organizationId" : "74a69a21-ed9c-48cb-8880-4f3284eeb5d7",
  "auth0ClientId" : null,
  "awsCognitoClientId" : "350805cd-b720-48f4-ba2e-418dddc1befb|rcbymmnb",
  "authenticationUrl" : "https://netfoundry-test-rggsgf.auth.us-east-1.amazoncognito.com/oauth2/token",
  "name" : "Testing Limits",
  "contactEmail" : "a@acme.com",
  "description" : "description",
  "active" : true,
  "createdAt" : {
    "nano" : 600808000,
    "epochSecond" : 1760045308
  },
  "updatedAt" : null,
  "deletedAt" : null,
  "email" : "a@acme.com",
  "tenantId" : "74a69a21-ed9c-48cb-8880-4f3284eeb5d7",
  "type" : "ApiAccountIdentity"
}, {
  "id" : "2b825098-3e03-4a04-94d8-2247ef6dd2ee",
  "organizationId" : "74a69a21-ed9c-48cb-8880-4f3284eeb5d7",
  "auth0ClientId" : null,
  "awsCognitoClientId" : "8e0cc2a0-3f75-4143-9273-dafacc798c66|dcehtwgl",
  "authenticationUrl" : "https://netfoundry-test-fwoqmp.auth.us-east-1.amazoncognito.com/oauth2/token",
  "name" : "Testing Limits",
  "contactEmail" : "a@acme.com",
  "description" : "description",
  "active" : true,
  "createdAt" : {
    "nano" : 10636000,
    "epochSecond" : 1760045311
  },
  "updatedAt" : null,
  "deletedAt" : null,
  "email" : "a@acme.com",
  "tenantId" : "74a69a21-ed9c-48cb-8880-4f3284eeb5d7",
  "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}}

Authorization

This endpoint requires:

  • read action on this api-account-identity resource.

Path parameters

Parameter Type Optional Description

id

Object

false

Response fields

Path Type Optional Description

id

String

true

organizationId

String

true

auth0ClientId

String

true

awsCognitoClientId

String

true

authenticationUrl

String

true

name

String

true

contactEmail

String

true

description

String

true

active

Boolean

true

createdAt

Object

true

updatedAt

Object

true

deletedAt

Object

true

email

String

true

tenantId

String

true

Deprecated..

type

String

true

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/api-account-identities/3f15c2b9-27e4-408d-b31e-b4bb43c53768' -i -X GET

Example response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 718

{
  "id" : "3f15c2b9-27e4-408d-b31e-b4bb43c53768",
  "organizationId" : "74a69a21-ed9c-48cb-8880-4f3284eeb5d7",
  "auth0ClientId" : "79c48525-b181-4422-8622-9e407b63c137",
  "awsCognitoClientId" : null,
  "authenticationUrl" : "http://127.0.0.1:1234/IdP/OAuth2/login",
  "name" : "api-account",
  "contactEmail" : "no-reply@acme.com",
  "description" : "This is an ACME non-interactive API client.",
  "active" : true,
  "createdAt" : {
    "nano" : 268795000,
    "epochSecond" : 1760045302
  },
  "updatedAt" : {
    "nano" : 255613000,
    "epochSecond" : 1760045304
  },
  "deletedAt" : null,
  "email" : "no-reply@acme.com",
  "tenantId" : "74a69a21-ed9c-48cb-8880-4f3284eeb5d7",
  "type" : "ApiAccountIdentity"
}

Get Api Account Identity By Mapping

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

Authorization

This endpoint requires:

  • read action on this api-account-identity resource.

Path parameters

Parameter Type Optional Description

clientId

String

false

Response fields

Path Type Optional Description

id

String

true

organizationId

String

true

auth0ClientId

String

true

awsCognitoClientId

String

true

authenticationUrl

String

true

name

String

true

contactEmail

String

true

description

String

true

active

Boolean

true

createdAt

Object

true

updatedAt

Object

true

deletedAt

Object

true

email

String

true

tenantId

String

true

Deprecated..

type

String

true

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/api-account-identities/mapping/9d4b7eeb-939e-4aee-b742-054be55b5acc' -i -X GET

Example response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 682

{
  "id" : "dcdeb302-1bc2-44d4-badb-a63628f7fe15",
  "organizationId" : "74a69a21-ed9c-48cb-8880-4f3284eeb5d7",
  "auth0ClientId" : "9d4b7eeb-939e-4aee-b742-054be55b5acc",
  "awsCognitoClientId" : null,
  "authenticationUrl" : "http://127.0.0.1:1234/IdP/OAuth2/login",
  "name" : "ACME Internal Service-31",
  "contactEmail" : "service.admin-32@foo.com",
  "description" : "updatable API Account description-33",
  "active" : true,
  "createdAt" : {
    "nano" : 893486000,
    "epochSecond" : 1760045341
  },
  "updatedAt" : null,
  "deletedAt" : null,
  "email" : "service.admin-32@foo.com",
  "tenantId" : "74a69a21-ed9c-48cb-8880-4f3284eeb5d7",
  "type" : "ApiAccountIdentity"
}

Create Api Account Identity

POST /api-account-identities

Authorization

This endpoint requires:

  • create action on this api-account-identity resource.

Request fields

Path Type Optional Description

organizationId

String

true

name

String

true

contactEmail

String

true

description

String

true

grantDefaultRoles

Boolean

true

provider

String

true

Must be one of [Auth0, Cognito].

Response fields

Path Type Optional Description

apiAccountIdentity

Object

true

apiAccountIdentity.id

String

true

apiAccountIdentity.organizationId

String

true

apiAccountIdentity.auth0ClientId

String

true

apiAccountIdentity.awsCognitoClientId

String

true

apiAccountIdentity.authenticationUrl

String

true

apiAccountIdentity.name

String

true

apiAccountIdentity.contactEmail

String

true

apiAccountIdentity.description

String

true

apiAccountIdentity.active

Boolean

true

apiAccountIdentity.createdAt

Object

true

apiAccountIdentity.updatedAt

Object

true

apiAccountIdentity.deletedAt

Object

true

apiAccountIdentity.email

String

true

apiAccountIdentity.tenantId

String

true

Deprecated..

apiAccountIdentity.type

String

true

clientId

String

true

password

String

true

authenticationUrl

String

true

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/api-account-identities' -i -X POST \
    -H 'Content-Type: application/json' \
    -d '{
  "organizationId" : "74a69a21-ed9c-48cb-8880-4f3284eeb5d7",
  "name" : "HR Bridge Service",
  "contactEmail" : "hr.director@acme.com",
  "description" : "description goes here",
  "grantDefaultRoles" : true,
  "provider" : "Cognito"
}'

Example response

HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 940

{
  "apiAccountIdentity" : {
    "id" : "5468ca36-abc8-49df-9194-afb9d258431c",
    "organizationId" : "74a69a21-ed9c-48cb-8880-4f3284eeb5d7",
    "auth0ClientId" : null,
    "awsCognitoClientId" : "350805cd-b720-48f4-ba2e-418dddc1befb|qvohgtbl",
    "authenticationUrl" : "https://netfoundry-test-rggsgf.auth.us-east-1.amazoncognito.com/oauth2/token",
    "name" : "HR Bridge Service",
    "contactEmail" : "hr.director@acme.com",
    "description" : "description goes here",
    "active" : true,
    "createdAt" : {
      "nano" : 302106000,
      "epochSecond" : 1760045308
    },
    "updatedAt" : null,
    "deletedAt" : null,
    "email" : "hr.director@acme.com",
    "tenantId" : "74a69a21-ed9c-48cb-8880-4f3284eeb5d7",
    "type" : "ApiAccountIdentity"
  },
  "clientId" : "qvohgtbl",
  "password" : "lpiuvhxrxtwchgwdwvbsskdh",
  "authenticationUrl" : "https://netfoundry-test-rggsgf.auth.us-east-1.amazoncognito.com/oauth2/token"
}

Update Identity Info

PUT /api-account-identities/{id}

Authorization

This endpoint requires:

  • update action on this api-account-identity resource.

Path parameters

Parameter Type Optional Description

id

Object

false

Request fields

Path Type Optional Description

name

String

true

contactEmail

String

true

description

String

true

Response fields

Path Type Optional Description

id

String

true

organizationId

String

true

auth0ClientId

String

true

awsCognitoClientId

String

true

authenticationUrl

String

true

name

String

true

contactEmail

String

true

description

String

true

active

Boolean

true

createdAt

Object

true

updatedAt

Object

true

deletedAt

Object

true

email

String

true

tenantId

String

true

Deprecated..

type

String

true

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/api-account-identities/890a1f73-55b6-4a44-bf19-e2fbcd6b8411' -i -X PUT \
    -H 'Content-Type: application/json' \
    -d '{
  "name" : "Robot",
  "contactEmail" : "robot@acme.com",
  "description" : "description here."
}'

Example response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 680

{
  "id" : "890a1f73-55b6-4a44-bf19-e2fbcd6b8411",
  "organizationId" : "74a69a21-ed9c-48cb-8880-4f3284eeb5d7",
  "auth0ClientId" : "37af5a9b-5ca0-49e5-ad42-81ba188b1efb",
  "awsCognitoClientId" : null,
  "authenticationUrl" : "http://127.0.0.1:1234/IdP/OAuth2/login",
  "name" : "Robot",
  "contactEmail" : "robot@acme.com",
  "description" : "description here.",
  "active" : true,
  "createdAt" : {
    "nano" : 303850000,
    "epochSecond" : 1760045302
  },
  "updatedAt" : {
    "nano" : 105168000,
    "epochSecond" : 1760045303
  },
  "deletedAt" : null,
  "email" : "robot@acme.com",
  "tenantId" : "74a69a21-ed9c-48cb-8880-4f3284eeb5d7",
  "type" : "ApiAccountIdentity"
}

Activate Or Deactivate Api Account Identity

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

Authorization

This endpoint requires:

  • update-active action on this api-account-identity resource.

Path parameters

Parameter Type Optional Description

id

Object

false

action

String

false

Response fields

Path Type Optional Description

id

String

true

organizationId

String

true

auth0ClientId

String

true

awsCognitoClientId

String

true

authenticationUrl

String

true

name

String

true

contactEmail

String

true

description

String

true

active

Boolean

true

createdAt

Object

true

updatedAt

Object

true

deletedAt

Object

true

email

String

true

tenantId

String

true

Deprecated..

type

String

true

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/api-account-identities/1b8b4386-7c71-4419-9988-9d8f01abfdcc/deactivate' -i -X PUT

Example response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 739

{
  "id" : "1b8b4386-7c71-4419-9988-9d8f01abfdcc",
  "organizationId" : "74a69a21-ed9c-48cb-8880-4f3284eeb5d7",
  "auth0ClientId" : "b9d9a220-3bdc-4d99-848a-6a5899b584ff",
  "awsCognitoClientId" : null,
  "authenticationUrl" : "http://127.0.0.1:1234/IdP/OAuth2/login",
  "name" : "ACME Internal Service-25",
  "contactEmail" : "service.admin-26@foo.com",
  "description" : "updatable API Account description-27",
  "active" : false,
  "createdAt" : {
    "nano" : 678983000,
    "epochSecond" : 1760045341
  },
  "updatedAt" : {
    "nano" : 716005000,
    "epochSecond" : 1760045341
  },
  "deletedAt" : null,
  "email" : "service.admin-26@foo.com",
  "tenantId" : "74a69a21-ed9c-48cb-8880-4f3284eeb5d7",
  "type" : "ApiAccountIdentity"
}

Invitation

Find Invitations

GET /invitations

Authorization

This endpoint requires:

  • read action on this invitation resource.

Query parameters

Supports standard paging query parameters.

Parameter Type Optional Description

fromIdentityId

Object

true

toTenantId

Object

true

Deprecated..

toOrganizationId

Object

true

invitedEmailAddress

String

true

targetIdentityId

Object

true

states

Object

true

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

Response fields

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

Path Type Optional Description

id

String

true

fromIdentityId

String

true

toOrganizationId

String

true

invitedEmailAddress

String

true

expiration

Object

true

targetUserIdentityId

String

true

accepted

Boolean

true

revokedAt

Object

true

responseReceivedAt

Object

true

state

String

true

toTenantId

String

true

Deprecated..

Example request

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

Example response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 527

[ {
  "id" : "0c9abdc1-7ea2-47b0-8e34-2d9d42721da2",
  "fromIdentityId" : "04d79ca4-9060-45d6-89a6-86787c14519e",
  "toOrganizationId" : "74a69a21-ed9c-48cb-8880-4f3284eeb5d7",
  "invitedEmailAddress" : "new.employee@acme.com",
  "expiration" : {
    "nano" : 191816000,
    "epochSecond" : 1760650155
  },
  "targetUserIdentityId" : "2c831eca-4600-4648-bffe-297ab751af77",
  "accepted" : null,
  "revokedAt" : null,
  "responseReceivedAt" : null,
  "state" : "Open",
  "toTenantId" : "74a69a21-ed9c-48cb-8880-4f3284eeb5d7"
} ]

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

This endpoint requires:

  • read action on this invitation resource.

Path parameters

Parameter Type Optional Description

id

Object

false

Response fields

Path Type Optional Description

id

String

true

fromIdentityId

String

true

toOrganizationId

String

true

invitedEmailAddress

String

true

expiration

Object

true

targetUserIdentityId

String

true

accepted

Boolean

true

revokedAt

Object

true

responseReceivedAt

Object

true

state

String

true

toTenantId

String

true

Deprecated..

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/invitations/964182ea-077a-4efb-82db-21e67f2f35e8' -i -X GET

Example response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 527

{
  "id" : "964182ea-077a-4efb-82db-21e67f2f35e8",
  "fromIdentityId" : "0e29c7b6-0dc9-4d05-8cd0-ccb651cebeb8",
  "toOrganizationId" : "74a69a21-ed9c-48cb-8880-4f3284eeb5d7",
  "invitedEmailAddress" : "new.employee-236@acme.com",
  "expiration" : {
    "nano" : 729034000,
    "epochSecond" : 1760650155
  },
  "targetUserIdentityId" : "b550a6dd-9abf-4180-9d96-3b76e7c63a4c",
  "accepted" : null,
  "revokedAt" : null,
  "responseReceivedAt" : null,
  "state" : "Open",
  "toTenantId" : "74a69a21-ed9c-48cb-8880-4f3284eeb5d7"
}

Create Invitation

POST /invitations

Authorization

This endpoint requires:

  • create action on this invitation resource.

  • read action on the user-identity resource identified by the targetUserIdentityId property.

Request fields

Path Type Optional Description

toOrganizationId

String

true

invitedEmailAddress

String

true

invitationUrl

String

true

targetUserIdentityId

String

true

brandingOrganizationId

String

true

Response fields

Path Type Optional Description

id

String

true

fromIdentityId

String

true

toOrganizationId

String

true

invitedEmailAddress

String

true

expiration

Object

true

targetUserIdentityId

String

true

accepted

Boolean

true

revokedAt

Object

true

responseReceivedAt

Object

true

state

String

true

toTenantId

String

true

Deprecated..

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/invitations' -i -X POST \
    -H 'Content-Type: application/json' \
    -d '{
  "toOrganizationId" : "74a69a21-ed9c-48cb-8880-4f3284eeb5d7",
  "invitedEmailAddress" : "new.employee@acme.com",
  "invitationUrl" : "http://acme.console.netfoundry.io/invitation",
  "targetUserIdentityId" : "2c831eca-4600-4648-bffe-297ab751af77",
  "brandingOrganizationId" : null
}'

Example response

HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 523

{
  "id" : "0c9abdc1-7ea2-47b0-8e34-2d9d42721da2",
  "fromIdentityId" : "04d79ca4-9060-45d6-89a6-86787c14519e",
  "toOrganizationId" : "74a69a21-ed9c-48cb-8880-4f3284eeb5d7",
  "invitedEmailAddress" : "new.employee@acme.com",
  "expiration" : {
    "nano" : 191816000,
    "epochSecond" : 1760650155
  },
  "targetUserIdentityId" : "2c831eca-4600-4648-bffe-297ab751af77",
  "accepted" : null,
  "revokedAt" : null,
  "responseReceivedAt" : null,
  "state" : "Open",
  "toTenantId" : "74a69a21-ed9c-48cb-8880-4f3284eeb5d7"
}

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}

Authorization

This endpoint requires:

  • update-respond action on this invitation resource.

Path parameters

Parameter Type Optional Description

id

Object

false

action

String

false

Response fields

Path Type Optional Description

id

String

true

fromIdentityId

String

true

toOrganizationId

String

true

invitedEmailAddress

String

true

expiration

Object

true

targetUserIdentityId

String

true

accepted

Boolean

true

revokedAt

Object

true

responseReceivedAt

Object

true

state

String

true

toTenantId

String

true

Deprecated..

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/invitations/227787e9-9fb2-48f5-9fa7-d0a3a2d3aeb2/decline' -i -X PUT

Example response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 588

{
  "id" : "227787e9-9fb2-48f5-9fa7-d0a3a2d3aeb2",
  "fromIdentityId" : "0e29c7b6-0dc9-4d05-8cd0-ccb651cebeb8",
  "toOrganizationId" : "74a69a21-ed9c-48cb-8880-4f3284eeb5d7",
  "invitedEmailAddress" : "new.employee-233@acme.com",
  "expiration" : {
    "nano" : 638110000,
    "epochSecond" : 1760650155
  },
  "targetUserIdentityId" : "1adc5a3d-df6a-41a4-abd1-be2626a4fed5",
  "accepted" : false,
  "revokedAt" : null,
  "responseReceivedAt" : {
    "nano" : 664991000,
    "epochSecond" : 1760045355
  },
  "state" : "Declined",
  "toTenantId" : "74a69a21-ed9c-48cb-8880-4f3284eeb5d7"
}

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

Authorization

This endpoint requires:

  • update-revoke action on this invitation resource.

Path parameters

Parameter Type Optional Description

id

Object

false

Response fields

Path Type Optional Description

id

String

true

fromIdentityId

String

true

toOrganizationId

String

true

invitedEmailAddress

String

true

expiration

Object

true

targetUserIdentityId

String

true

accepted

Boolean

true

revokedAt

Object

true

responseReceivedAt

Object

true

state

String

true

toTenantId

String

true

Deprecated..

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/invitations/7ae6895d-8a76-4677-9aae-f7fb548e868e/revoke' -i -X PUT

Example response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 642

{
  "id" : "7ae6895d-8a76-4677-9aae-f7fb548e868e",
  "fromIdentityId" : "0e29c7b6-0dc9-4d05-8cd0-ccb651cebeb8",
  "toOrganizationId" : "74a69a21-ed9c-48cb-8880-4f3284eeb5d7",
  "invitedEmailAddress" : "new.employee-239@acme.com",
  "expiration" : {
    "nano" : 792810000,
    "epochSecond" : 1760650155
  },
  "targetUserIdentityId" : "66203800-9c24-4ac8-9364-e588dadeb7ac",
  "accepted" : null,
  "revokedAt" : {
    "nano" : 805675000,
    "epochSecond" : 1760045355
  },
  "responseReceivedAt" : {
    "nano" : 805679000,
    "epochSecond" : 1760045355
  },
  "state" : "Revoked",
  "toTenantId" : "74a69a21-ed9c-48cb-8880-4f3284eeb5d7"
}

Support

Create Support Request

POST /nfconsole/support/requests

Authorization

Authorization not required for this request.

Request fields

Path Type Optional Description

name

String

true

email

String

true

selectedOrganizationId

String

true

selectedNetworkId

String

true

subject

String

true

comment

String

true

type

String

true

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

priority

String

true

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

severity

String

true

Must be one of [Severity1, Severity2, Severity3].

recentErrorMessages

Array[String]

true

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",
  "severity" : "Severity3",
  "recentErrorMessages" : null
}'

Example response

HTTP/1.1 200 OK

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

Response fields

Path Type Optional Description

fromIdentity

Object

true

fromIdentity.name

String

true

fromIdentity.email

String

true

targetIdentity

Object

true

targetIdentity.name

String

true

targetIdentity.email

String

true

invitedEmailAddress

String

true

toOrganizationName

String

true

toOrganizationLabel

String

true

expiration

Object

true

accepted

Boolean

true

state

String

true

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/IZ0wxk7DrkzRyrS7rucnHLBHeF7xekiLRR7s' -i -X GET

Example response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 519

{
  "fromIdentity" : {
    "name" : "John Doe",
    "email" : "john.doe@acme.com"
  },
  "targetIdentity" : {
    "name" : "First Last",
    "email" : "random-246@acme.com"
  },
  "invitedEmailAddress" : "new.employee-248@acme.com",
  "toOrganizationName" : "ACME International, Inc.",
  "toOrganizationLabel" : "ACME-2",
  "expiration" : {
    "nano" : 207066000,
    "epochSecond" : 1760650156
  },
  "accepted" : null,
  "state" : "Open",
  "toTenantName" : "ACME International, Inc.",
  "toTenantLabel" : "ACME-2"
}

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

Response fields

Path Type Optional Description

fromIdentity

Object

true

fromIdentity.name

String

true

fromIdentity.email

String

true

targetIdentity

Object

true

targetIdentity.name

String

true

targetIdentity.email

String

true

invitedEmailAddress

String

true

toOrganizationName

String

true

toOrganizationLabel

String

true

expiration

Object

true

accepted

Boolean

true

state

String

true

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/6IMtUtJXm5l1Z4b2DycZ6X4LdbpezXIm9GuW/decline' -i -X PUT

Example response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 524

{
  "fromIdentity" : {
    "name" : "John Doe",
    "email" : "john.doe@acme.com"
  },
  "targetIdentity" : {
    "name" : "First Last",
    "email" : "random-243@acme.com"
  },
  "invitedEmailAddress" : "new.employee-245@acme.com",
  "toOrganizationName" : "ACME International, Inc.",
  "toOrganizationLabel" : "ACME-2",
  "expiration" : {
    "nano" : 107277000,
    "epochSecond" : 1760650156
  },
  "accepted" : false,
  "state" : "Declined",
  "toTenantName" : "ACME International, Inc.",
  "toTenantLabel" : "ACME-2"
}

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

Request fields

Path Type Optional Description

intermediateReturnUrl

String

true

Response fields

Path Type Optional Description

nfToken

String

true

auth0ConnectionIds

Array[String]

true

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/invitations/key/cMf1DttPHzKTFPES5jRkHASvexaQkpjW4tZk/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
Content-Length: 981

{
  "nfToken" : "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJpYXQiOjE3NjAwNDUzNTUsImV4cCI6MTc2MDA0NjI1NSwiaXNzIjoiaHR0cDovL2xvY2FsaG9zdDo4MDgwL2lkZW50aXR5L3YxIiwiYXVkIjoiaHR0cHM6Ly9uZXRmb3VuZHJ5LXNhbmRib3guYXV0aDAuY29tLyIsImZsb3ciOiJpbnZpdGF0aW9uIiwiaW52aXRhdGlvbklkIjoiYjQ3N2Y3YTMtNTNlMi00ZTM4LWFkN2MtYzZhM2JiZmM2NWM1IiwidGVuYW50TGFiZWwiOiJBQ01FLTIiLCJhdXRoMENvbm5lY3Rpb25JZHMiOlsiYXV0aDAtb3BhcXVlLWNvbm5lY3Rpb25JZC0zIiwiYXV0aDAtb3BhcXVlLWNvbm5lY3Rpb25JZC00Il0sInJlZGlyZWN0VXJsIjoiaHR0cDovL2NvbnNvbGUubmZhZG1pbi5uZXRmb3VuZHJ5LmlvL2ludml0YXRpb24ifQ.ke8i9jw2X4OossO8IYoD5GEZ2z5bDwlJbCwDDIXtHeR-rFzPWrmlJtj3OwivdFKbC-XgoEE2BakjNY604RmNj6SMrqoZp89HkRd3Rz1xifMbsf-QYuWvItaDejlJ_YiN8D_hzJU3AWAlzM8lZXSEG58o8gjj8Qaf1kfdv9it4RuI9tIbCsef9-kl1mma46zWpwWHd80u5D3ge1SLfEbkqnBRY7F3hMAtfRKXzEgRFHEvyNHoNpClRv-MUMOYjcMTulPHhIk8V4SBwlzalIJvq22QFR8Leq__z3A6iUvpKbcVopX0cKfbdW58z1GjryBV3eQ308TfzJGER_5r-zEcvA",
  "auth0ConnectionIds" : [ "auth0-opaque-connectionId-3", "auth0-opaque-connectionId-4" ]
}

Login Flow

Initiate Interactive Authorization

POST /organizations/authorize-initiate

Authorization

Authorization not required for this request.

Request fields

Path Type Optional Description

realmLabel

String

true

label

String

true

intermediateReturnUrl

String

true

Response fields

Path Type Optional Description

nfToken

String

true

auth0ConnectionIds

Array[String]

true

Example request

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

Example response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 902

{
  "nfToken" : "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJpYXQiOjE3NjAwNDUzNTYsImV4cCI6MTc2MDA0NjI1NiwiaXNzIjoiaHR0cDovL2xvY2FsaG9zdDo4MDgwL2lkZW50aXR5L3YxIiwiYXVkIjoiaHR0cHM6Ly9uZXRmb3VuZHJ5LXNhbmRib3guYXV0aDAuY29tLyIsImZsb3ciOiJsb2dpbiIsInRlbmFudExhYmVsIjoiQUNNRS0yIiwiYXV0aDBDb25uZWN0aW9uSWRzIjpbImF1dGgwLW9wYXF1ZS1jb25uZWN0aW9uSWQtMyIsImF1dGgwLW9wYXF1ZS1jb25uZWN0aW9uSWQtNCJdLCJyZWRpcmVjdFVybCI6Imh0dHA6Ly9jb25zb2xlLm5mYWRtaW4ubmV0Zm91bmRyeS5pby9pbnZpdGF0aW9uIn0.ieBfgFEQIA8V-kaDj-QT4c54xw5j5wgdyQzIe6Z3St02QOZ7cvoeRheccmSU8iJ6QnyjvUyi3-betxz8dY2wk2UYKt44LMH2fZIj8r2-q9ZFOn5cPWN2WxcVOjA0qU65nFJZ8UQIr3Rd2rcogvZm-blQbA6tv_hQ1xDQI0I_haT2i1LFgt0gAz7pwaYgqcNOfXb-BgWEL0wYfHO6DMr83OVDWfcY4xrxzfI5MfT0IOkX1ucRBAPECUfLMzVbOxu52mKVALlr7wI9swZQCo9j1irdqnJjkxmxcPu7JSDXa59LqDBL4j80hfle5PLxIuEVuHI7bf2G6zbrE9o8rTcQrg",
  "auth0ConnectionIds" : [ "auth0-opaque-connectionId-3", "auth0-opaque-connectionId-4" ]
}

Identity Preference Flow

Find Identity Preferences

GET /identity-preferences

Authorization

This endpoint requires:

  • read action on this identity-preference resource.

Response fields

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

Path Type Optional Description

id

String

true

userIdentityId

String

true

preferences

Object

true

createdBy

String

true

createdAt

Object

true

updatedAt

Object

true

deletedBy

String

true

deletedAt

Object

true

Example request

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

Example response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 1296

[ {
  "id" : "1de5a92e-3e34-4189-a6be-81fdc39e5ad8",
  "userIdentityId" : "4f0332bc-feb1-49c6-aa6e-2f616788de1c",
  "preferences" : {
    "first" : "my first preference."
  },
  "createdBy" : "4f0332bc-feb1-49c6-aa6e-2f616788de1c",
  "createdAt" : {
    "nano" : 31795000,
    "epochSecond" : 1760045351
  },
  "updatedAt" : {
    "nano" : 31795000,
    "epochSecond" : 1760045351
  },
  "deletedBy" : null,
  "deletedAt" : null
}, {
  "id" : "2ad8627f-ac55-4e02-9d43-f57ec5d4d5c2",
  "userIdentityId" : "f64a4332-bb69-4496-ac00-d5a5242395ce",
  "preferences" : {
    "first" : "my first preference."
  },
  "createdBy" : "f64a4332-bb69-4496-ac00-d5a5242395ce",
  "createdAt" : {
    "nano" : 155850000,
    "epochSecond" : 1760045351
  },
  "updatedAt" : {
    "nano" : 155850000,
    "epochSecond" : 1760045351
  },
  "deletedBy" : null,
  "deletedAt" : null
}, {
  "id" : "a6b99d7f-79d6-46c5-b409-88c27bac2916",
  "userIdentityId" : "8ec09230-9f95-4277-8113-8280bfeed05e",
  "preferences" : {
    "first" : "my first preference."
  },
  "createdBy" : "8ec09230-9f95-4277-8113-8280bfeed05e",
  "createdAt" : {
    "nano" : 232394000,
    "epochSecond" : 1760045351
  },
  "updatedAt" : {
    "nano" : 232394000,
    "epochSecond" : 1760045351
  },
  "deletedBy" : null,
  "deletedAt" : null
} ]

Get Identity Preference

GET /identity-preferences/{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

This endpoint requires:

  • read action on this identity-preference resource.

Path parameters

Parameter Type Optional Description

id

Object

false

Response fields

Path Type Optional Description

id

String

true

userIdentityId

String

true

preferences

Object

true

createdBy

String

true

createdAt

Object

true

updatedAt

Object

true

deletedBy

String

true

deletedAt

Object

true

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/identity-preferences/eff4296c-6a22-49b5-af36-d48b516680a6' -i -X GET

Example response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 415

{
  "id" : "eff4296c-6a22-49b5-af36-d48b516680a6",
  "userIdentityId" : "f2dd290d-4950-4750-97ce-b98687099666",
  "preferences" : {
    "hello" : "world"
  },
  "createdBy" : "f2dd290d-4950-4750-97ce-b98687099666",
  "createdAt" : {
    "nano" : 936270000,
    "epochSecond" : 1760045352
  },
  "updatedAt" : {
    "nano" : 936270000,
    "epochSecond" : 1760045352
  },
  "deletedBy" : null,
  "deletedAt" : null
}

Upsert Identity Preference

POST /identity-preferences

Authorization

This endpoint requires no specific permission, only an authenticated client.

Request fields

Path Type Optional Description

userIdentityId

String

true

preferences

Object

true

Response fields

Path Type Optional Description

id

String

true

userIdentityId

String

true

preferences

Object

true

createdBy

String

true

createdAt

Object

true

updatedAt

Object

true

deletedBy

String

true

deletedAt

Object

true

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/identity-preferences' -i -X POST \
    -H 'Content-Type: application/json' \
    -d '{
  "userIdentityId" : null,
  "preferences" : {
    "first" : "my first preference."
  }
}'

Example response

HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 430

{
  "id" : "9f5785b3-1192-4465-a4cb-b040ab107269",
  "userIdentityId" : "4cfa5b67-ff0c-4d8a-979e-8861b8ff41a2",
  "preferences" : {
    "first" : "my first preference."
  },
  "createdBy" : "4cfa5b67-ff0c-4d8a-979e-8861b8ff41a2",
  "createdAt" : {
    "nano" : 832825000,
    "epochSecond" : 1760045351
  },
  "updatedAt" : {
    "nano" : 832825000,
    "epochSecond" : 1760045351
  },
  "deletedBy" : null,
  "deletedAt" : null
}

Upsert Identity Preference By Id

PUT /identity-preferences/{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

This endpoint requires:

  • create action on this identity-preference resource.

  • update action on this identity-preference resource.

Path parameters

Parameter Type Optional Description

id

Object

false

Request fields

Path Type Optional Description

userIdentityId

String

true

preferences

Object

true

Response fields

Path Type Optional Description

id

String

true

userIdentityId

String

true

preferences

Object

true

createdBy

String

true

createdAt

Object

true

updatedAt

Object

true

deletedBy

String

true

deletedAt

Object

true

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/identity-preferences/bb58be45-927e-4c93-af52-d0c1b24a6586' -i -X PUT \
    -H 'Content-Type: application/json' \
    -d '{
  "preferences" : {
    "updated" : "my second preference."
  }
}'

Example response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 433

{
  "id" : "bb58be45-927e-4c93-af52-d0c1b24a6586",
  "userIdentityId" : "21306b7f-d9f4-4a8e-a6d3-37781e92bb01",
  "preferences" : {
    "updated" : "my second preference."
  },
  "createdBy" : "21306b7f-d9f4-4a8e-a6d3-37781e92bb01",
  "createdAt" : {
    "nano" : 829139000,
    "epochSecond" : 1760045353
  },
  "updatedAt" : {
    "nano" : 843569000,
    "epochSecond" : 1760045353
  },
  "deletedBy" : null,
  "deletedAt" : null
}

Delete Identity Preference By Id

DELETE /identity-preferences/{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

This endpoint requires:

  • delete action on this identity-preference resource.

Path parameters

Parameter Type Optional Description

id

Object

false

Response fields

Path Type Optional Description

id

String

true

userIdentityId

String

true

preferences

Object

true

createdBy

String

true

createdAt

Object

true

updatedAt

Object

true

deletedBy

String

true

deletedAt

Object

true

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/identity-preferences/63c5a7cc-05fa-491b-9373-2c2cd9559ea8' -i -X DELETE

Example response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 505

{
  "id" : "63c5a7cc-05fa-491b-9373-2c2cd9559ea8",
  "userIdentityId" : "00b5f87e-bffd-4581-b5c7-5b5029c18aa7",
  "preferences" : {
    "hello" : "world"
  },
  "createdBy" : "00b5f87e-bffd-4581-b5c7-5b5029c18aa7",
  "createdAt" : {
    "nano" : 273884000,
    "epochSecond" : 1760045352
  },
  "updatedAt" : {
    "nano" : 285486000,
    "epochSecond" : 1760045352
  },
  "deletedBy" : "99d16481-b8e9-4b73-8acb-f2b730b5d336",
  "deletedAt" : {
    "nano" : 285000000,
    "epochSecond" : 1760045352
  }
}

Organization Preference Flow

Find Organization Preferences

GET /organization-preferences

Authorization

This endpoint requires:

  • read action on this organization-preference resource.

Response fields

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

Path Type Optional Description

id

String

true

organizationId

String

true

preferences

Object

true

createdBy

String

true

createdAt

Object

true

updatedAt

Object

true

deletedBy

String

true

deletedAt

Object

true

Example request

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

Example response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 1266

[ {
  "id" : "c41276e3-d0d5-4c34-865f-2b499fd2ef3a",
  "organizationId" : "1b37e87a-05c8-4064-8089-db633d24f5b9",
  "preferences" : {
    "hello" : "world"
  },
  "createdBy" : "c313f6ba-ae3f-4169-a230-bee22a960166",
  "createdAt" : {
    "nano" : 916293000,
    "epochSecond" : 1760045361
  },
  "updatedAt" : {
    "nano" : 916293000,
    "epochSecond" : 1760045361
  },
  "deletedBy" : null,
  "deletedAt" : null
}, {
  "id" : "c72aebd7-a5bb-4a19-8c8a-dd645ff9e966",
  "organizationId" : "da8b9257-a182-473f-8786-a5a1f9f8d458",
  "preferences" : {
    "hello" : "world"
  },
  "createdBy" : "9515d235-c840-4e19-a696-d007efe996be",
  "createdAt" : {
    "nano" : 162537000,
    "epochSecond" : 1760045362
  },
  "updatedAt" : {
    "nano" : 162537000,
    "epochSecond" : 1760045362
  },
  "deletedBy" : null,
  "deletedAt" : null
}, {
  "id" : "fd9be56b-240b-4798-8de5-bbc2271003fe",
  "organizationId" : "8913b812-4a70-4e19-abe3-85a4dbb0a71e",
  "preferences" : {
    "first" : "my first preference."
  },
  "createdBy" : "959b268a-4670-4186-b77a-9cfd36479d08",
  "createdAt" : {
    "nano" : 59831000,
    "epochSecond" : 1760045362
  },
  "updatedAt" : {
    "nano" : 59831000,
    "epochSecond" : 1760045362
  },
  "deletedBy" : null,
  "deletedAt" : null
} ]

Get Organization Preference

GET /organization-preferences/{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

This endpoint requires:

  • read action on this organization-preference resource.

Path parameters

Parameter Type Optional Description

id

Object

false

Response fields

Path Type Optional Description

id

String

true

organizationId

String

true

preferences

Object

true

createdBy

String

true

createdAt

Object

true

updatedAt

Object

true

deletedBy

String

true

deletedAt

Object

true

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/organization-preferences/c72aebd7-a5bb-4a19-8c8a-dd645ff9e966' -i -X GET

Example response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 415

{
  "id" : "c72aebd7-a5bb-4a19-8c8a-dd645ff9e966",
  "organizationId" : "da8b9257-a182-473f-8786-a5a1f9f8d458",
  "preferences" : {
    "hello" : "world"
  },
  "createdBy" : "9515d235-c840-4e19-a696-d007efe996be",
  "createdAt" : {
    "nano" : 162537000,
    "epochSecond" : 1760045362
  },
  "updatedAt" : {
    "nano" : 162537000,
    "epochSecond" : 1760045362
  },
  "deletedBy" : null,
  "deletedAt" : null
}

Create Organization Preference

POST /organization-preferences

Authorization

This endpoint requires:

  • create action on this organization-preference resource.

Request fields

Path Type Optional Description

organizationId

String

true

preferences

Object

true

Response fields

Path Type Optional Description

id

String

true

organizationId

String

true

preferences

Object

true

createdBy

String

true

createdAt

Object

true

updatedAt

Object

true

deletedBy

String

true

deletedAt

Object

true

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/organization-preferences' -i -X POST \
    -H 'Content-Type: application/json' \
    -d '{
  "organizationId" : "8913b812-4a70-4e19-abe3-85a4dbb0a71e",
  "preferences" : {
    "first" : "my first preference."
  }
}'

Example response

HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 428

{
  "id" : "fd9be56b-240b-4798-8de5-bbc2271003fe",
  "organizationId" : "8913b812-4a70-4e19-abe3-85a4dbb0a71e",
  "preferences" : {
    "first" : "my first preference."
  },
  "createdBy" : "959b268a-4670-4186-b77a-9cfd36479d08",
  "createdAt" : {
    "nano" : 59831000,
    "epochSecond" : 1760045362
  },
  "updatedAt" : {
    "nano" : 59831000,
    "epochSecond" : 1760045362
  },
  "deletedBy" : null,
  "deletedAt" : null
}

Update Organization Preference

PUT /organization-preferences/{id}

Authorization

This endpoint requires:

  • update action on this organization-preference resource.

Path parameters

Parameter Type Optional Description

id

Object

false

Request fields

Path Type Optional Description

preferences

Object

true

Response fields

Path Type Optional Description

id

String

true

organizationId

String

true

preferences

Object

true

createdBy

String

true

createdAt

Object

true

updatedAt

Object

true

deletedBy

String

true

deletedAt

Object

true

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/organization-preferences/01edee89-265d-4763-8fbc-9af11e9eb558' -i -X PUT \
    -H 'Content-Type: application/json' \
    -d '{
  "preferences" : {
    "updated" : "my second preference."
  }
}'

Example response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 433

{
  "id" : "01edee89-265d-4763-8fbc-9af11e9eb558",
  "organizationId" : "1441fa36-9ccb-4899-a313-70f41bb1158e",
  "preferences" : {
    "updated" : "my second preference."
  },
  "createdBy" : "5ff18c94-1691-4c1f-ad6e-aef25ed5e766",
  "createdAt" : {
    "nano" : 329691000,
    "epochSecond" : 1760045362
  },
  "updatedAt" : {
    "nano" : 344871000,
    "epochSecond" : 1760045362
  },
  "deletedBy" : null,
  "deletedAt" : null
}

Delete Organization Preference

DELETE /organization-preferences/{id}

Authorization

This endpoint requires:

  • delete action on this organization-preference resource.

Path parameters

Parameter Type Optional Description

id

Object

false

Response fields

Path Type Optional Description

id

String

true

organizationId

String

true

preferences

Object

true

createdBy

String

true

createdAt

Object

true

updatedAt

Object

true

deletedBy

String

true

deletedAt

Object

true

Example request

$ curl 'https://gateway.netFoundry.io/identity/v1/organization-preferences/9a683d6f-30ca-43fb-9e6d-c4216bc48432' -i -X DELETE

Example response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 505

{
  "id" : "9a683d6f-30ca-43fb-9e6d-c4216bc48432",
  "organizationId" : "c10af5af-123d-44ad-afa7-6c9e0bf8630c",
  "preferences" : {
    "hello" : "world"
  },
  "createdBy" : "7d59d8a8-32e1-4628-9ce0-1fefe1d482bb",
  "createdAt" : {
    "nano" : 107304000,
    "epochSecond" : 1760045362
  },
  "updatedAt" : {
    "nano" : 118768000,
    "epochSecond" : 1760045362
  },
  "deletedBy" : "6b40df4f-d34d-403e-833c-c300fa073666",
  "deletedAt" : {
    "nano" : 118000000,
    "epochSecond" : 1760045362
  }
}