Docs

Events

GET
/v1/events

Retrieve all events.

AuthorizationBearer <token>

API key for authentication, must be provided as a Bearer token. Generate an API key at https://alien.dev/api-keys

In: header

Query Parameters

workspace?string

Workspace name. Required for user/session/OAuth requests. Optional for API keys because API keys are workspace-scoped; if provided with an API key, it must match the key's workspace.

Match^(?!ws[-_])[a-z0-9](-?[a-z0-9])*$
Length4 <= length <= 100
project?string

Filter by project ID or name.

Lengthlength <= 100
deploymentId?string

Filter events to a single deployment.

releaseId?string

Filter events to a single release.

include?array<>

Optional fields to include: releaseCreatedAt

limit?integer

Maximum number of items to return per page

Range1 <= value <= 100
Default20
cursor?string

Cursor for pagination - omit for first page

Response Body

application/json

application/json

curl -X GET "https://example.com/v1/events?project=my-project"
{  "items": [    {      "id": "event_MtSA24M3pWuAkQYxgZxuRI",      "deploymentId": "dep_0c29fq4a2yjb7kx3smwdgxlc",      "releaseId": "rel_WbhQgksrawSKIpEN0NAssHX9",      "debugSessionId": "dbg_HOXmkmT9UPYlsnxqSNlEGoXL",      "data": {        "type": "LoadingConfiguration"      },      "state": {        "failed": {          "error": {            "code": "string",            "context": null,            "hint": "string",            "httpStatusCode": 100,            "internal": true,            "message": "string",            "retryable": false,            "source": null          }        }      },      "projectId": "prj_mcytp6z3j91f7tn5ryqsfwtr",      "createdAt": "2019-08-24T14:15:22Z",      "workspaceId": "ws_It13CUaGEhLLAB87simX0",      "releaseCreatedAt": "2019-08-24T14:15:22Z"    }  ],  "nextCursor": "string"}
GET
/v1/events/{id}

Retrieve an event by ID.

AuthorizationBearer <token>

API key for authentication, must be provided as a Bearer token. Generate an API key at https://alien.dev/api-keys

In: header

Path Parameters

id*string

Unique identifier for the event.

Matchevent_[0-9a-zA-Z]{28}$

Query Parameters

workspace?string

Workspace name. Required for user/session/OAuth requests. Optional for API keys because API keys are workspace-scoped; if provided with an API key, it must match the key's workspace.

Match^(?!ws[-_])[a-z0-9](-?[a-z0-9])*$
Length4 <= length <= 100

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/v1/events/event_MtSA24M3pWuAkQYxgZxuRI"
{  "id": "event_MtSA24M3pWuAkQYxgZxuRI",  "deploymentId": "dep_0c29fq4a2yjb7kx3smwdgxlc",  "releaseId": "rel_WbhQgksrawSKIpEN0NAssHX9",  "debugSessionId": "dbg_HOXmkmT9UPYlsnxqSNlEGoXL",  "data": {    "type": "LoadingConfiguration"  },  "state": {    "failed": {      "error": {        "code": "string",        "context": null,        "hint": "string",        "httpStatusCode": 100,        "internal": true,        "message": "string",        "retryable": false,        "source": null      }    }  },  "projectId": "prj_mcytp6z3j91f7tn5ryqsfwtr",  "createdAt": "2019-08-24T14:15:22Z",  "workspaceId": "ws_It13CUaGEhLLAB87simX0"}