{"method":"GET","path":"https://api.revcent.com/v2/site_events","summary":"Get Site Events","description":"Returns a list of site events previously created. A site event is created when certain actions occur related to a site, such as deployments, catalog updates, etc. The date_start, date_end, page and limit URL parameters are required. The difference between date_start and date_end cannot exceed a 90 day period. View markdown documentation at https://revcent.com/documentation/markdown/mcp/operation/GetSiteEvents.md for an in-depth overview of this operation.","operationId":"GetSiteEvents","parameters":[{"description":"The date range start date as a unix timestamp in seconds.","in":"query","name":"date_start","required":true,"schema":{"type":"integer","format":"unix-time"},"style":"form"},{"description":"The date range end date as a unix timestamp in seconds.","in":"query","name":"date_end","required":true,"schema":{"type":"integer","format":"unix-time"},"style":"form"},{"description":"A limit on the number of objects to be returned. Limit can range between 1 and 25, and the default is 25.","in":"query","name":"limit","required":true,"schema":{"type":"integer","format":"int32","minimum":1,"maximum":25},"style":"form"},{"description":"Used for pagination, i.e. to skip to specific page of results.","in":"query","name":"page","required":true,"schema":{"type":"integer","format":"int32"},"style":"form"},{"name":"site_filter","in":"query","description":"To filter items based on one or more associated RevCent Sites.","required":false,"schema":{"type":"array","items":{"type":"string","description":"A 20 character site ID.","minLength":20,"maxLength":20}},"style":"form","explode":true}],"requestBody":{"content":{"application/x-www-form-urlencoded":{"encoding":{},"schema":{"additionalProperties":false,"properties":{},"type":"object"}}},"required":false},"responses":{"200":{"content":{"application/json":{"schema":{"description":"","properties":{"api_call_id":{"type":"string","description":"A 20 character API call ID.","minLength":20,"maxLength":20},"api_call_unix":{"description":"Unix timestamp of when the API call was initiated.","type":"integer","format":"unix-time"},"code":{"description":"API call response code.","type":"integer","format":"int32","enum":[1]},"current_count":{"description":"The current number of items in the results.","type":"integer"},"current_page":{"description":"The current page for the items in the results.","type":"integer"},"results":{"items":{"allOf":[{"type":"object","description":"A site event is an update related to a site, such as deployments, catalog updates, etc.","additionalProperties":false,"properties":{"created_date_unix":{"description":"The unix timestamp of when the item was created.","type":"integer","format":"unix-time"},"id":{"type":"string","description":"A 20 character site ID.","minLength":20,"maxLength":20},"trigger":{"description":"The trigger that created the site event.","type":"string"},"site":{"type":"object","additionalProperties":false,"description":"The site associated with the site event.","properties":{"id":{"type":"string","description":"A 20 character site ID.","minLength":20,"maxLength":20},"name":{"description":"The site name.","type":"string"}}},"branch":{"description":"The site branch related to the event, if applicable. Some events apply to both branches, or do not apply to a branch, so this property may not be present.","type":"string","enum":["main","dev"]},"sha":{"type":"string","description":"The Git commit SHA related to the site event, if applicable. Some events do not apply to a specific commit, so this property may not be present."},"product_count":{"type":"integer","description":"The number of products associated with the site event, if the site event updated the site catalog. Some events do not update the site catalog, so this property may not be present."},"status":{"description":"A status property which may be returned for certain site events. For example, the site event trigger 'site_create' will return a status of 'succeeded' if the site was successfully created.","type":"string"},"updated_date_unix":{"description":"The unix timestamp of when the item was last updated.","type":"integer","format":"unix-time"}}}]},"type":"array"},"total_count":{"description":"The total number of items found given the date_start and date_end query parameters.","type":"integer"},"total_pages":{"description":"The total number of pages given the date_start, date_end and limit query parameters.","type":"integer"}},"type":"object","additionalProperties":false}}},"description":"Successful response."},"default":{"content":{"application/json":{"schema":{"description":"","properties":{"api_call_id":{"type":"string","description":"A 20 character API call ID.","minLength":20,"maxLength":20},"api_call_unix":{"description":"Unix timestamp of when the API call was initiated.","type":"integer","format":"unix-time"},"code":{"description":"This value indicates that there is an error. Will always be 0.","type":"integer","enum":[0]},"error_code":{"description":"The specific error code.","type":"string"},"message":{"description":"A human readable description of the error.","type":"string"},"result":{"description":"A description of the API call result.","type":"string"}},"title":"APIStandardErrors","type":"object","additionalProperties":false}}},"description":"Error response."}}}