Boomi API Control Plane REST API - DeveloperPortals

Updated 13 November 2026

Toggle Pane

• Developer Portals
  • getGet Developer Portal by ID
  • putUpdate a Developer Portal
  • delDelete a Developer Portal
  • getGet Developer Portal welcome page
  • putUpdate Developer Portal welcome page
  • putAssign terms of use to a Developer Portal
  • delRemove terms of use from a Developer Portal
  • putAdd default publisher to a Developer Portal
  • delRemove default publisher from a Developer Portal
  • getList all Developer Portals
  • postCreate a new Developer Portal
  • postUnpublish all API Products of an organization from a Developer Portal
  • postPublish all API Products of an organization to a Developer Portal
  • postGenerate new Developer Portal access token
  • getList Developer Portal files
  • postUpload an image file to a Developer Portal
  • postFetch newer version of certificate
  • postCheck if the user can create a new Developer Portal
  • getList terms of use assigned to a Developer Portal
  • getList terms of use available to assign
  • getDownload a Developer Portal file
  • delDelete a Developer Portal file
  • getList default publishers of a Developer Portal
  • getList available default publishers for a Developer Portal
  • getVerify CNAME configuration for custom domain
  • getFetch newer version of certificate for developer portal

API docs by Redocly

Download OpenAPI Specification: Download

For more information about Postman collections, forking, and making your first API call, refer to the Working with Boomi APIs on Postman page.

Developer Portals

Developer Portal instances.

Get Developer Portal by ID

Get a single developer portal.

Authorizations:

bearerAuth

path Parameters

id required

string <uuid> This should be the uuid for the entity in question - but for backwards compatibility, this will also accept the old integer id.

Responses

Response Schema: application/json

allowSubscriptionUpdate required	boolean Allow plan changes via portal.
allowSubscriptionsToNonProductionEnvironments required	boolean Allow subscriptions to non-production environments.
anonymousAccess required	boolean Allow unauthenticated browsing.
customDomainEnabled required	boolean Specifies whether custom domain has been enabled for the developer portal.
defaultPublishingScope required	string Enum: "ALL" "DEFAULT_PUBLISHERS_ONLY" Which new API Products and MCP server versions will be assigned to this developer portal for publishing.
name required	string Human-readable name of the Developer Portal.
showApiOwner required	boolean Display the owning organization on API listings.
showMenuIcons required	boolean Whether to show icons in the developer portal menu.
status required	string Enum: "INACTIVE" "ACTIVE" ACTIVE or INACTIVE.
token required	string Portal API access token.
organization	string <uuid> Deprecated Deprecated and no longer used. Always null in responses; ignored in requests.
url	string Public portal URL. For Boomi hosted portals, this field is read-only and derived from portal settings.
customDomain	string Custom domain configured for this developer portal. If present in update request, certificateComponentId must also be present
portalType	string Enum: "SELF_MANAGED" "BOOMI_MANAGED" SELF_MANAGED or BOOMI_MANAGED.
emailFooter	string Custom email footer.
	object (DevPortalPropertiesDTO) Appearance and behavior settings.
certificateComponentId	string The componentId of the certificate in Boomi Integration used for the custom domain. If present in update request, customDomain must also be present.
certificateExpirationDate	string <date-time> The expiration date of the certificate in Boomi Integration used for the custom domain
id	string <uuid> The unique ID of the Developer portal

NA Production

https://{subdomain}.backend.na.controlplane.boomi.com/devPortals/{id}

GB Production

https://{subdomain}.backend.gb.controlplane.boomi.com/devPortals/{id}

Response samples

• 200
• default

Content type

application/json

{

• "name": "API Shop",
• "organization": "452c1a86-a0af-475b-b03f-724878b0f387",
• "anonymousAccess": true,
• "showApiOwner": true,
• "allowSubscriptionUpdate": true,
• "allowSubscriptionsToNonProductionEnvironments": true,
• "showMenuIcons": true,
• "url": "https://coolAPIs.io",
• "customDomain": "devportal.mycompany.com",
• "status": "ACTIVE",
• "portalType": "BOOMI_MANAGED",
• "emailFooter": "string",
• "properties": {

  • "logoFile": "string",
  • "logoFileSmall": "string",
  • "logoFileIco": "string",
  • "colorPrimary": "string",
  • "colorSecondary": "string",
  • "colorMenuText": "string",
  • "colorPrimaryButtonText": "string",
  • "devPortalName": "string",
  • "showApiOwner": true,
  • "allowSubscriptionUpdate": true,
  • "showMenuIcons": true

  },
• "token": "jk2f982jf29fjsd29uf298j2k",
• "customDomainEnabled": false,
• "certificateComponentId": "string",
• "certificateExpirationDate": "2019-08-24T14:15:22Z",
• "defaultPublishingScope": "ALL",
• "id": 999

}

Update a Developer Portal

Update a developer portal.

Authorizations:

bearerAuth

path Parameters

id required

string <uuid> This should be the uuid for the entity in question - but for backwards compatibility, this will also accept the old integer id.

Request Body schema: application/json

required

