activity_log

Get the activity log

Get the activity log of the requested repository. Supports filtering by event_type, derived outcome (success / failure / pending / neutral), trigger (include only these trigger strings — Datadog Only), and not_trigger (exclude). trigger and not_trigger are mutually exclusive.

get/repos/{owner}/{repository}/logs

Path parameters

ownerstring required

The owner of the repository

The owner of the repository

repositorystring required

The name of the repository

The name of the repository

Query parameters

pull_requestinteger[] nullable

Filter events by pull-request number. Repeatable to match several PRs at once (e.g. ?pull_request=1&pull_request=2).

Filter events by pull-request number. Repeatable to match several PRs at once (e.g. ?pull_request=1&pull_request=2).

base_refstring nullable

Get events for PRs to the given base ref

Get events for PRs to the given base ref

batch_pullinteger[] nullable

Filter to batch (draft) pull requests' own lifecycle events by number (surfaced in the dashboard as "Batch Pull Request"). Repeatable to match several batches at once. The draft PR is the Mergify-opened pull request that speculatively checks a batch; this returns each batch's action.queue.checks_start / action.queue.checks_end events (which snapshot the draft PR number) plus the batch's bisection events. When in_place is true the number is the user's own PR rather than a Mergify draft. The number rotates on checks-retry — each event snapshots the number at that attempt. Mutually exclusive with not_batch_pull (exclusion).

Filter to batch (draft) pull requests' own lifecycle events by number (surfaced in the dashboard as "Batch Pull Request"). Repeatable to match several batches at once. The draft PR is the Mergify-opened pull request that speculatively checks a batch; this returns each batch's action.queue.checks_start / action.queue.checks_end events (which snapshot the draft PR number) plus the batch's bisection events. When in_place is true the number is the user's own PR rather than a Mergify draft. The number rotates on checks-retry — each event snapshots the number at that attempt. Mutually exclusive with not_batch_pull (exclusion).

not_batch_pullinteger[] nullable

Exclude batch (draft) pull requests' own lifecycle events by number — the same event set batch_pull includes, negated. Repeatable. Mirrors Datadog's facet semantics: unchecking a batch pull request in the dashboard sidebar adds it to the exclusion list. Mutually exclusive with batch_pull (positive include).

Exclude batch (draft) pull requests' own lifecycle events by number — the same event set batch_pull includes, negated. Repeatable. Mirrors Datadog's facet semantics: unchecking a batch pull request in the dashboard sidebar adds it to the exclusion list. Mutually exclusive with batch_pull (positive include).

event_typeEventType[] nullable

The specific types of events to select

The specific types of events to select

not_event_typeEventType[] nullable

Exclude events whose type matches any of the given values. Mutually exclusive with event_type (positive include).

Exclude events whose type matches any of the given values. Mutually exclusive with event_type (positive include).

outcomeEventOutcome[] nullable

Filter events by derived outcome label (success / failure / pending / neutral). Repeatable to match several outcomes at once (e.g. ?outcome=success&outcome=failure).

Filter events by derived outcome label (success / failure / pending / neutral). Repeatable to match several outcomes at once (e.g. ?outcome=success&outcome=failure).

not_outcomeEventOutcome[] nullable

Exclude events whose derived outcome label matches any of the given values (success / failure / pending / neutral). Repeatable. Mirrors Datadog's facet semantics: unchecking an outcome in the dashboard sidebar adds it to the exclusion list. Mutually exclusive with outcome (positive include).

Exclude events whose derived outcome label matches any of the given values (success / failure / pending / neutral). Repeatable. Mirrors Datadog's facet semantics: unchecking an outcome in the dashboard sidebar adds it to the exclusion list. Mutually exclusive with outcome (positive include).

triggerstring[] nullable

Include only events whose trigger matches one of the given values (exact match). Repeatable. Mirrors Datadog's facet behaviour after clicking Only: the URL switches from exclusion mode to inclusion mode with a positive list — shorter than not_trigger=<everything else>. Mutually exclusive with not_trigger.

Include only events whose trigger matches one of the given values (exact match). Repeatable. Mirrors Datadog's facet behaviour after clicking Only: the URL switches from exclusion mode to inclusion mode with a positive list — shorter than not_trigger=<everything else>. Mutually exclusive with not_trigger.

not_triggerstring[] nullable

