Business Object
Contains information about a business on the platform.
This object is used by the following operations:
- POST /api/businesses
- GET /api/businesses/{BusinessID}
- PUT /api/businesses/{BusinessID}
- DELETE /api/businesses/{BusinessID}
- Operations that reference the Tenant object
The properties included in the Business object are listed below.
| Property | Type | Description |
|---|---|---|
| BusinessID | string | The unique ID for a specific business organization on the platform. |
| BusinessKey | string | The unique ID used in the underlying infrastructure to identify a specific business organization. |
| Name | string | The name of the business. |
| Description | string | The description of the business. |
| Link | anyURI | A link for the resource, if applicable. |
| Contact | string | Contact information for the resource, if applicable. |
| Visibility | string | The visibility setting for this resource. For a list of valid values, see Visibility Settings. |
| Picture | anyURI | A link to an image for the resource, if applicable. |
| IsFollowed | boolean |
Indicates whether the user invoking the operation has a relationship with the resource:
Only present when this object is used in a response message. |
| PictureID | long |
The unique Dropbox ID for the picture uploaded for the resource, if applicable. Used only in request messages when a picture is uploaded as part of adding or updating. |
| Created | dateTime | The date/time stamp when the resource was first created. Used only in response messages. |
| Updated | dateTime | The date/time stamp when the resource was last updated. Used only in response messages. |
| AvatarURL | anyURI | URL for the avatar uploaded for the resource, if any. Used only in response messages. |
| AdminGroupID | string | The unique ID for the Admin Group associated with a specific resource, such as an API or business, comprised of all administrators associated with that resource. Only used in response messages. |
| BusinessType | string |
The name for the type of business; for example, Company, Department, Partner. For valid values, see BusinessType values. Optional. |
| BusinessAPISettings | BusinessAPISettings | Contains information about the settings to apply to all APIs within the business, unless specified otherwise at a lower level. |
| BusinessAppSettings | BusinessAppSettings | Default settings to apply to all apps within the business, unless specified otherwise at a lower level. |
| BusinessGroupSettings | BusinessGroupSettings | Default settings to apply to all groups within the business, unless specified otherwise at a lower level. |
| BusinessUserSettings | BusinessUserSettings | Default settings to apply to all users within the business. |
| BusinessAdminMemberWorkflowDefKey | string | The unique workflow definition key for the custom workflow for the resource, if a custom workflow for this resource type is in use. |
| TicketSettings | TicketSettings | Contains information about a business's settings in relation to tickets. |
| AlertSettings | AlertSettings | Contains information about the alert settings for the business. |
| ConnectionSettings | ConnectionSettings | Contains information about a business's settings in relation to connections (app/API contracts). |
| BusinessReviewSettings | BusinessReviewSettings | Contains information about default settings to apply to all reviews within the business. |
| BusinessDiscussionSettings | BusinessDiscussionSettings | Contains information about default settings to apply to all discussions within the business. |
| CommentSettings | CommentSettings | Contains information about default settings to apply to all comments within the business. |
| Settings | Settings | Contains information about general settings for a business, such as maximum image upload size. |
| ParentBusinessID | string | The unique BusinessID for the parent organization (senior in the organization hierarchy) of a business organization on the platform. |
| TargetResources | TargetResources | Contains information about one or more resources associated with the current resource. Used only in response messages. |