allowSubscriptionUpdate required	boolean Allow plan changes via portal.
allowSubscriptionsToNonProductionEnvironments required	boolean Allow subscriptions to non-production environments.
anonymousAccess required	boolean Allow unauthenticated browsing.
customDomainEnabled required	boolean Specifies whether custom domain has been enabled for the developer portal.
defaultPublishingScope required	string Enum: "ALL" "DEFAULT_PUBLISHERS_ONLY" Which new API Products and MCP server versions will be assigned to this developer portal for publishing.
name required	string Human-readable name of the Developer Portal.
showApiOwner required	boolean Display the owning organization on API listings.
showMenuIcons required	boolean Whether to show icons in the developer portal menu.
status required	string Enum: "INACTIVE" "ACTIVE" ACTIVE or INACTIVE.
token required	string Portal API access token.
organization	string <uuid> Deprecated Deprecated and no longer used. Always null in responses; ignored in requests.
url	string Public portal URL. For Boomi hosted portals, this field is read-only and derived from portal settings.
customDomain	string Custom domain configured for this developer portal. If present in update request, certificateComponentId must also be present
portalType	string Enum: "SELF_MANAGED" "BOOMI_MANAGED" SELF_MANAGED or BOOMI_MANAGED.
emailFooter	string Custom email footer.
	object (DevPortalPropertiesDTO) Appearance and behavior settings.
certificateComponentId	string The componentId of the certificate in Boomi Integration used for the custom domain. If present in update request, customDomain must also be present.
certificateExpirationDate	string <date-time> The expiration date of the certificate in Boomi Integration used for the custom domain
id	string <uuid> The unique ID of the Developer portal

Responses

Response Schema: application/json

allowSubscriptionUpdate required	boolean Allow plan changes via portal.
allowSubscriptionsToNonProductionEnvironments required	boolean Allow subscriptions to non-production environments.
anonymousAccess required	boolean Allow unauthenticated browsing.
customDomainEnabled required	boolean Specifies whether custom domain has been enabled for the developer portal.
defaultPublishingScope required	string Enum: "ALL" "DEFAULT_PUBLISHERS_ONLY" Which new API Products and MCP server versions will be assigned to this developer portal for publishing.
name required	string Human-readable name of the Developer Portal.
showApiOwner required	boolean Display the owning organization on API listings.
showMenuIcons required	boolean Whether to show icons in the developer portal menu.
status required	string Enum: "INACTIVE" "ACTIVE" ACTIVE or INACTIVE.
token required	string Portal API access token.
organization	string <uuid> Deprecated Deprecated and no longer used. Always null in responses; ignored in requests.
url	string Public portal URL. For Boomi hosted portals, this field is read-only and derived from portal settings.
customDomain	string Custom domain configured for this developer portal. If present in update request, certificateComponentId must also be present
portalType	string Enum: "SELF_MANAGED" "BOOMI_MANAGED" SELF_MANAGED or BOOMI_MANAGED.
emailFooter	string Custom email footer.
	object (DevPortalPropertiesDTO) Appearance and behavior settings.
certificateComponentId	string The componentId of the certificate in Boomi Integration used for the custom domain. If present in update request, customDomain must also be present.
certificateExpirationDate	string <date-time> The expiration date of the certificate in Boomi Integration used for the custom domain
id	string <uuid> The unique ID of the Developer portal

NA Production

https://{subdomain}.backend.na.controlplane.boomi.com/devPortals/{id}

GB Production

https://{subdomain}.backend.gb.controlplane.boomi.com/devPortals/{id}

Request samples

• Payload

Content type

application/json

{

• "name": "API Shop",
• "organization": "452c1a86-a0af-475b-b03f-724878b0f387",
• "anonymousAccess": true,
• "showApiOwner": true,
• "allowSubscriptionUpdate": true,
• "allowSubscriptionsToNonProductionEnvironments": true,
• "showMenuIcons": true,
• "url": "https://coolAPIs.io",
• "customDomain": "devportal.mycompany.com",
• "status": "ACTIVE",
• "portalType": "BOOMI_MANAGED",
• "emailFooter": "string",
• "properties": {

  • "logoFile": "string",
  • "logoFileSmall": "string",
  • "logoFileIco": "string",
  • "colorPrimary": "string",
  • "colorSecondary": "string",
  • "colorMenuText": "string",
  • "colorPrimaryButtonText": "string"

  },
• "token": "jk2f982jf29fjsd29uf298j2k",
• "customDomainEnabled": false,
• "certificateComponentId": "string",
• "certificateExpirationDate": "2019-08-24T14:15:22Z",
• "defaultPublishingScope": "ALL",
• "id": 999

}

Response samples

• 200
• default

Content type

application/json

{

• "name": "API Shop",
• "organization": "452c1a86-a0af-475b-b03f-724878b0f387",
• "anonymousAccess": true,
• "showApiOwner": true,
• "allowSubscriptionUpdate": true,
• "allowSubscriptionsToNonProductionEnvironments": true,
• "showMenuIcons": true,
• "url": "https://coolAPIs.io",
• "customDomain": "devportal.mycompany.com",
• "status": "ACTIVE",
• "portalType": "BOOMI_MANAGED",
• "emailFooter": "string",
• "properties": {

  • "logoFile": "string",
  • "logoFileSmall": "string",
  • "logoFileIco": "string",
  • "colorPrimary": "string",
  • "colorSecondary": "string",
  • "colorMenuText": "string",
  • "colorPrimaryButtonText": "string",
  • "devPortalName": "string",
  • "showApiOwner": true,
  • "allowSubscriptionUpdate": true,
  • "showMenuIcons": true

  },
• "token": "jk2f982jf29fjsd29uf298j2k",
• "customDomainEnabled": false,
• "certificateComponentId": "string",
• "certificateExpirationDate": "2019-08-24T14:15:22Z",
• "defaultPublishingScope": "ALL",
• "id": 999

}

Delete a Developer Portal

Delete a developer portal.

Authorizations:

bearerAuth

path Parameters

id required