Exclude events whose trigger matches any of the given values (exact match). Repeatable. Mirrors Datadog's facet semantics: the default state is all triggers included, and unchecking a trigger in the dashboard sidebar adds it to the exclusion list. Mutually exclusive with trigger (positive include).

Exclude events whose trigger matches any of the given values (exact match). Repeatable. Mirrors Datadog's facet semantics: the default state is all triggers included, and unchecking a trigger in the dashboard sidebar adds it to the exclusion list. Mutually exclusive with trigger (positive include).

not_pull_requestinteger[] nullable

Exclude events whose pull request matches any of the given numbers. Mutually exclusive with pull_request (positive include).

Exclude events whose pull request matches any of the given numbers. Mutually exclusive with pull_request (positive include).

received_fromstring date-time nullable

Start of the time range (ISO 8601 with timezone, e.g. 2024-01-01T00:00:00Z). Defaults to received_to - 1 day.

Start of the time range (ISO 8601 with timezone, e.g. 2024-01-01T00:00:00Z). Defaults to received_to - 1 day.

received_tostring date-time nullable

End of the time range (ISO 8601 with timezone, e.g. 2024-01-01T00:00:00Z). Defaults to now.

End of the time range (ISO 8601 with timezone, e.g. 2024-01-01T00:00:00Z). Defaults to now.

cursorstring nullable

The opaque cursor of the current page. Must be extracted from RFC 5988 pagination links to get the previous/next pages

The opaque cursor of the current page. Must be extracted from RFC 5988 pagination links to get the previous/next pages

per_pageinteger

The number of items per page

The number of items per page

Response

Successful Response

sizeinteger required

The number of items in this page

per_pageinteger required

The number of items per page

Changes

Changed in 7 of the 10 revisions of this API.1411

    • added the optional property events/items/oneOf[subschema #16: EventQueueChecksEnd]/metadata/bisection_depth to the response with the 200 status

      response-optional-property-added

    • added the optional property events/items/oneOf[subschema #16: EventQueueChecksEnd]/metadata/retries_before_run to the response with the 200 status

      response-optional-property-added

    • the endpoint scheme security MergifyTokenBearerAuth was added to the API

      api-security-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • d404dda1c51c15See the full diff
    • added EventProductEnabled EventProductDisabled to the events/items/ response property oneOf list for the response status 200

      response-property-one-of-added

    • added the enum value product.disabled to the property anyOf[subschema #1]/items/ of the query request parameter event_type

      request-parameter-property-enum-value-added

    • added the enum value product.disabled to the property anyOf[subschema #1]/items/ of the query request parameter not_event_type

      request-parameter-property-enum-value-added

    • added the enum value product.enabled to the property anyOf[subschema #1]/items/ of the query request parameter event_type

      request-parameter-property-enum-value-added

    • added the enum value product.enabled to the property anyOf[subschema #1]/items/ of the query request parameter not_event_type

      request-parameter-property-enum-value-added

    • added product.disabled product.enabled discriminator mapping keys to the events/items/ response property for the response status 200

      response-property-discriminator-mapping-added

    • added the optional property events/items/oneOf[subschema #17: EventQueueChecksNotStarted]/attempt to the response with the 200 status

      response-optional-property-added

    • added the new CHECKS_INTERRUPTED enum value to the events/items/oneOf[subschema #14: EventQueueLeave]/metadata/dequeue_code/anyOf[subschema #2]/ response property for the response status 200

      response-property-enum-value-added

    • added the new CHECKS_INTERRUPTED enum value to the events/items/oneOf[subschema #16: EventQueueChecksEnd]/metadata/abort_code/anyOf[subschema #1]/ response property for the response status 200

      response-property-enum-value-added

    • the endpoint scheme security AdminApplicationKey was added to the API

      api-security-added

    • the endpoint scheme security ApplicationAuth was removed from the API

      api-security-removed

    This revision also has 3 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • added the new BATCH_AHEAD_BRANCH_EDITED enum value to the events/items/oneOf[subschema #14: EventQueueLeave]/metadata/dequeue_code/anyOf[subschema #2]/ response property for the response status 200

      response-property-enum-value-added

    • added the new BATCH_AHEAD_BRANCH_EDITED enum value to the events/items/oneOf[subschema #16: EventQueueChecksEnd]/metadata/abort_code/anyOf[subschema #1]/ response property for the response status 200

      response-property-enum-value-added