Get project activity log

curl --request GET \
  --url {schemes}://api.upsun.com/projects/{projectId}/activities \
  --header 'Authorization: Bearer <token>'

[
  {
    "id": "<string>",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "type": "<string>",
    "parameters": {},
    "project": "<string>",
    "started_at": "2023-11-07T05:31:56Z",
    "completed_at": "2023-11-07T05:31:56Z",
    "completion_percent": 123,
    "cancelled_at": "2023-11-07T05:31:56Z",
    "timings": {},
    "log": "<string>",
    "payload": {},
    "description": "<string>",
    "text": "<string>",
    "expires_at": "2023-11-07T05:31:56Z",
    "commands": [
      {
        "app": "<string>",
        "type": "<string>",
        "exit_code": 123
      }
    ],
    "integration": "<string>",
    "environments": [
      "<string>"
    ]
  }
]

Project Activity

Get project activity log

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.

GET

projects

{projectId}

activities

Error

A valid request URL is required to generate request examples

[
  {
    "id": "<string>",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "type": "<string>",
    "parameters": {},
    "project": "<string>",
    "started_at": "2023-11-07T05:31:56Z",
    "completed_at": "2023-11-07T05:31:56Z",
    "completion_percent": 123,
    "cancelled_at": "2023-11-07T05:31:56Z",
    "timings": {},
    "log": "<string>",
    "payload": {},
    "description": "<string>",
    "text": "<string>",
    "expires_at": "2023-11-07T05:31:56Z",
    "commands": [
      {
        "app": "<string>",
        "type": "<string>",
        "exit_code": 123
      }
    ],
    "integration": "<string>",
    "environments": [
      "<string>"
    ]
  }
]

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

projectId

string

required

Response

default - application/json

string

required

The identifier of Activity

created_at

string<date-time> | null

required

The creation date

updated_at

string<date-time> | null

required

The update date

type

string

required

The type of the activity

parameters

Parameters · object

required

The parameters of the activity

project

string

required

The project the activity belongs to

state

enum<string>

required

The state of the activity

Available options:

cancelled,

complete,

in_progress,

pending,

scheduled,

staged

result

enum<string> | null

required

The result of the activity

Available options:

failure,

success

failure_reason

enum<string> | null

required

The reason for activity failure

Available options:

error,

shell

started_at

string<date-time> | null

required

The start date of the activity

completed_at

string<date-time> | null

required

The completion date of the activity

completion_percent

integer

required

The completion percentage of the activity

cancelled_at

string<date-time> | null

required

The Cancellation date of the activity

timings

Timings · object

required

Timings related to different phases of the activity

Show child attributes

log

string

required

deprecated

The log of the activity

payload

Payload · object

required

The payload of the activity

description

string | null

required

The description of the activity, formatted with HTML

text

string | null

required

The description of the activity, formatted as plain text

expires_at

string<date-time> | null

required

The date at which the activity will expire

commands

Commands · object[]

required

The commands of the activity

Show child attributes

integration

string

The integration the activity belongs to

environments

string[]

The environments related to the activity

Last modified on June 16, 2026

Post projects maintenance redeploy Get a project activity log entry

⌘I