string <uuid> This should be the uuid for the entity in question - but for backwards compatibility, this will also accept the old integer id.

Responses

NA Production

https://{subdomain}.backend.na.controlplane.boomi.com/devPortals/{id}

GB Production

https://{subdomain}.backend.gb.controlplane.boomi.com/devPortals/{id}

Response samples

• default

Content type

application/json

{

• "timestamp": "string",
• "status": 0,
• "error": "string",
• "message": "string",
• "path": "string"

}

Get Developer Portal welcome page

Get raw content of developer portal welcome page.

Authorizations:

bearerAuth

path Parameters

id required

string <uuid> This should be the uuid for the entity in question - but for backwards compatibility, this will also accept the old integer id.

Responses

Response Schema: application/octet-stream

string <binary>

NA Production

https://{subdomain}.backend.na.controlplane.boomi.com/devPortals/{id}/welcomePage

GB Production

https://{subdomain}.backend.gb.controlplane.boomi.com/devPortals/{id}/welcomePage

Response samples

• default

Content type

application/json

{

• "timestamp": "string",
• "status": 0,
• "error": "string",
• "message": "string",
• "path": "string"

}

Update Developer Portal welcome page

Write content of developer portal welcome page. Existing content is overwritten.

Authorizations:

bearerAuth

path Parameters

id required

string <uuid> This should be the uuid for the entity in question - but for backwards compatibility, this will also accept the old integer id.

Request Body schema: multipart/form-data

file required

string <binary>

Responses

NA Production

https://{subdomain}.backend.na.controlplane.boomi.com/devPortals/{id}/welcomePage

GB Production

https://{subdomain}.backend.gb.controlplane.boomi.com/devPortals/{id}/welcomePage

Response samples

• default

Content type

application/json

{

• "timestamp": "string",
• "status": 0,
• "error": "string",
• "message": "string",
• "path": "string"

}

Assign terms of use to a Developer Portal

Assign a terms of use document to this developer portal.

Authorizations:

bearerAuth

path Parameters

id required	string <uuid> This should be the uuid for the entity in question - but for backwards compatibility, this will also accept the old integer id.
termsOfUse required	string <uuid> This should be the uuid for the entity in question - but for backwards compatibility, this will also accept the old integer id.

Responses

NA Production

https://{subdomain}.backend.na.controlplane.boomi.com/devPortals/{id}/termsOfUse/{termsOfUse}

GB Production

https://{subdomain}.backend.gb.controlplane.boomi.com/devPortals/{id}/termsOfUse/{termsOfUse}

Response samples

• default

Content type

application/json

{

• "timestamp": "string",
• "status": 0,
• "error": "string",
• "message": "string",
• "path": "string"

}

Remove terms of use from a Developer Portal

Unassign a terms of use document from this developer portal.

Authorizations:

bearerAuth

path Parameters

id required	string <uuid> This should be the uuid for the entity in question - but for backwards compatibility, this will also accept the old integer id.
termsOfUse required	string <uuid> This should be the uuid for the entity in question - but for backwards compatibility, this will also accept the old integer id.

Responses

NA Production

https://{subdomain}.backend.na.controlplane.boomi.com/devPortals/{id}/termsOfUse/{termsOfUse}

GB Production

https://{subdomain}.backend.gb.controlplane.boomi.com/devPortals/{id}/termsOfUse/{termsOfUse}

Response samples

• default

Content type

application/json

{

• "timestamp": "string",
• "status": 0,
• "error": "string",
• "message": "string",
• "path": "string"

}

Add default publisher to a Developer Portal

Add an organization to the list of default publishers of this developer portal. Consumer-only organizations cannot be default publishers.

Authorizations:

bearerAuth

path Parameters

id required	string <uuid> This should be the uuid for the entity in question - but for backwards compatibility, this will also accept the old integer id.
orgId required	string <uuid>

Responses

NA Production

https://{subdomain}.backend.na.controlplane.boomi.com/devPortals/{id}/defaultPublishers/{orgId}

GB Production

https://{subdomain}.backend.gb.controlplane.boomi.com/devPortals/{id}/defaultPublishers/{orgId}

Response samples

• default

Content type

application/json

{

• "timestamp": "string",
• "status": 0,
• "error": "string",
• "message": "string",
• "path": "string"

}

Remove default publisher from a Developer Portal

Remove an organization from the list of default publishers of this developer portal.

Authorizations:

bearerAuth

path Parameters

id required	string <uuid> This should be the uuid for the entity in question - but for backwards compatibility, this will also accept the old integer id.
orgId required	string <uuid>

Responses

NA Production

https://{subdomain}.backend.na.controlplane.boomi.com/devPortals/{id}/defaultPublishers/{orgId}

GB Production

https://{subdomain}.backend.gb.controlplane.boomi.com/devPortals/{id}/defaultPublishers/{orgId}

Response samples

• default

Content type

application/json

{

• "timestamp": "string",
• "status": 0,
• "error": "string",
• "message": "string",
• "path": "string"

}

List all Developer Portals

Get a filtered and paged list of all developer portals.

Authorizations:

bearerAuth

query Parameters

text	string
name	string
organization	string <uuid>
status	string Enum: "INACTIVE" "ACTIVE"
token	string
url	string
portalType	string Enum: "SELF_MANAGED" "BOOMI_MANAGED"
certificateComponentId	string
page	integer Default: 1 One-based page index (1..N)
size	integer Default: 10 The size of the page to be returned
sort	Array of arrays Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.

Responses

Response Schema: application/json

