user

List User Events

Changed on

Retrieves a list of "events" generated by the User on Vercel. Events are generated when the User performs a particular action, such as logging in, creating a deployment, and joining a Team (just to name a few). When the teamId parameter is supplied, then the events that are returned will be in relation to the Team that was specified.

get/v3/events

Request

  • Base URL: https://api.vercel.com
  • URL: https://api.vercel.com/v3/events
  • Auth: HTTP bearer

Query parameters

limitnumber

Maximum number of items which may be returned.

Example:20
sincestring

Timestamp to only include items created since then.

Example:2019-12-08T10:00:38.976Z
untilstring

Timestamp to only include items created until then.

Example:2019-12-09T23:00:38.976Z
typesstring

Comma-delimited list of event "types" to filter the results by.

Example:login,team-member-join,domain-buy
userIdstring

Deprecated. Use principalId instead. If principalId and userId both exist, principalId will be used.

Example:aeIInYVk59zbFF2SxfyxxmuO
principalIdstring

When retrieving events for a Team, the principalId parameter may be specified to filter events generated by a specific principal.

Example:aeIInYVk59zbFF2SxfyxxmuO
projectIdsstring

Comma-delimited list of project IDs to filter the results by.

Example:aeIInYVk59zbFF2SxfyxxmuO
entityIdstring

Filters events to those associated with a specific entity (matched against payload.id). For example, a connector ID.

Example:scl_123
withPayloadstring

When set to true, the response will include the payload field for each event.

Example:true
teamIdstring
Example:team_1a2b3c4d5e6f7g8h9i0j1k2l

The Team identifier to perform the request on behalf of.

slugstring
Example:my-team-url-slug

The Team slug to perform the request on behalf of.

Response

Successful response.

Example response

{
  "events": [
    {
      "categories": [
        "deployment"
      ],
      "createdAt": 1632859321020,
      "entities": [
        {
          "end": 3,
          "type": "author"
        }
      ],
      "id": "uev_bfmMjiMnXfnPbT97dGdpJbCN",
      "payload": {
        "created": "2021-02-10T13:11:49.180Z",
        "createdAt": 1609492210000,
        "createdBy": "2qDDuGFTWXBLDNnqZfWPDp1A",
        "deletedAt": 1609492210000,
        "deletedBy": "2qDDuGFTWXBLDNnqZfWPDp1A",
        "id": "env_XCG7t7AIHuO2SBA8667zNUiM",
        "key": "my-api-key",
        "ownerId": "team_LLHUOMOoDlqOp8wPE4kFo9pE",
        "projectId": [
          "prj_2WjyKQmM8ZnGcJsPWMrHRHrE",
          "prj_2WjyKQmM8ZnGcJsPWMrasEFg"
        ],
        "target": [
          "production"
        ],
        "type": "encrypted",
        "updatedAt": 1609492210000,
        "updatedBy": "2qDDuGFTWXBLDNnqZfWPDp1A"
      },
      "text": "You logged in via GitHub",
      "type": "login",
      "userId": "zTuNVUXEAvvnNN3IaqinkyMw"
    }
  ]
}

Changes

  • b77731602f79Revision changes
    • warning

      added the new project-git-credential-attestation-created enum value to the // response property for the response status

    • warning

      added the new project-git-credential-attestation-deleted enum value to the // response property for the response status

    • warning

      added the new project-git-credential-grant-attestation-revoked enum value to the // response property for the response status

    • warning

      added the new project-git-credential-grant-attested enum value to the // response property for the response status

  • 6ba0dd227bb4Revision changes
    • breaking

      added subschema #10 to the // response property oneOf list for the response status

    • warning

      added the new messageboard-project-channel-created enum value to the // response property for the response status

    • warning

      added the new messageboard-project-private-channel-created enum value to the // response property for the response status