events

List all visible events for a project

Lists all visible events for a specified project. When a push exceeds the Push event activities limit, a single bulk push event is returned instead of individual commit events. Bulk push events have limited commit details: commit_count is 0, ref_count shows the number of refs pushed, and individual commit attributes are null.

get/api/v4/projects/{id}/events

Request

  • Base URL
    https://gitlab.com
  • Auth
    none declared

Path parameters

idstring required

The ID or URL-encoded path of the project

Query parameters

actionstring

Event action to filter on

target_type'issue' | 'milestone' | 'merge_request' | 'note' | 'project' | 'snippet' | 'user' | 'wiki' | 'design'

Event target type to filter on

beforestring date

Include only events created before this date

afterstring date

Include only events created after this date

sort'asc' | 'desc'

Return events sorted in ascending and descending order

pageinteger

Current page number

per_pageinteger

Number of items per page

Response

List all visible events for a project

idinteger required
project_idinteger required
action_namestring required
target_idinteger required
target_iidinteger required
target_typestring required
author_idinteger required
target_titlestring required
created_atstring required
importedboolean required
imported_fromstring required
author_usernamestring required

Example response

{
  "id": 1,
  "project_id": 2,
  "action_name": "closed",
  "target_id": 160,
  "target_iid": 157,
  "target_type": "Issue",
  "author_id": 25,
  "target_title": "Public project search field",
  "created_at": "2017-02-09T10:43:19.667Z",
  "note": {
    "id": 1,
    "type": "DiscussionNote",
    "body": "Note body.",
    "author": {
      "id": 1,
      "username": "admin",
      "public_email": "john@example.com",
      "name": "Administrator",
      "state": "active",
      "avatar_url": "https://gravatar.com/avatar/1",
      "avatar_path": "/user/avatar/28/The-Big-Lebowski-400-400.png",
      "custom_attributes": [
        {
          "key": "foo",
          "value": "bar"
        }
      ],
      "web_url": "https://gitlab.example.com/root"
    },
    "created_at": "2022-01-31T15:10:44.988Z",
    "updated_at": "2022-01-31T15:10:44.988Z",
    "noteable_id": 1,
    "noteable_type": "Issue",
    "project_id": 1,
    "commit_id": "7b09ce7e6f80347baf0316c8c94cdba9a0a7e91d",
    "resolved_by": {
      "id": 1,
      "username": "admin",
      "public_email": "john@example.com",
      "name": "Administrator",
      "state": "active",
      "avatar_url": "https://gravatar.com/avatar/1",
      "avatar_path": "/user/avatar/28/The-Big-Lebowski-400-400.png",
      "custom_attributes": [
        {
          "key": "foo",
          "value": "bar"
        }
      ],
      "web_url": "https://gitlab.example.com/root"
    },
    "resolved_at": "2022-01-31T15:10:44.988Z",
    "suggestions": {
      "id": 1,
      "from_line": 1,
      "to_line": 1,
      "appliable": true,
      "from_content": "Original content\n",
      "to_content": "New content\n"
    },
    "imported_from": "github",
    "noteable_iid": 1
  },
  "author": {
    "id": 1,
    "username": "admin",
    "public_email": "john@example.com",
    "name": "Administrator",
    "state": "active",
    "avatar_url": "https://gravatar.com/avatar/1",
    "avatar_path": "/user/avatar/28/The-Big-Lebowski-400-400.png",
    "custom_attributes": [
      {
        "key": "foo",
        "value": "bar"
      }
    ],
    "web_url": "https://gitlab.example.com/root"
  },
  "wiki_page": {
    "format": "markdown",
    "slug": "deploy",
    "title": "deploy",
    "wiki_page_meta_id": 123
  },
  "imported_from": "none",
  "push_data": {
    "commit_count": 1,
    "action": "pushed",
    "ref_type": "branch",
    "commit_from": "50d4420237a9de7be1304607147aec22e4a14af7",
    "commit_to": "c5feabde2d8cd023215af4d2ceeb7a64839fc428",
    "ref": "master",
    "commit_title": "Add simple search to projects in public area",
    "ref_count": 1
  },
  "author_username": "root"
}

Changes

No recorded changes to this operation across all 5 revisions of this API.