BokaMera.API.Host

<back to all web services

AddTagsToTimeException

Requires Authentication
Requires any of the roles:bookingsupplier-administrator-write, superadmin
The following routes are available for this service:
POST/timeexceptions/{TimeExceptionId}/tagsAdd tags to a time exceptionAttaches one or more tags to an existing time exception.
AddTagsToTimeException Parameters:
NameParameterData TypeRequiredDescription
CompanyIdbodyGuid?NoThe company id, if empty will use the company id for the user you are logged in with.
TimeExceptionIdpathintYesThe time exception id.
TagIdsbodyList<int>YesThe ids of the tags to attach.
ResourceTimeExceptionQueryResponse Parameters:
NameParameterData TypeRequiredDescription
IdformintNoTime exception id
CompanyIdformGuidNoTime company id
LockedformboolNoIf it's locked for editing for the logged in administrator
ResourceIdsformint[]YesResources that owns this exception
ResourcesformList<TimeExceptionReosurceDetails>YesResources that owns this exception
IsRecurringformboolNoIndicates wheter or not the time exception is recurring
FromformDateTimeNoTime exception starting timestamp
ToformDateTimeNoTime exception ending timestamp
FromTimeformTimeSpanNoIf recurring then this value indicates the time of day when the time exception begins
ToTimeformTimeSpanNoIf recurring then this value indicates the time of day when the time exception ends
ReasonTextformstringYesThe reason of the time exception, example: Vacation, doctors appointment, ...
ReasonTextPublicformstringYesThe reason of the time exception that could be public to customers, example: Vacation, Closed, Sick leave, ...
ColorformstringYesWhat hexadecimal color code the exception should have in the scheduler
BlockTimeformboolNoIf the time exception should block the time in the scheduler so it's not avaialable to book
PrivateformboolNoIf the ReasonText should only be visible to conncted resources. If false, all resources will be able to see it
DaysOfWeekformList<DayOfWeekDto>YesIf recurring, an array indicating which days of the week the exception recurs on where 1 = Monday .. 7 = Sunday. When recurring then the time portion of the Fields From and To indicates the time of day the recurrence occurs
CreatedformDateTimeNoThe datetime the exception was created
TagsformList<TagResponse>YesTags attached to this time exception
ResponseStatusformResponseStatusYes
TimeExceptionReosurceDetails Parameters:
NameParameterData TypeRequiredDescription
IdformintNoIds of the resources that owns this exception
NameformstringYesName of the resource
DescriptionformstringYesDescription of the resource
ColorformstringYesColor of the resource
ImageUrlformUriYesImage of the resource
ResponseStatusformResponseStatusYes
DayOfWeekDto Parameters:
NameParameterData TypeRequiredDescription
DayOfWeekIdformintNo
DotNetDayOfWeekIdformintNo
DayOfWeekformstringYes
TagResponse Parameters:
NameParameterData TypeRequiredDescription
IdformintNo
CompanyIdformGuidNo
NameformstringYes
ScopeformintNo
ColorformstringYes
SortOrderformintNo
ActiveformboolNo
CreatedDateformDateTimeNo
ResponseStatusformResponseStatusYes

To override the Content-type in your clients, use the HTTP Accept Header, append the .other suffix or ?format=other

HTTP + OTHER

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

POST /timeexceptions/{TimeExceptionId}/tags HTTP/1.1 
Host: api.bookmore.com 
Accept: text/jsonl
Content-Type: text/jsonl
Content-Length: length

{"CompanyId":"00000000-0000-0000-0000-000000000000","TimeExceptionId":0,"TagIds":[0]}
HTTP/1.1 200 OK
Content-Type: text/jsonl
Content-Length: length

{"Id":0,"Locked":false,"ResourceIds":[0],"Resources":[{"Id":0,"Name":"String","Description":"String","Color":"String","ResponseStatus":{"ErrorCode":"String","Message":"String","StackTrace":"String","Errors":[{"ErrorCode":"String","FieldName":"String","Message":"String","Meta":{"String":"String"}}],"Meta":{"String":"String"}}}],"IsRecurring":false,"FromTime":"00:00:00","ToTime":"00:00:00","ReasonText":"String","ReasonTextPublic":"String","Color":"String","BlockTime":false,"Private":false,"DaysOfWeek":[{"DayOfWeekId":0,"DotNetDayOfWeekId":0,"DayOfWeek":"String"}],"Tags":[{"Id":0,"Name":"String","Scope":0,"Color":"String","SortOrder":0,"Active":false,"ResponseStatus":{"ErrorCode":"String","Message":"String","StackTrace":"String","Errors":[{"ErrorCode":"String","FieldName":"String","Message":"String","Meta":{"String":"String"}}],"Meta":{"String":"String"}}}],"ResponseStatus":{"ErrorCode":"String","Message":"String","StackTrace":"String","Errors":[{"ErrorCode":"String","FieldName":"String","Message":"String","Meta":{"String":"String"}}],"Meta":{"String":"String"}}}