required	Array of objects (DevPortalDTO) List of DevPortalDTO results for the current page.
last required	boolean Whether this is the last page.
number required	integer <int32> Current page number (1-based).
size required	integer <int32> Requested page size.
totalElements required	integer <int64> Total number of matching results across all pages.
totalPages required	integer <int32> Total number of pages.

NA Production

https://{subdomain}.backend.na.controlplane.boomi.com/devPortals

GB Production

https://{subdomain}.backend.gb.controlplane.boomi.com/devPortals

Response samples

• 200
• default

Content type

application/json

{

• "content": [

  • {

    • "name": "API Shop",
    • "organization": "452c1a86-a0af-475b-b03f-724878b0f387",
    • "anonymousAccess": true,
    • "showApiOwner": true,
    • "allowSubscriptionUpdate": true,
    • "allowSubscriptionsToNonProductionEnvironments": true,
    • "showMenuIcons": true,
    • "url": "https://coolAPIs.io",
    • "customDomain": "devportal.mycompany.com",
    • "status": "ACTIVE",
    • "portalType": "BOOMI_MANAGED",
    • "emailFooter": "string",
    • "properties": {

      • "logoFile": "string",
      • "logoFileSmall": "string",
      • "logoFileIco": "string",
      • "colorPrimary": "string",
      • "colorSecondary": "string",
      • "colorMenuText": "string",
      • "colorPrimaryButtonText": "string",
      • "devPortalName": "string",
      • "showApiOwner": true,
      • "allowSubscriptionUpdate": true,
      • "showMenuIcons": true

      },
    • "token": "jk2f982jf29fjsd29uf298j2k",
    • "customDomainEnabled": false,
    • "certificateComponentId": "string",
    • "certificateExpirationDate": "2019-08-24T14:15:22Z",
    • "defaultPublishingScope": "ALL",
    • "id": 999

    }

  ],
• "size": 0,
• "number": 0,
• "last": true,
• "totalPages": 0,
• "totalElements": 0

}

Create a new Developer Portal

Create a new developer portal.

Authorizations:

bearerAuth

Request Body schema: application/json

required

allowSubscriptionUpdate required	boolean Allow plan changes via portal.
allowSubscriptionsToNonProductionEnvironments required	boolean Allow subscriptions to non-production environments.
anonymousAccess required	boolean Allow unauthenticated browsing.
customDomainEnabled required	boolean Specifies whether custom domain has been enabled for the developer portal.
defaultPublishingScope required	string Enum: "ALL" "DEFAULT_PUBLISHERS_ONLY" Which new API Products and MCP server versions will be assigned to this developer portal for publishing.
name required	string Human-readable name of the Developer Portal.
showApiOwner required	boolean Display the owning organization on API listings.
showMenuIcons required	boolean Whether to show icons in the developer portal menu.
status required	string Enum: "INACTIVE" "ACTIVE" ACTIVE or INACTIVE.
token required	string Portal API access token.
organization	string <uuid> Deprecated Deprecated and no longer used. Always null in responses; ignored in requests.
url	string Public portal URL. For Boomi hosted portals, this field is read-only and derived from portal settings.
customDomain	string Custom domain configured for this developer portal. If present in update request, certificateComponentId must also be present
portalType	string Enum: "SELF_MANAGED" "BOOMI_MANAGED" SELF_MANAGED or BOOMI_MANAGED.
emailFooter	string Custom email footer.
	object (DevPortalPropertiesDTO) Appearance and behavior settings.
certificateComponentId	string The componentId of the certificate in Boomi Integration used for the custom domain. If present in update request, customDomain must also be present.
certificateExpirationDate	string <date-time> The expiration date of the certificate in Boomi Integration used for the custom domain
id	string <uuid> The unique ID of the Developer portal

Responses

Response Schema: application/json

allowSubscriptionUpdate required	boolean Allow plan changes via portal.
allowSubscriptionsToNonProductionEnvironments required	boolean Allow subscriptions to non-production environments.
anonymousAccess required	boolean Allow unauthenticated browsing.
customDomainEnabled required	boolean Specifies whether custom domain has been enabled for the developer portal.
defaultPublishingScope required	string Enum: "ALL" "DEFAULT_PUBLISHERS_ONLY" Which new API Products and MCP server versions will be assigned to this developer portal for publishing.
name required	string Human-readable name of the Developer Portal.
showApiOwner required	boolean Display the owning organization on API listings.
showMenuIcons required	boolean Whether to show icons in the developer portal menu.
status required	string Enum: "INACTIVE" "ACTIVE" ACTIVE or INACTIVE.
token required	string Portal API access token.
organization	string <uuid> Deprecated Deprecated and no longer used. Always null in responses; ignored in requests.
url	string Public portal URL. For Boomi hosted portals, this field is read-only and derived from portal settings.
customDomain	string Custom domain configured for this developer portal. If present in update request, certificateComponentId must also be present
portalType	string Enum: "SELF_MANAGED" "BOOMI_MANAGED" SELF_MANAGED or BOOMI_MANAGED.
emailFooter	string Custom email footer.
	object (DevPortalPropertiesDTO) Appearance and behavior settings.
certificateComponentId	string The componentId of the certificate in Boomi Integration used for the custom domain. If present in update request, customDomain must also be present.
certificateExpirationDate	string <date-time> The expiration date of the certificate in Boomi Integration used for the custom domain
id	string <uuid> The unique ID of the Developer portal

NA Production

https://{subdomain}.backend.na.controlplane.boomi.com/devPortals

GB Production

https://{subdomain}.backend.gb.controlplane.boomi.com/devPortals

Request samples

• Payload

