Home
Version 3
Events API

Events API

Retrieve a Particular Event

GET /v2/events/:guid

Fields

Name Description Default Valid Values Example Values
guid The guid of the event.
type The type of the event.
  • app.crash
  • audit.app.update
  • audit.app.create
  • audit.app.delete-request
  • audit.space.create
  • audit.space.update
  • audit.space.delete-request
  • app.crash
  • audit.app.update
actor The GUID of the actor.
actor_type The actor type.
  • user
  • app
actor_name The name of the actor.
actee The GUID of the actee.
actee_type The actee type.
  • space
  • app
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.

Parameters

Name Description Valid Values Example Values
guid The guid of the Event

Request

Headers

Authorization: bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoidWFhLWlkLTUiLCJlbWFpbCI6ImVtYWlsLTVAc29tZWRvbWFpbi5jb20iLCJzY29wZSI6WyJjbG91ZF9jb250cm9sbGVyLmFkbWluIl0sImF1ZCI6WyJjbG91ZF9jb250cm9sbGVyIl0sImV4cCI6MTQxNzQ2MjM0N30.tzARmjviQ1KO4V_Kv8uM_uUpmEf8gYsH6JvKOvxOW9w
Host: example.org
Cookie: 

Route

GET /v2/events/1b193789-f176-4d28-a7c3-6907d7c01420

cURL

curl "https://api.[your-domain.com]/v2/events/1b193789-f176-4d28-a7c3-6907d7c01420" -X GET \
	-H "Authorization: bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoidWFhLWlkLTUiLCJlbWFpbCI6ImVtYWlsLTVAc29tZWRvbWFpbi5jb20iLCJzY29wZSI6WyJjbG91ZF9jb250cm9sbGVyLmFkbWluIl0sImF1ZCI6WyJjbG91ZF9jb250cm9sbGVyIl0sImV4cCI6MTQxNzQ2MjM0N30.tzARmjviQ1KO4V_Kv8uM_uUpmEf8gYsH6JvKOvxOW9w" \
	-H "Host: example.org" \
	-H "Cookie: "

Response

Headers

Content-Type: application/json;charset=utf-8
X-VCAP-Request-ID: 66bb9263-5a20-42f4-8404-49b408d1f219
Content-Length: 670
X-Content-Type-Options: nosniff

Status

200 OK

Body

{
  "metadata": {
    "guid": "1b193789-f176-4d28-a7c3-6907d7c01420",
    "url": "/v2/events/1b193789-f176-4d28-a7c3-6907d7c01420",
    "created_at": "2014-11-24T19:32:27+00:00",
    "updated_at": null
  },
  "entity": {
    "type": "name-1",
    "actor": "guid-54c54d7e-299f-446a-a7cc-cffcfda97e6f",
    "actor_type": "name-2",
    "actor_name": "name-3",
    "actee": "guid-38a43eaf-be3c-4bc8-a5af-039502d909d7",
    "actee_type": "name-4",
    "actee_name": "name-5",
    "timestamp": "2014-11-24T19:32:27+00:00",
    "metadata": {

    },
    "space_guid": "41d9fcfd-6676-49ab-bad7-c94b7fcab2ab",
    "organization_guid": "e0b9cb90-dea0-438a-8a57-0139c80b57da"
  }
}