---
title: "Get project activity log"
method: GET
path: "/projects/{projectId}/activities"
tags: ["Project Activity"]
---

# Get project activity log

`GET /projects/{projectId}/activities`

Retrieve a project's activity log including logging actions in all
environments within a project. This returns a list of objects
with records of actions such as:

- Commits being pushed to the repository
- A new environment being branched out from the specified environment
- A snapshot being created of the specified environment

The object includes a timestamp of when the action occurred
(`created_at`), when the action concluded (`updated_at`),
the current `state` of the action, the action's completion
percentage (`completion_percent`), the `environments` it
applies to and when the activity expires (`expires_at`).

There are other related information in the `payload`.
The contents of the `payload` varies based on the `type` of the
activity. For example:

- An `environment.branch` action's `payload` can contain objects
representing the environment's `parent` environment and the
branching action's `outcome`.

- An `environment.push` action's `payload` can contain objects
representing the `environment`, the specific `commits` included in
the push, and the `user` who pushed.

Expired activities are removed from the project activity log, except
the last 100 expired objects provided they are not of type `environment.cron`
or `environment.backup`.

## Path parameters

- `projectId` string, required

## Response `default`

- Activity[]
  - `id` string, required — The identifier of Activity
  - `created_at` string, date-time, nullable, required — The creation date
  - `updated_at` string, date-time, nullable, required — The update date
  - `type` string, required — The type of the activity
  - `parameters` object, required — The parameters of the activity
  - `project` string, required — The project the activity belongs to
  - `integration` string — The integration the activity belongs to
  - `environments` string[] — The environments related to the activity
  - `state` 'cancelled' | 'complete' | 'in_progress' | 'pending' | 'scheduled' | 'staged', required — The state of the activity
  - `result` 'failure' | 'success', nullable, required — The result of the activity
  - `started_at` string, date-time, nullable, required — The start date of the activity
  - `completed_at` string, date-time, nullable, required — The completion date of the activity
  - `completion_percent` integer, required — The completion percentage of the activity
  - `cancelled_at` string, date-time, nullable, required — The Cancellation date of the activity
  - `timings` object, required — Timings related to different phases of the activity
  - `log` string, required — The log of the activity
  - `payload` object, required — The payload of the activity
  - `description` string, nullable, required — The description of the activity, formatted with HTML
  - `text` string, nullable, required — The description of the activity, formatted as plain text
  - `expires_at` string, date-time, nullable, required — The date at which the activity will expire
  - `commands` object[], required — The commands of the activity
    - `app` string, required
    - `type` string, required
    - `exit_code` integer, required

---

[API](https://skmtc.net/upsun/apis/upsun-com-rest-api.md) · [All operations](https://skmtc.net/upsun/apis/upsun-com-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/upsun/upsun-com-rest-api/revisions/6cc88fde6435/schema)
