Home
Version 3
Events API

Events API

Retrieve a Particular Event

GET /v2/events/:guid

Request

Route

GET /v2/events/a595fe2f-01ff-4965-a50c-290258ab8582

Headers

Authorization: bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoidWFhLWlkLTM3IiwiZW1haWwiOiJlbWFpbC0zMkBzb21lZG9tYWluLmNvbSIsInNjb3BlIjpbImNsb3VkX2NvbnRyb2xsZXIuYWRtaW4iXSwiYXVkIjpbImNsb3VkX2NvbnRyb2xsZXIiXSwiZXhwIjoxNDY2MDA4ODgzfQ.9Z59B6sbOxTtFqHdOKwLd-XznsNKZbYe8sKU4Sun_jg
Host: example.org
Cookie: 

cURL

curl "https://api.[your-domain.com]/v2/events/a595fe2f-01ff-4965-a50c-290258ab8582" -X GET \
	-H "Authorization: bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoidWFhLWlkLTM3IiwiZW1haWwiOiJlbWFpbC0zMkBzb21lZG9tYWluLmNvbSIsInNjb3BlIjpbImNsb3VkX2NvbnRyb2xsZXIuYWRtaW4iXSwiYXVkIjpbImNsb3VkX2NvbnRyb2xsZXIiXSwiZXhwIjoxNDY2MDA4ODgzfQ.9Z59B6sbOxTtFqHdOKwLd-XznsNKZbYe8sKU4Sun_jg" \
	-H "Host: example.org" \
	-H "Cookie: "

Response

Status

200 OK

Body

Name Description Valid Values Example Values
guid The guid of the event.
type The type of the event.
  • app.crash
  • audit.app.copy-bits
  • audit.app.create
  • audit.app.delete-request
  • audit.app.droplet_mapped
  • audit.app.map-route
  • audit.app.package.create
  • audit.app.package.delete
  • audit.app.package.download
  • audit.app.package.upload
  • audit.app.restage
  • audit.app.ssh-authorized
  • audit.app.ssh-unauthorized
  • audit.app.start
  • audit.app.stop
  • audit.app.unmap-route
  • audit.app.update
  • audit.route.create
  • audit.route.delete-request
  • audit.route.update
  • audit.service.create
  • audit.service.delete
  • audit.service.update
  • audit.service_binding.create
  • audit.service_binding.delete
  • audit.service_broker.create
  • audit.service_broker.delete
  • audit.service_broker.update
  • audit.service_dashboard_client.create
  • audit.service_dashboard_client.delete
  • audit.service_instance.bind_route
  • audit.service_instance.create
  • audit.service_instance.delete
  • audit.service_instance.unbind_route
  • audit.service_instance.update
  • audit.service_key.create
  • audit.service_key.delete
  • audit.service_plan.create
  • audit.service_plan.delete
  • audit.service_plan.update
  • audit.service_plan_visibility.create
  • audit.service_plan_visibility.delete
  • audit.service_plan_visibility.update
  • audit.space.create
  • audit.space.delete-request
  • audit.space.update
  • audit.user_provided_service_instance.create
  • audit.user_provided_service_instance.delete
  • audit.user_provided_service_instance.update
  • app.crash
  • audit.app.update
type The type of the event.
  • audit.app.droplet.create
  • audit.app.droplet.delete
  • audit.app.droplet.download
  • audit.app.process.crash
  • audit.app.process.create
  • audit.app.process.delete
  • audit.app.process.scale
  • audit.app.process.terminate_instance
  • audit.app.process.update
  • audit.app.task.cancel
  • audit.app.task.create
  • audit.app.process.crash
actor The GUID of the actor.
actor_type The actor type.
  • service_broker
  • system
  • user
  • v3-process
actor_name The name of the actor.
actee The GUID of the actee.
actee_type The actee type.
  • app
  • route
  • service
  • service_binding
  • service_broker
  • service_dashboard_client
  • service_instance
  • service_key
  • service_plan
  • service_plan_visibility
  • space
  • user_provided_service_instance
  • v3-app (experimental)
  • v3-service-binding (experimental)
actee_name The name of the actee.
timestamp The event creation time.
metadata The additional information about event.
space_guid The guid of the associated space.
organization_guid The guid of the associated organization.
{
  "metadata": {
    "guid": "a595fe2f-01ff-4965-a50c-290258ab8582",
    "url": "/v2/events/a595fe2f-01ff-4965-a50c-290258ab8582",
    "created_at": "2016-06-08T16:41:23Z",
    "updated_at": null
  },
  "entity": {
    "type": "name-191",
    "actor": "guid-d144abe3-3d7b-40d4-b63f-2584798d3ee5",
    "actor_type": "name-192",
    "actor_name": "name-193",
    "actee": "guid-2e3151ba-9a63-4345-9c5b-6d8c238f4e55",
    "actee_type": "name-194",
    "actee_name": "name-195",
    "timestamp": "2016-06-08T16:41:23Z",
    "metadata": {

    },
    "space_guid": "cb97dd25-d4f7-4185-9e6f-ad6e585c207c",
    "organization_guid": "d9be96f5-ea8f-4549-923f-bec882e32e3c"
  }
}

Headers

Content-Type: application/json;charset=utf-8
X-VCAP-Request-ID: b870e2c4-e7bd-4157-8b0b-2c494e6bf31b
Content-Length: 670
X-Content-Type-Options: nosniff