Get environment activity log

curl --request GET \
  --url {schemes}://api.upsun.com/projects/{projectId}/environments/{environmentId}/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>"
    ]
  }
]

Environment Activity

Get environment activity log

Retrieve an environment’s activity log. This returns a list of object 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), and 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 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.

GET

projects

{projectId}

environments

{environmentId}

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

environmentId

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

Synchronize a child environment with its parent Get an environment activity log entry

⌘I