Content type

application/json

{

• "name": "API Shop",
• "organization": "452c1a86-a0af-475b-b03f-724878b0f387",
• "anonymousAccess": true,
• "showApiOwner": true,
• "allowSubscriptionUpdate": true,
• "allowSubscriptionsToNonProductionEnvironments": true,
• "showMenuIcons": true,
• "url": "https://coolAPIs.io",
• "customDomain": "devportal.mycompany.com",
• "status": "ACTIVE",
• "portalType": "BOOMI_MANAGED",
• "emailFooter": "string",
• "properties": {

  • "logoFile": "string",
  • "logoFileSmall": "string",
  • "logoFileIco": "string",
  • "colorPrimary": "string",
  • "colorSecondary": "string",
  • "colorMenuText": "string",
  • "colorPrimaryButtonText": "string"

  },
• "token": "jk2f982jf29fjsd29uf298j2k",
• "customDomainEnabled": false,
• "certificateComponentId": "string",
• "certificateExpirationDate": "2019-08-24T14:15:22Z",
• "defaultPublishingScope": "ALL",
• "id": 999

}

Response samples

• 200
• default

Content type

application/json

{

• "name": "API Shop",
• "organization": "452c1a86-a0af-475b-b03f-724878b0f387",
• "anonymousAccess": true,
• "showApiOwner": true,
• "allowSubscriptionUpdate": true,
• "allowSubscriptionsToNonProductionEnvironments": true,
• "showMenuIcons": true,
• "url": "https://coolAPIs.io",
• "customDomain": "devportal.mycompany.com",
• "status": "ACTIVE",
• "portalType": "BOOMI_MANAGED",
• "emailFooter": "string",
• "properties": {

  • "logoFile": "string",
  • "logoFileSmall": "string",
  • "logoFileIco": "string",
  • "colorPrimary": "string",
  • "colorSecondary": "string",
  • "colorMenuText": "string",
  • "colorPrimaryButtonText": "string",
  • "devPortalName": "string",
  • "showApiOwner": true,
  • "allowSubscriptionUpdate": true,
  • "showMenuIcons": true

  },
• "token": "jk2f982jf29fjsd29uf298j2k",
• "customDomainEnabled": false,
• "certificateComponentId": "string",
• "certificateExpirationDate": "2019-08-24T14:15:22Z",
• "defaultPublishingScope": "ALL",
• "id": 999

}

Unpublish all API Products of an organization from a Developer Portal

Remove this developer portal from every API Product owned by the given organization or any of its sub-organizations. The published state of those API Products is left unchanged.

Authorizations:

bearerAuth

path Parameters

id required

string <uuid> This should be the uuid for the entity in question - but for backwards compatibility, this will also accept the old integer id.

query Parameters

organization required

string <uuid> This should be the uuid for the entity in question - but for backwards compatibility, this will also accept the old integer id.

Responses

Response Schema: application/json

apiProducts required	integer <int32> Number of API Products for which the assignment of this developer portal actually changed. API Products that were already in the requested state are not counted.
published required	integer <int32> Number of API Products whose published state was actually changed to PUBLISHED. Always 0 for unpublish and for publish without forcePublished.

NA Production

https://{subdomain}.backend.na.controlplane.boomi.com/devPortals/{id}/unpublish

GB Production

https://{subdomain}.backend.gb.controlplane.boomi.com/devPortals/{id}/unpublish

Response samples

• 200
• default

Content type

application/json

{

• "apiProducts": 0,
• "published": 0

}

Publish all API Products of an organization to a Developer Portal

Add this developer portal to every API Product owned by the given organization or any of its sub-organizations. By default, this does not change the general published status of the API Products. If forcePublished is true, the API Products will be set to published if they are unpublished.

Authorizations:

bearerAuth

path Parameters

id required

string <uuid> This should be the uuid for the entity in question - but for backwards compatibility, this will also accept the old integer id.

query Parameters

organization required	string <uuid> This should be the uuid for the entity in question - but for backwards compatibility, this will also accept the old integer id.
forcePublished	boolean Default: false

Responses

Response Schema: application/json

apiProducts required	integer <int32> Number of API Products for which the assignment of this developer portal actually changed. API Products that were already in the requested state are not counted.
published required	integer <int32> Number of API Products whose published state was actually changed to PUBLISHED. Always 0 for unpublish and for publish without forcePublished.

NA Production

https://{subdomain}.backend.na.controlplane.boomi.com/devPortals/{id}/publish

GB Production

https://{subdomain}.backend.gb.controlplane.boomi.com/devPortals/{id}/publish

Response samples

• 200
• default

Content type

application/json

{

• "apiProducts": 0,
• "published": 0

}

Generate new Developer Portal access token

Generate a new token for a developer portal. The existing token will be overwritten an no longer work!

Authorizations:

bearerAuth

path Parameters

id required

string <uuid> This should be the uuid for the entity in question - but for backwards compatibility, this will also accept the old integer id.

Responses

Response Schema: application/json

