Automile ResourceOwnerContact2 API
The ResourceOwnerContact2 API from Automile — 12 operation(s) for resourceownercontact2.
OpenAPI Specification
swagger: '2.0'
info:
title: Automile ClientApi ResourceOwnerContact2 API
version: v1
tags:
- name: ResourceOwnerContact2
paths:
/v1/resourceowner/contacts2:
get:
tags:
- ResourceOwnerContact2
summary: Get a list of all contacts that user is associated with
description: Only companies that the user is associated with will be returned by this operation.
operationId: GetResourceOwnerContacts2
produces:
- text/plain
- application/json
- text/json
responses:
'200':
description: The contacts are returned
schema:
type: array
items:
$ref: '#/definitions/Contact2Model'
'500':
description: Internal server error
security:
- oauth2: []
post:
tags:
- ResourceOwnerContact2
summary: Creates a new contact
operationId: CreateResourceOwnerContact2
consumes:
- application/json
- text/json
- application/*+json
produces:
- text/plain
- application/json
- text/json
parameters:
- in: body
name: body
description: The contact model
schema:
$ref: '#/definitions/Contact2CreateModel'
responses:
'200':
description: A link in the header is returned to the newly created contact
'403':
description: Request is forbidden, this could occur if you try to associate the contact you are not associated with
schema:
$ref: '#/definitions/ProblemDetails'
'500':
description: Internal server error
security:
- oauth2: []
/v1/resourceowner/contacts2/{contactId}:
get:
tags:
- ResourceOwnerContact2
summary: Get a contact by id
description: The user only has access to companies that it is associated with
operationId: GetResourceOwnerContact2
produces:
- text/plain
- application/json
- text/json
parameters:
- in: path
name: contactId
description: The contact id
required: true
type: integer
format: int32
responses:
'200':
description: The contact is returned
schema:
$ref: '#/definitions/Contact2DetailModel'
'403':
description: Request is forbidden, meaning you dont' have access to this contact
schema:
$ref: '#/definitions/ProblemDetails'
'404':
description: Contact does not exist
schema:
$ref: '#/definitions/ProblemDetails'
'500':
description: Internal server error
security:
- oauth2: []
put:
tags:
- ResourceOwnerContact2
summary: Updates the given contact id
description: This will update the contact with the new model.
operationId: EditResourceOwnerContact2
consumes:
- application/json
- text/json
- application/*+json
produces:
- text/plain
- application/json
- text/json
parameters:
- in: path
name: contactId
description: The contact that should be updated
required: true
type: integer
format: int32
- in: body
name: body
description: The new contact model
schema:
$ref: '#/definitions/Contact2EditModel'
responses:
'200':
description: The contact was saved
'404':
description: The contact that you tried to update doesn't exist
schema:
$ref: '#/definitions/ProblemDetails'
'403':
description: Request is forbidden, this could occur if you are not associated with the contact
schema:
$ref: '#/definitions/ProblemDetails'
'500':
description: Internal server error
security:
- oauth2: []
delete:
tags:
- ResourceOwnerContact2
summary: Removes the given contact
operationId: DeleteResourceOwnerContact2
produces:
- text/plain
- application/json
- text/json
parameters:
- in: path
name: contactId
description: The company id
required: true
type: integer
format: int32
responses:
'200':
description: The contact has been deleted
'403':
description: Forbidden
schema:
$ref: '#/definitions/ProblemDetails'
'404':
description: The contact that you tried to remove doesn't exist
schema:
$ref: '#/definitions/ProblemDetails'
'500':
description: Internal server error
'400':
description: Request is bad, You can't delete a contact that is bound to a user
security:
- oauth2: []
/v1/resourceowner/contacts2/me:
get:
tags:
- ResourceOwnerContact2
summary: Get the contact representing myself
operationId: GetResourceOwnerContactMe2
produces:
- text/plain
- application/json
- text/json
responses:
'200':
description: The contact is returned
schema:
$ref: '#/definitions/Contact2DetailModel'
'403':
description: Request is forbidden, meaning you dont' have access to this contact
schema:
$ref: '#/definitions/ProblemDetails'
'404':
description: Contact does not exist
schema:
$ref: '#/definitions/ProblemDetails'
'500':
description: Internal server error
security:
- oauth2: []
/v1/resourceowner/contacts2/me/image:
get:
tags:
- ResourceOwnerContact2
summary: Get contact profile image
description: This will get the contact profile image, image data is returned in the response content
operationId: GetImage
parameters:
- in: query
name: imageType
description: enum ApiImageType
type: integer
format: int32
enum:
- 0
- 1
responses:
'200':
description: Success
security:
- oauth2: []
/v1/resourceowner/contacts2/me/uploadimage:
post:
tags:
- ResourceOwnerContact2
summary: Upload contact profile image
description: This updates the contact profile image
operationId: MeUploadImage
consumes:
- multipart/form-data
parameters:
- in: formData
name: ContentType
type: string
- in: formData
name: ContentDisposition
type: string
- in: formData
name: Headers
type: string
- in: formData
name: Length
type: integer
format: int64
- in: formData
name: Name
type: string
- in: formData
name: FileName
type: string
responses:
'200':
description: Profile image was saved
'500':
description: Internal server error
'406':
description: Request is not properly formatted
security:
- oauth2: []
/v1/resourceowner/contacts2/me/removeimage:
put:
tags:
- ResourceOwnerContact2
summary: Removes the users profile image"
description: This removes the contact profile image
operationId: MeRemoveImage
responses:
'200':
description: The profile image has been deleted
'500':
description: Internal server error
security:
- oauth2: []
/v1/resourceowner/contacts2/update-rfid:
post:
tags:
- ResourceOwnerContact2
operationId: UpdateRfidResourceOwnerContact2
consumes:
- application/json
- text/json
- application/*+json
parameters:
- in: body
name: body
schema:
$ref: '#/definitions/Contact2UpdateRfidModel'
responses:
'200':
description: Success
security:
- oauth2: []
/v1/resourceowner/contacts2/me/updatedefaultvehicle/{vehicleId}:
put:
tags:
- ResourceOwnerContact2
summary: Updates the default vehicle
description: This will update the default vehicle
operationId: MeUpdateDefaultVehicle2
produces:
- text/plain
- application/json
- text/json
parameters:
- in: path
name: vehicleId
description: The vehicle id
required: true
type: integer
format: int32
responses:
'200':
description: The default vehicle on contact was saved
'403':
description: Request is forbidden, this could occur if you are not associated with the contact
schema:
$ref: '#/definitions/ProblemDetails'
'500':
description: Internal server error
security:
- oauth2: []
/v1/resourceowner/contacts2/updatedefaultvehicle/{vehicleId}:
put:
tags:
- ResourceOwnerContact2
summary: Updates the default vehicle
description: This will update the default vehicle
operationId: UpdateResourceOwnerContactDefaultVehicle2
produces:
- text/plain
- application/json
- text/json
parameters:
- in: path
name: vehicleId
description: The vehicle id
required: true
type: integer
format: int32
responses:
'200':
description: The default vehicle on contact was saved
'403':
description: Request is forbidden, this could occur if you are not associated with the contact
schema:
$ref: '#/definitions/ProblemDetails'
'500':
description: Internal server error
security:
- oauth2: []
/v1/resourceowner/contacts2/customcategory:
post:
tags:
- ResourceOwnerContact2
summary: Add and remove custom categories
operationId: ResourceOwnerContact2CustomCategory
consumes:
- application/json
- text/json
- application/*+json
parameters:
- in: body
name: body
description: The contact model
schema:
$ref: '#/definitions/CustomCategoryPostModel'
responses:
'200':
description: ''
'500':
description: Internal server error
security:
- oauth2: []
/v1/resourceowner/contacts2/{contactId}/customcategories/{customCategoryId}:
get:
tags:
- ResourceOwnerContact2
summary: Get a custom category
description: ''
operationId: GetCustomCategoryResourceOwnerContacts2
produces:
- text/plain
- application/json
- text/json
parameters:
- in: path
name: contactId
required: true
type: integer
format: int32
- in: path
name: customCategoryId
required: true
type: integer
format: int32
responses:
'200':
description: ''
schema:
$ref: '#/definitions/CustomCategoryModel'
'500':
description: Internal server error
security:
- oauth2: []
/v1/resourceowner/contacts2/{contactId}/customcategories:
get:
tags:
- ResourceOwnerContact2
summary: Get a all custom categories
description: ''
operationId: GetCustomCategoriesResourceOwnerContacts2
produces:
- text/plain
- application/json
- text/json
parameters:
- in: path
name: contactId
required: true
type: integer
format: int32
responses:
'200':
description: ''
schema:
$ref: '#/definitions/CustomCategoryModel'
'500':
description: Internal server error
security:
- oauth2: []
definitions:
Contact2UpdateRfidModel:
type: object
properties:
Email:
type: string
Rfid:
type: string
additionalProperties: false
CustomCategoryPostModel:
type: object
properties:
ContactId:
format: int32
type: integer
Added:
description: Custom categories to add
type: array
items:
$ref: '#/definitions/CustomCategoryCreateModel'
Removed:
description: Custom categories to delete
type: array
items:
format: int32
type: integer
additionalProperties: false
CompanyScopesModel:
type: object
properties:
CompanyId:
format: int32
type: integer
VehicleIds:
type: array
items:
format: int32
type: integer
Scopes:
type: array
items:
type: string
additionalProperties: false
Contact2Model:
type: object
properties:
ContactId:
format: int32
type: integer
FirstName:
type: string
LastName:
type: string
EmailAddress:
type: string
MobilePhoneNumber:
type: string
ProfileImageUrl:
type: string
CheckedInDateTimeUtc:
format: date-time
type: string
CheckedIntoVehicleId:
format: int32
type: integer
CheckedInVehicleOdometerInKilometers:
format: double
type: number
IsManager:
type: boolean
LastCheckedInTripType:
format: int32
enum:
- 0
- 1
- 2
- 3
type: integer
CheckedInCustomTripTypeName:
type: string
CompanyRoles:
type: array
items:
format: int32
enum:
- 0
- 1
- 2
- 3
- 4
- 5
type: integer
CurrencyCode:
description: ISO 4217 Currency code
type: string
additionalProperties: false
TimeSpan:
type: object
properties:
Ticks:
format: int64
type: integer
Days:
format: int32
type: integer
readOnly: true
Hours:
format: int32
type: integer
readOnly: true
Milliseconds:
format: int32
type: integer
readOnly: true
Microseconds:
format: int32
type: integer
readOnly: true
Nanoseconds:
format: int32
type: integer
readOnly: true
Minutes:
format: int32
type: integer
readOnly: true
Seconds:
format: int32
type: integer
readOnly: true
TotalDays:
format: double
type: number
readOnly: true
TotalHours:
format: double
type: number
readOnly: true
TotalMilliseconds:
format: double
type: number
readOnly: true
TotalMicroseconds:
format: double
type: number
readOnly: true
TotalNanoseconds:
format: double
type: number
readOnly: true
TotalMinutes:
format: double
type: number
readOnly: true
TotalSeconds:
format: double
type: number
readOnly: true
additionalProperties: false
HoursOfServiceSettingsModel:
type: object
properties:
TimeZoneType:
format: int32
enum:
- 0
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
type: integer
WorkDayStartTime:
$ref: '#/definitions/TimeSpan'
CycleRuleType:
format: int32
enum:
- 0
- 1
- 2
- 3
- 4
- 5
- 6
- 7
type: integer
CargoTypeType:
format: int32
enum:
- 0
- 1
- 2
type: integer
RestartRuleType:
format: int32
enum:
- 0
- 1
type: integer
RestBreakRuleType:
format: int32
enum:
- 0
- 1
type: integer
ShortHaulExceptionType:
format: int32
enum:
- 0
- 1
type: integer
OdometerUnitType:
format: int32
enum:
- 0
- 1
- 2
type: integer
WellSiteRuleType:
format: int32
enum:
- 0
- 1
type: integer
CarrierInfo:
$ref: '#/definitions/AddressModel'
IsEnabled:
type: boolean
additionalProperties: false
OrganizationModel:
type: object
properties:
OrganizationName:
type: string
LegalIdentificationNumber:
type: string
VATNumber:
type: string
BillingAddress:
$ref: '#/definitions/AddressModel'
ShipmentAddress:
$ref: '#/definitions/AddressModel'
Culture:
type: string
UnitType:
format: int32
enum:
- 0
- 1
- 2
type: integer
IsHierarchyEnabled:
type: boolean
ISO4217CurrencyCode:
type: string
OrganizationId:
format: int32
type: integer
additionalProperties: false
Contact2DetailModel:
type: object
properties:
ContactId:
format: int32
type: integer
FirstName:
type: string
LastName:
type: string
EmailAddress:
type: string
Description:
type: string
CultureName:
type: string
CountryCodeIso1366:
type: string
DefaultVehicleId:
format: int32
type: integer
UnitType:
format: int32
enum:
- 0
- 1
- 2
type: integer
SubscribeToNewsLetter:
type: boolean
MobilePhoneNumber:
type: string
MapType:
format: int32
enum:
- 0
- 1
- 2
type: integer
CheckedIntoVehicleId:
format: int32
type: integer
CheckedInDateTimeUtc:
format: date-time
type: string
CheckOutDateTimeUtc:
format: date-time
type: string
CheckedInTripType:
format: int32
enum:
- 0
- 1
- 2
- 3
type: integer
CheckedInCustomTripTypeName:
type: string
CompanyRoles:
type: array
items:
format: int32
enum:
- 0
- 1
- 2
- 3
- 4
- 5
type: integer
ProfileImageUrl:
type: string
CurrencyCode:
description: ISO 4217 Currency code
type: string
CompaniesScopes:
type: array
items:
$ref: '#/definitions/CompanyScopesModel'
IsLocked:
type: boolean
CustomCategories:
type: array
items:
$ref: '#/definitions/CustomCategoryModel'
CheckedInVehicleOdometerInKilometers:
format: double
type: number
Organization:
$ref: '#/definitions/OrganizationModel'
HoursOfServiceSettingsModel:
$ref: '#/definitions/HoursOfServiceSettingsModel'
FieldServiceEnabled:
type: boolean
FieldServiceEnabledWithinOrganization:
type: boolean
ContactMenuLayout:
$ref: '#/definitions/ContactMenuLayoutModel'
CreatedAt:
format: date-time
type: string
additionalProperties: false
AddressModel:
required:
- AddressLine2
- City
- ISO3166CountryCode
- ZipCode
type: object
properties:
AddressId:
format: int32
type: integer
CompanyName:
type: string
ContactNameAtAddress:
type: string
AddressLine2:
minLength: 1
type: string
AddressLine3:
type: string
AddressLine4:
type: string
ZipCode:
minLength: 1
type: string
City:
minLength: 1
type: string
StateOrProvince:
type: string
ISO3166CountryCode:
minLength: 1
type: string
additionalProperties: false
Contact2EditModel:
type: object
properties:
FirstName:
type: string
LastName:
type: string
EmailAddress:
type: string
Description:
type: string
CultureName:
type: string
CountryCodeIso1366:
type: string
DefaultVehicleId:
format: int32
type: integer
UnitType:
format: int32
enum:
- 0
- 1
- 2
type: integer
SubscribeToNewsLetter:
type: boolean
MobilePhoneNumber:
type: string
MapType:
format: int32
enum:
- 0
- 1
- 2
type: integer
CheckOutDateTimeUtc:
format: date-time
type: string
CheckedInTripType:
format: int32
enum:
- 0
- 1
- 2
- 3
type: integer
CheckedInCustomTripTypeName:
type: string
CurrencyCode:
description: ISO 4217 Currency code
type: string
additionalProperties: false
ContactMenuLayoutModel:
type: object
properties:
MenuLayout:
type: object
additionalProperties:
format: int64
enum:
- 0
- 1
- 2
- 4
type: integer
readOnly: true
ExpiresAtUtc:
format: date-time
description: UTC date time when menu layout cache was refreshed
type: string
RefreshedAtUtc:
format: date-time
description: UTC date time when menu layout cache was refreshed
type: string
additionalProperties: false
ProblemDetails:
type: object
properties:
type:
type: string
title:
type: string
status:
format: int32
type: integer
detail:
type: string
instance:
type: string
additionalProperties: {}
Contact2CreateModel:
required:
- CreateRelationshipToCompanyId
- FirstName
- LastName
type: object
properties:
FirstName:
minLength: 1
type: string
LastName:
minLength: 1
type: string
EmailAddress:
type: string
Description:
type: string
CreateRelationshipToCompanyId:
format: int32
type: integer
CultureName:
type: string
CountryCodeIso1366:
type: string
DefaultVehicleId:
format: int32
type: integer
UnitType:
format: int32
enum:
- 0
- 1
- 2
type: integer
SubscribeToNewsLetter:
type: boolean
MobilePhoneNumber:
type: string
MapType:
format: int32
enum:
- 0
- 1
- 2
type: integer
CurrencyCode:
description: ISO 4217 Currency code
type: string
additionalProperties: false
CustomCategoryCreateModel:
type: object
properties:
Value:
type: string
CustomCategoryType:
format: int32
enum:
- 0
- 1
type: integer
additionalProperties: false
CustomCategoryModel:
type: object
properties:
CustomCategoryId:
format: int32
type: integer
Value:
type: string
CustomCategoryType:
format: int32
enum:
- 0
- 1
type: integer
additionalProperties: false
securityDefinitions:
oauth2:
type: oauth2
flow: implicit
authorizationUrl: https://api.automile.com/login/
scopes:
read: Read access to protected resources
write: Write access to protected resources
description: OAuth2 Implicit Grant