CRM in Cloud Web API documentations

Security

This controller works under the system security rules and constraints.
For more details, refer to the Authentication section

Note

The following guidelines are intended to illustrate the features and features of this Web API controller.

Aliases

This controller can be invoked by other names besides the default one.

This means that, referring to the routing grammar ({schema}://{host}/api/{version}/{controller}/{details}/{action}/{id}?{querystring}) it is possible to use a different fragment for the {controller} component.

Below is the list of these aliases for the fragment {controller}, sorted by suggested preference of use.

Alias	Path
Opportunities	/api/v1/Opportunities
Opportunity	/api/v1/Opportunity

Authentication

JWT Token

In order to invoke the REST API, it is necessary to obtain an authentication token via the appropriate service /Auth/Login

For more details, please see the appropriate section of the documentations.

Bearer Authentication

Bearer authentication (also called token authentication) is an HTTP authentication scheme that involves security tokens called bearer tokens.

For more details, please see the appropriate section of the documentations.

Identification of the calling application

Some of the REST API functions can only be used if (in addition to proper user authentication) a declaration of the calling application is also performed.

For more details, please see the appropriate section of the documentations.

Actions & Paths

These are the REST actions that can be performed via the Web API infrastructure.
The actions are grouped by "topic".
Click on a "topic" to view the different actions contained in it.

Each action corresponds to a method in the class of the Web API controller, and a set of routing paths that can be used to invoke it.

Explore by topics

Topic name	Most commonly used actions
CRUD	/api/v1/Opportunity/CreateOrUpdate /api/v1/Opportunity/ /api/v1/Opportunity/Exists /api/v1/Opportunity/ /api/v1/Opportunity/Humanize /api/v1/Opportunity/GetFull /api/v1/Opportunity/GetNewInstance
Multiple CRUD	/api/v1/Opportunity/MultipleDelete /api/v1/Opportunity/MultipleExists /api/v1/Opportunity/MultipleGet
Activities	/api/v1/Opportunity/Activities /api/v1/Opportunity/ActivitiesIds /api/v1/Opportunity/Activities/Count
Documents	/api/v1/Opportunity/Documents /api/v1/Opportunity/DocumentsIds /api/v1/Opportunity/Documents/Count
External References	/api/v1/Opportunity/SearchIdsByExternalReference /api/v1/Opportunity/GetByExternalReference /api/v1/Opportunity/DeleteByExternalReference /api/v1/Opportunity/MapByExternalReference /api/v1/Opportunity/ResetExternalReferences /api/v1/Opportunity/UnmapByExternalReference /api/v1/Opportunity/GetIdsMappedByExternalReference /api/v1/Opportunity/GetItemsMappedByExternalReference /api/v1/Opportunity/GetIdsNotMappedByExternalReference /api/v1/Opportunity/GetIdsByExternalReference /api/v1/Opportunity/GetItemsNotMappedByExternalReference
Misc	/api/v1/Opportunity/Referrers /api/v1/Opportunity/SaveReferrer /api/v1/Opportunity/DeleteReferrer /api/v1/Opportunity/SavePartner /api/v1/Opportunity/DeletePartner /api/v1/Opportunity/SaveCompetitor /api/v1/Opportunity/DeleteCompetitor /api/v1/Opportunity/Products /api/v1/Opportunity/SaveProduct /api/v1/Opportunity/DeleteProduct /api/v1/Opportunity/RecentOpportunities /api/v1/Opportunity/Sum /api/v1/Opportunity/Average /api/v1/Opportunity/WeightedSum /api/v1/Opportunity/WeightedAverage /api/v1/Opportunity/CreateQuote /api/v1/Opportunity/Kanban /api/v1/Opportunity/Templates /api/v1/Opportunity/HtmlPreview /api/v1/Opportunity/GetDownloadUrl /api/v1/Opportunity/Archive /api/v1/Opportunity/Photo /api/v1/Opportunity/GetSample /api/v1/Opportunity/GetBoDeleteModes /api/v1/Opportunity/FreeFields /api/v1/Opportunity/Recent /api/v1/Opportunity/GetHash /api/v1/Opportunity/PrintableFields
OData	/api/v1/Opportunity/SearchIds /api/v1/Opportunity/Search /api/v1/Opportunity/Count
Preview	/api/v1/Opportunity/Previews /api/v1/Opportunity/Preview
Swagger	/api/v1/Opportunity/GetPolymorphicSchema /api/v1/Opportunity/GetStandardSchema /api/v1/Opportunity/GetSwagger

GET: /api/v1/Opportunity/

Routing template:

/api/{version}/Opportunity/

Produces:

HTTP 200: Int64 as application/json
HTTP 200: Int64 as text/json
HTTP 200: Int64 as application/xml
HTTP 200: Int64 as text/plain
HTTP 200: Int64 as application/octet-stream

Name	Type	Required	In	Features
id	integer	YES	Path	Format: int64
template	string	NO	Query
request	OpportunityPrintableRequest	NO	Query

Name	Type	Required	In	Features
externalReference	string	NO	Query
excludeDeletedItems	boolean	NO	Query

Name	Type	Required	In	Features
serializePropertiesAsDictionary	boolean	NO	Query	Default: True
honorAcceptLanguageHeader	boolean	NO	Query	Default: False
generateSample	boolean	NO	Query	Default: False
sampleGenerationStrategy	SampleGenerationStrategy	NO	Query
useExtensions	boolean	NO	Query	Default: True
includeExplicitlyDeclaredVirtualProperties	boolean	NO	Query	Default: False

Name	Type	Required	In	Features
force	boolean	NO	Query	Default: False
sampleGenerationStrategy	SampleGenerationStrategy	NO	Query
useExtensions	boolean	NO	Query	Default: True

Name	Type	Required	In	Features
includeFull	boolean	NO	Query	Default: True
includeNesting	boolean	NO	Query	Default: True

Name	Type	Required	In	Features
filter	string	NO	Query
orderBy	string	NO	Query
skip	integer	NO	Query	Format: int64
top	integer	NO	Query	Format: int64
select	string	NO	Query

Name	Description
Account_SkillDTO	Account_Skill
AccountAccessLevel	Account Access Level
AccountDTO	Account
AccountStatus	Account Status
AccountTierAccessPermitDTO	Account Tier Access Permit
ActivityBOActivityRelationDTO	Activity BO Activity Relation
ActivityBOHourBandDTO	Activity BO Hour Band
ActivityCostBOPriceDetailDTO	Activity Cost BO Price Detail
ActivityDTO	Activity
ActivityEMailDataDTO	Activity EMail Data
ActivityFaxDataDTO	Activity Fax Data
ActivityPriorities	Activity Priorities
ActivitySource	Activity Source
ActivityStates	Activity States
ActivityType	Activity Type
AddressAccuracy	Address Accuracy
AddressDTO	Address
AddressesListDTO	Addresses List
AlarmActionType	Alarm Action Type
AlarmDTO	Alarm
AlarmNotificationDTO	Alarm Notification
AlarmTimeValueType	Alarm Time Value Type
AnagraphicStatus	Anagraphic Status
ApprovedStatus	Approved Status
BoDeleteMode	Bo Delete Mode
BusinessObjectType	Business Object Type
ContactDTO	Contact
ContactOtherCompanyDTO	Contact Other Company
CRMTables	CRM Tables
CrossActivityWith	Cross Activity With
CrossType	Cross Type
DefaultCodeType	Default Code Type
DefaultDocumentCategories	Default Document Categories
DeleteItemResult	Delete Item Result
DirectionDTO	Direction
DTOPropertyUsage	DTO Property Usage
EMailNormalizedDTO	EMail Normalized
EMailNormalizeType	EMail Normalize Type
ERPBaseCalcTotalDocumentResultDTO	ERP Base Calc Total Document Result
ErpDocumentStatus	Erp Document Status
ErpGroupingType	Erp Grouping Type
ERPRowDocumentReferenceDTO	ERP Row Document Reference
ERPRowDTO	ERP Row
ERPRowExtensionDTO	ERP Row Extension
ERPRowGroupingDTO	ERP Row Grouping
ERPRowGroupingExtensionDTO	ERP Row Grouping Extension
ERPRowType	ERP Row Type
ExistsItemResult	Exists Item Result
ExternalReferenceDTO	External Reference
FileCrossAttributes	File Cross Attributes
FileCrossDTO	File Cross
FileCrossTypes	File Cross Types
FilePreview	File Preview
FilterDate	Filter Date
FlowLinkDTO	Flow Link
FreeFieldsBOItemDTO	Free Fields BO Item
FreeFieldsBOItemLocalizingDTO	Free Fields BO Item Localizing
FreeFieldsBOTreeItemDTO	Free Fields BO Tree Item
FreeFieldsType	Free Fields Type
Gender	Gender
GeoDTO	Geo
GetIdsMappedByExternalReferenceRequest	Get Ids Mapped By External Reference Request
GetItemResult`1[]	Get Item Result`1
GetItemsMappedByExternalReferenceRequest	Get Items Mapped By External Reference Request
Gravity	Gravity
InfluencerRoleType	Influencer Role Type
InvoiceBOTaxSummaryDTO	Invoice BO Tax Summary
InvoiceType	Invoice Type
JToken	J Token
KanbanPhaseGroup	Kanban Phase Group
LinkItem	Link Item
LiquidStruct	Liquid Struct
ListMailingListRightsDTO	List Mailing List Rights
LocalizeType	Localize Type
LocalizingDTO	Localizing
LocationDTO	Location
MailAddressDTO	Mail Address
MailingListRightsDTO	Mailing List Rights
MultipleDeleteModel	Multiple Delete Model
MultipleExistsModel	Multiple Exists Model
MultipleGetModel	Multiple Get Model
NormalizerNormalizeAddressDTO	Normalizer Normalize Address
NormalizerNormalizeCityDTO	Normalizer Normalize City
NotifyAppointmentMode	Notify Appointment Mode
ObjectPolicy	Object Policy
OpportunityCompetitorDTO	Opportunity Competitor
OpportunityDTO	Opportunity
OpportunityPartnerDTO	Opportunity Partner
OpportunityPrintableRequest	Opportunity Printable Request
OpportunityProductDTO	Opportunity Product
OpportunityReferrerDTO	Opportunity Referrer
OpportunityRefStatusType	Opportunity Ref Status Type
OpportunityStatus	Opportunity Status
PaymentMovementsBOMovementRowsDTO	Payment Movements BO Movement Rows
PaymentMovementsDTO	Payment Movements
PhoneNormalizedDTO	Phone Normalized
PhoneNormalizeType	Phone Normalize Type
PolicyKind	Policy Kind
PrivacyActivityMotivationImplicitConsentDTO	Privacy Activity Motivation Implicit Consent
PrivacyManagementDTO	Privacy Management
PrivacyTypeManagementDTO	Privacy Type Management
QuoteDTO	Quote
QuoteStage	Quote Stage
RelationDTO	Relation
RowContentType	Row Content Type
RowTypeGiftVatMode	Row Type Gift Vat Mode
SampleGenerationStrategy	Sample Generation Strategy
ServiceCrossType	Service Cross Type
SharePermissionDTO	Share Permission
SharingDTO	Sharing
ShippedBy	Shipped By
StorageDTO	Storage
StoragePermission	Storage Permission
SubAccountType	Sub Account Type
SyncPropertyFlag	Sync Property Flag
ToDoStates	To Do States
TypePrivacy	Type Privacy
WebApiKeyDomainDTO	Web Api Key Domain
WebApiKeyDTO	Web Api Key

APIv1EnglishOpportunity

Opportunity

Security

Note

Aliases

Authentication

JWT Token

Bearer Authentication

Identification of the calling application

Actions & Paths

GET: /api/v1/Opportunity/

Routing template:

Produces:

Response: 200 (Success) ApiActionResult

Samples

Try this !

DELETE: /api/v1/Opportunity/{id}

Parameters:

Produces:

Response: 200 (Success) Boolean

Samples

Try this !

GET: /api/v1/Opportunity/{id}

Parameters:

Produces:

Response: 200 (Success) OpportunityDTO

Samples

Try this !

GET: /api/v1/Opportunity/{id}/Activities

Parameters:

Produces:

Response: 200 (Success) ActivityDTO

Samples

Try this !

GET: /api/v1/Opportunity/{id}/Activities/Count

Parameters:

Produces:

Response: 200 (Success) Int64

Samples

Try this !

GET: /api/v1/Opportunity/{id}/ActivitiesIds

Parameters:

Produces:

Response: 200 (Success) Int64

Samples

Try this !

GET: /api/v1/Opportunity/{id}/Archive

Parameters:

Produces:

Response: 400 (Bad Request) integer

Samples

Try this !

DELETE: /api/v1/Opportunity/{id}/DeleteCompetitor

Parameters:

Produces:

Response: 200 (Success) boolean

Samples

Try this !

DELETE: /api/v1/Opportunity/{id}/DeletePartner

Parameters:

Produces:

Response: 200 (Success) boolean

Samples

Try this !

DELETE: /api/v1/Opportunity/{id}/DeleteProduct

Parameters:

Produces:

Response: 400 (Bad Request) boolean

Samples

Try this !

DELETE: /api/v1/Opportunity/{id}/DeleteReferrer

Parameters:

Produces:

Response: 200 (Success) boolean

Samples

Try this !

GET: /api/v1/Opportunity/{id}/Documents

Parameters:

Produces:

Response: 200 (Success) StorageDTO

API v1 English Opportunity