allowSubscriptionUpdate required	boolean Allow plan changes via portal.
allowSubscriptionsToNonProductionEnvironments required	boolean Allow subscriptions to non-production environments.
anonymousAccess required	boolean Allow unauthenticated browsing.
customDomainEnabled required	boolean Specifies whether custom domain has been enabled for the developer portal.
defaultPublishingScope required	string Enum: "ALL" "DEFAULT_PUBLISHERS_ONLY" Which new API Products and MCP server versions will be assigned to this developer portal for publishing.
name required	string Human-readable name of the Developer Portal.
showApiOwner required	boolean Display the owning organization on API listings.
showMenuIcons required	boolean Whether to show icons in the developer portal menu.
status required	string Enum: "INACTIVE" "ACTIVE" ACTIVE or INACTIVE.
token required	string Portal API access token.
organization	string <uuid> Deprecated Deprecated and no longer used. Always null in responses; ignored in requests.
url	string Public portal URL. For Boomi hosted portals, this field is read-only and derived from portal settings.
customDomain	string Custom domain configured for this developer portal. If present in update request, certificateComponentId must also be present
portalType	string Enum: "SELF_MANAGED" "BOOMI_MANAGED" SELF_MANAGED or BOOMI_MANAGED.
emailFooter	string Custom email footer.
	object (DevPortalPropertiesDTO) Appearance and behavior settings.
certificateComponentId	string The componentId of the certificate in Boomi Integration used for the custom domain. If present in update request, customDomain must also be present.
certificateExpirationDate	string <date-time> The expiration date of the certificate in Boomi Integration used for the custom domain
id	string <uuid> The unique ID of the Developer portal

NA Production

https://{subdomain}.backend.na.controlplane.boomi.com/devPortals/{id}/newToken

GB Production

https://{subdomain}.backend.gb.controlplane.boomi.com/devPortals/{id}/newToken

Response samples

• 200
• default

Content type

application/json

{

• "name": "API Shop",
• "organization": "452c1a86-a0af-475b-b03f-724878b0f387",
• "anonymousAccess": true,
• "showApiOwner": true,
• "allowSubscriptionUpdate": true,
• "allowSubscriptionsToNonProductionEnvironments": true,
• "showMenuIcons": true,
• "url": "https://coolAPIs.io",
• "customDomain": "devportal.mycompany.com",
• "status": "ACTIVE",
• "portalType": "BOOMI_MANAGED",
• "emailFooter": "string",
• "properties": {

  • "logoFile": "string",
  • "logoFileSmall": "string",
  • "logoFileIco": "string",
  • "colorPrimary": "string",
  • "colorSecondary": "string",
  • "colorMenuText": "string",
  • "colorPrimaryButtonText": "string",
  • "devPortalName": "string",
  • "showApiOwner": true,
  • "allowSubscriptionUpdate": true,
  • "showMenuIcons": true

  },
• "token": "jk2f982jf29fjsd29uf298j2k",
• "customDomainEnabled": false,
• "certificateComponentId": "string",
• "certificateExpirationDate": "2019-08-24T14:15:22Z",
• "defaultPublishingScope": "ALL",
• "id": 999

}

List Developer Portal files

List all uploaded documentation files for this developer portal.

Authorizations:

bearerAuth

path Parameters

id required

string <uuid> This should be the uuid for the entity in question - but for backwards compatibility, this will also accept the old integer id.

Responses

Response Schema: application/json

Array

string

NA Production

https://{subdomain}.backend.na.controlplane.boomi.com/devPortals/{id}/files

GB Production

https://{subdomain}.backend.gb.controlplane.boomi.com/devPortals/{id}/files

Response samples

• 200
• default

Content type

application/json

[

• "string"

]

Upload an image file to a Developer Portal

Upload an image file for use in documentation of a developer portal. Also used to upload logo files that can then be referenced in DevPortalPropertiesDTO. If a file with the same name exists, it will be overwritten.

Authorizations:

bearerAuth

path Parameters

id required

string <uuid> This should be the uuid for the entity in question - but for backwards compatibility, this will also accept the old integer id.

Request Body schema: multipart/form-data

file required

string <binary>

Responses

NA Production

https://{subdomain}.backend.na.controlplane.boomi.com/devPortals/{id}/files

GB Production

https://{subdomain}.backend.gb.controlplane.boomi.com/devPortals/{id}/files

Response samples

• default

Content type

application/json

{

• "timestamp": "string",
• "status": 0,
• "error": "string",
• "message": "string",
• "path": "string"

}

Fetch newer version of certificate

Asynchronously fetch and update the certificate for all developer portals using the given certificate component.

Authorizations:

bearerAuth

query Parameters

certificateComponentId required

string

Responses

Response Schema: application/json

id required

string <uuid> UUID of the async job.

NA Production

https://{subdomain}.backend.na.controlplane.boomi.com/devPortals/certificate/refresh

GB Production

https://{subdomain}.backend.gb.controlplane.boomi.com/devPortals/certificate/refresh

Response samples

• 200
• default

Content type

application/json

{

• "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"

}

Check if the user can create a new Developer Portal

Check if a new (active) developer portal can be created for the current tenant or if the tier limit has been reached.

Authorizations:

bearerAuth

query Parameters

portalType

string Default: "SELF_MANAGED" Enum: "SELF_MANAGED" "BOOMI_MANAGED"

Responses

Response Schema: application/json

canCreateActive required	boolean True if creating a new active resource is allowed within the current tier limits.
error	string
field	string

NA Production

https://{subdomain}.backend.na.controlplane.boomi.com/devPortals/canCreate

GB Production

https://{subdomain}.backend.gb.controlplane.boomi.com/devPortals/canCreate

Response samples

• 200
• default

Content type

application/json

{

• "canCreateActive": true,
• "error": "string",
• "field": "string"

}

List terms of use assigned to a Developer Portal

Get all terms of use documents that are assigned to this developer portal, including documents marked as default for all developer portals.

Authorizations:

bearerAuth

path Parameters

id required

string <uuid> This should be the uuid for the entity in question - but for backwards compatibility, this will also accept the old integer id.

query Parameters

active

