openapi: 3.2.0 info: version: admin-v1 title: Admin API V1 Vendors API servers: - url: https://dogfood.commerce.insitesandbox.com security: [] tags: - name: Vendors paths: /api/v1/admin/Vendors: get: tags: - Vendors summary: Returns the EntitySet Vendors operationId: Vendors_Get parameters: - name: $expand in: query description: Expands related entities inline. required: false schema: type: string - name: $filter in: query description: Filters the results, based on a Boolean condition. required: false schema: type: string - name: $select in: query description: Selects which properties to include in the response. required: false schema: type: string - name: $apply in: query description: Aggregates the results according to one or more transformations. required: false schema: type: string - name: $orderby in: query description: Sorts the results. required: false schema: type: string - name: $top in: query description: Returns only the first n results. required: false schema: type: integer format: int32 - name: $skip in: query description: Skips the first n results. required: false schema: type: integer format: int32 - name: $count in: query description: Includes a count of the matching results in the response. required: false schema: type: boolean responses: '200': description: OK content: '*/*': schema: type: object deprecated: false security: - access_token: [] post: tags: - Vendors summary: Post a new entity to EntitySet Vendors operationId: Vendors_Post requestBody: content: application/json: schema: $ref: '#/components/schemas/Insite.Data.Entities.Vendor' description: The entity to post required: true responses: '200': description: OK content: '*/*': schema: type: object deprecated: false security: - access_token: [] /api/v1/admin/Vendors({id}): get: tags: - Vendors summary: Returns the entity with the key from Vendors operationId: Vendors_GetById parameters: - name: id in: path description: 'key: id' required: true schema: type: string format: uuid - name: $expand in: query description: Expands related entities inline. required: false schema: type: string - name: $select in: query description: Selects which properties to include in the response. required: false schema: type: string responses: '200': description: OK content: '*/*': schema: type: object deprecated: false security: - access_token: [] put: tags: - Vendors summary: Replace entity in EntitySet Vendors operationId: Vendors_PutById parameters: - name: id in: path description: 'key: id' required: true schema: type: string format: uuid requestBody: content: application/json: schema: $ref: '#/components/schemas/Insite.Data.Entities.Vendor' description: The entity to put required: true responses: '200': description: OK content: '*/*': schema: type: object deprecated: false security: - access_token: [] delete: tags: - Vendors summary: Delete entity in EntitySet Vendors operationId: Vendors_DeleteById parameters: - name: id in: path description: 'key: id' required: true schema: type: string format: uuid - name: If-Match in: header description: If-Match header required: false schema: type: string responses: '200': description: OK content: '*/*': schema: type: object deprecated: false security: - access_token: [] patch: tags: - Vendors summary: Update entity in EntitySet Vendors operationId: Vendors_PatchById parameters: - name: id in: path description: 'key: id' required: true schema: type: string format: uuid requestBody: content: application/json: schema: $ref: '#/components/schemas/Insite.Data.Entities.Vendor' description: The entity to patch required: true responses: '200': description: OK content: '*/*': schema: type: object deprecated: false security: - access_token: [] /api/v1/admin/Vendors/Default.Default(): get: tags: - Vendors summary: Call operation Default operationId: Vendors_Default responses: '200': description: OK content: '*/*': schema: type: object deprecated: false security: - access_token: [] /api/v1/admin/vendors/delete: delete: tags: - Vendors operationId: Vendors_DeleteRoute parameters: - name: ids in: query required: true explode: true schema: type: array items: type: string format: uuid responses: '200': description: OK content: '*/*': schema: type: object deprecated: false security: - access_token: [] /api/v1/admin/vendors({key})/customproperties({custompropertyKey}): get: tags: - Vendors operationId: Vendors_GetCustomPropertyByKeyAndCustompropertykey parameters: - name: key in: path required: true schema: type: string format: uuid - name: custompropertyKey in: path required: true schema: type: string format: uuid - name: $expand in: query description: Expands related entities inline. required: false schema: type: string - name: $select in: query description: Selects which properties to include in the response. required: false schema: type: string responses: '200': description: OK content: '*/*': schema: type: object deprecated: false security: - access_token: [] /api/v1/admin/vendors({key})/products({productKey}): get: tags: - Vendors operationId: Vendors_GetProductByKeyAndProductkey parameters: - name: key in: path required: true schema: type: string format: uuid - name: productKey in: path required: true schema: type: string format: uuid - name: $expand in: query description: Expands related entities inline. required: false schema: type: string - name: $select in: query description: Selects which properties to include in the response. required: false schema: type: string responses: '200': description: OK content: '*/*': schema: type: object deprecated: false security: - access_token: [] components: schemas: Insite.Data.Entities.Vendor: required: - vendorNumber - name - address1 - address2 - city - state - postalCode - websiteAddress - contactName - contactEmail - phone - vendorMessage type: object properties: id: format: uuid type: string example: 00000000-0000-0000-0000-000000000000 vendorNumber: maxLength: 50 minLength: 0 type: string name: maxLength: 255 minLength: 0 type: string address1: maxLength: 100 minLength: 0 type: string address2: maxLength: 100 minLength: 0 type: string city: maxLength: 100 minLength: 0 type: string state: maxLength: 50 minLength: 0 type: string postalCode: maxLength: 50 minLength: 0 type: string websiteAddress: maxLength: 255 minLength: 0 type: string contactName: maxLength: 255 minLength: 0 type: string contactEmail: maxLength: 255 minLength: 0 type: string phone: maxLength: 50 minLength: 0 type: string ranking: format: int32 type: integer regularMarkup: format: decimal type: number saleMarkup: format: decimal type: number vendorMessage: type: string countryId: format: uuid type: string example: 00000000-0000-0000-0000-000000000000 createdOn: format: date-time type: string createdBy: type: string modifiedOn: format: date-time type: string modifiedBy: type: string securitySchemes: access_token: type: apiKey description: Token used to access storefront API. name: access_token in: query