boolean

Responses

Response Schema: application/json

Array

active required	boolean Whether this terms-of-use document is currently active.
defaultForApiProducts required	boolean Default for new API Products.
defaultForDevPortals required	boolean Default for portal registration.
name required	string Display name of the terms-of-use document.
createdAt	string <date-time> Timestamp when the document was created.
id	string <uuid> UUID of the terms-of-use document.

NA Production

https://{subdomain}.backend.na.controlplane.boomi.com/devPortals/{id}/termsOfUse

GB Production

https://{subdomain}.backend.gb.controlplane.boomi.com/devPortals/{id}/termsOfUse

Response samples

• 200
• default

Content type

application/json

[

• {

  • "name": "string",
  • "active": true,
  • "defaultForApiProducts": true,
  • "defaultForDevPortals": true,
  • "createdAt": "2019-08-24T14:15:22Z",
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"

  }

]

List terms of use available to assign

Get all available terms of use documents that can be assigned to this developer portal.

Authorizations:

bearerAuth

path Parameters

id required

string <uuid> This should be the uuid for the entity in question - but for backwards compatibility, this will also accept the old integer id.

Responses

Response Schema: application/json

Array

active required	boolean Whether this terms-of-use document is currently active.
defaultForApiProducts required	boolean Default for new API Products.
defaultForDevPortals required	boolean Default for portal registration.
name required	string Display name of the terms-of-use document.
createdAt	string <date-time> Timestamp when the document was created.
id	string <uuid> UUID of the terms-of-use document.

NA Production

https://{subdomain}.backend.na.controlplane.boomi.com/devPortals/{id}/termsOfUse/available

GB Production

https://{subdomain}.backend.gb.controlplane.boomi.com/devPortals/{id}/termsOfUse/available

Response samples

• 200
• default

Content type

application/json

[

• {

  • "name": "string",
  • "active": true,
  • "defaultForApiProducts": true,
  • "defaultForDevPortals": true,
  • "createdAt": "2019-08-24T14:15:22Z",
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"

  }

]

Download a Developer Portal file

Get content of a previously uploaded developer portal documentation file.

Authorizations:

bearerAuth

path Parameters

id required	string <uuid> This should be the uuid for the entity in question - but for backwards compatibility, this will also accept the old integer id.
fileName required	string

Responses

Response Schema: application/octet-stream

string <binary>

NA Production

https://{subdomain}.backend.na.controlplane.boomi.com/devPortals/{id}/files/{fileName}

GB Production

https://{subdomain}.backend.gb.controlplane.boomi.com/devPortals/{id}/files/{fileName}

Response samples

• default

Content type

application/json

{

• "timestamp": "string",
• "status": 0,
• "error": "string",
• "message": "string",
• "path": "string"

}

Delete a Developer Portal file

Delete a previously uploaded developer portal documentation file.

Authorizations:

bearerAuth

path Parameters

id required	string <uuid> This should be the uuid for the entity in question - but for backwards compatibility, this will also accept the old integer id.
fileName required	string

Responses

NA Production

https://{subdomain}.backend.na.controlplane.boomi.com/devPortals/{id}/files/{fileName}

GB Production

https://{subdomain}.backend.gb.controlplane.boomi.com/devPortals/{id}/files/{fileName}

Response samples

• default

Content type

application/json

{

• "timestamp": "string",
• "status": 0,
• "error": "string",
• "message": "string",
• "path": "string"

}

List default publishers of a Developer Portal

Get a paged list of all organizations (name and id only) that are configured as default publishers for this developer portal.

Authorizations:

bearerAuth

path Parameters

id required

string <uuid> This should be the uuid for the entity in question - but for backwards compatibility, this will also accept the old integer id.

query Parameters

page	integer Default: 1 One-based page index (1..N)
size	integer Default: 10 The size of the page to be returned
sort	Array of arrays Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.

Responses

Response Schema: application/json

required	Array of objects (OrganizationDTO) List of OrganizationDTO results for the current page.
last required	boolean Whether this is the last page.
number required	integer <int32> Current page number (1-based).
size required	integer <int32> Requested page size.
totalElements required	integer <int64> Total number of matching results across all pages.
totalPages required	integer <int32> Total number of pages.

NA Production

https://{subdomain}.backend.na.controlplane.boomi.com/devPortals/{id}/defaultPublishers

GB Production

https://{subdomain}.backend.gb.controlplane.boomi.com/devPortals/{id}/defaultPublishers

Response samples

• 200
• default

Content type

application/json

{

• "content": [

  • {

    • "name": "Default Organization",
    • "displayName": "Default Organization",
    • "email": "max.mustermann@apiida.com",
    • "description": "This is very cool Developer Portal",
    • "parent": 1,
    • "type": "BOTH",
    • "status": "ACTIVE",
    • "defaultOwner": true,
    • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    • "hasImage": false,
    • "parentDisplayName": "string"

    }

  ],
• "size": 0,
• "number": 0,
• "last": true,
• "totalPages": 0,
• "totalElements": 0

}

List available default publishers for a Developer Portal

Get a filtered and paged list of organizations (name and id only) that can be added as default publishers of this developer portal. Consumer-only organizations, inactive organizations and organizations that are already default publishers are not included.

Authorizations:

bearerAuth

path Parameters

id required

string <uuid> This should be the uuid for the entity in question - but for backwards compatibility, this will also accept the old integer id.

query Parameters

text	string Free-text filter, matched against the organization's name, display name and email.
type	string Enum: "BOTH" "CONSUMER" "PUBLISHER" Only return organizations of this type. Consumer-only organizations are never returned by this endpoint.
page	integer Default: 1 One-based page index (1..N)
size	integer Default: 10 The size of the page to be returned
sort	Array of arrays Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.

Responses

Response Schema: application/json

required	Array of objects (OrganizationDTO) List of OrganizationDTO results for the current page.
last required	boolean Whether this is the last page.
number required	integer <int32> Current page number (1-based).
size required	integer <int32> Requested page size.
totalElements required	integer <int64> Total number of matching results across all pages.
totalPages required	integer <int32> Total number of pages.

NA Production

https://{subdomain}.backend.na.controlplane.boomi.com/devPortals/{id}/defaultPublishers/available

GB Production

https://{subdomain}.backend.gb.controlplane.boomi.com/devPortals/{id}/defaultPublishers/available

Response samples

• 200
• default

Content type

application/json

{

• "content": [

  • {

    • "name": "Default Organization",
    • "displayName": "Default Organization",
    • "email": "max.mustermann@apiida.com",
    • "description": "This is very cool Developer Portal",
    • "parent": 1,
    • "type": "BOTH",
    • "status": "ACTIVE",
    • "defaultOwner": true,
    • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    • "hasImage": false,
    • "parentDisplayName": "string"

    }

  ],
• "size": 0,
• "number": 0,
• "last": true,
• "totalPages": 0,
• "totalElements": 0

}

Verify CNAME configuration for custom domain

Checks if DNS CNAME record has been correctly configured to alias the custom domain on the given developer portal to the correct devportal domain.

Authorizations:

bearerAuth

path Parameters

id required

string <uuid> This should be the uuid for the entity in question - but for backwards compatibility, this will also accept the old integer id.

Responses

Response Schema: application/json

boolean

NA Production

https://{subdomain}.backend.na.controlplane.boomi.com/devPortals/{id}/customDomain/isDnsVerified

GB Production

https://{subdomain}.backend.gb.controlplane.boomi.com/devPortals/{id}/customDomain/isDnsVerified

Response samples

• 200
• default

Content type

application/json

true

Fetch newer version of certificate for developer portal

Fetch newer version of the certificate, if exists, from Boomi Integration. Returns an error if the domain does not match the portal URL.

Authorizations:

bearerAuth

path Parameters

id required

string <uuid> This should be the uuid for the entity in question - but for backwards compatibility, this will also accept the old integer id.

Responses

Response Schema: application/json

allowSubscriptionUpdate required	boolean Allow plan changes via portal.
allowSubscriptionsToNonProductionEnvironments required	boolean Allow subscriptions to non-production environments.
anonymousAccess required	boolean Allow unauthenticated browsing.
customDomainEnabled required	boolean Specifies whether custom domain has been enabled for the developer portal.
defaultPublishingScope required	string Enum: "ALL" "DEFAULT_PUBLISHERS_ONLY" Which new API Products and MCP server versions will be assigned to this developer portal for publishing.
name required	string Human-readable name of the Developer Portal.
showApiOwner required	boolean Display the owning organization on API listings.
showMenuIcons required	boolean Whether to show icons in the developer portal menu.
status required	string Enum: "INACTIVE" "ACTIVE" ACTIVE or INACTIVE.
token required	string Portal API access token.
organization	string <uuid> Deprecated Deprecated and no longer used. Always null in responses; ignored in requests.
url	string Public portal URL. For Boomi hosted portals, this field is read-only and derived from portal settings.
customDomain	string Custom domain configured for this developer portal. If present in update request, certificateComponentId must also be present
portalType	string Enum: "SELF_MANAGED" "BOOMI_MANAGED" SELF_MANAGED or BOOMI_MANAGED.
emailFooter	string Custom email footer.
	object (DevPortalPropertiesDTO) Appearance and behavior settings.
certificateComponentId	string The componentId of the certificate in Boomi Integration used for the custom domain. If present in update request, customDomain must also be present.
certificateExpirationDate	string <date-time> The expiration date of the certificate in Boomi Integration used for the custom domain
id	string <uuid> The unique ID of the Developer portal

NA Production

https://{subdomain}.backend.na.controlplane.boomi.com/devPortals/{id}/certificate/refresh

GB Production

https://{subdomain}.backend.gb.controlplane.boomi.com/devPortals/{id}/certificate/refresh

Response samples

• 200
• default

Content type

application/json

{

• "name": "API Shop",
• "organization": "452c1a86-a0af-475b-b03f-724878b0f387",
• "anonymousAccess": true,
• "showApiOwner": true,
• "allowSubscriptionUpdate": true,
• "allowSubscriptionsToNonProductionEnvironments": true,
• "showMenuIcons": true,
• "url": "https://coolAPIs.io",
• "customDomain": "devportal.mycompany.com",
• "status": "ACTIVE",
• "portalType": "BOOMI_MANAGED",
• "emailFooter": "string",
• "properties": {

  • "logoFile": "string",
  • "logoFileSmall": "string",
  • "logoFileIco": "string",
  • "colorPrimary": "string",
  • "colorSecondary": "string",
  • "colorMenuText": "string",
  • "colorPrimaryButtonText": "string",
  • "devPortalName": "string",
  • "showApiOwner": true,
  • "allowSubscriptionUpdate": true,
  • "showMenuIcons": true

  },
• "token": "jk2f982jf29fjsd29uf298j2k",
• "customDomainEnabled": false,
• "certificateComponentId": "string",
• "certificateExpirationDate": "2019-08-24T14:15:22Z",
• "defaultPublishingScope": "ALL",
• "id": 999

}