Skip to main content
GET
/
projects
/
{projectId}
/
environments
/
{environmentId}
/
tasks
/
{taskId}
cURL
curl --request GET \
  --url {schemes}://api.upsun.com/projects/{projectId}/environments/{environmentId}/tasks/{taskId} \
  --header 'Authorization: Bearer <token>'
{
  "id": "<string>",
  "type": "<string>",
  "source": {
    "root": "<string>"
  },
  "hooks": {
    "build": "<string>",
    "deploy": "<string>"
  },
  "relationships": {},
  "mounts": {},
  "variables": {},
  "run": {
    "command": "<string>",
    "timeout": 123
  },
  "name": "<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
taskId
string
required

Response

default - application/json
id
string
required

The identifier of Task

type
string
required

The runtime type and version for the task (e.g., python:3.8)

source
Source Code Configuration · object
required

Configuration related to the source code of the task

hooks
Hooks · object
required

Scripts executed at various points in the lifecycle of the task

relationships
Relationships · object
required

The relationships of the task to defined services and applications

mounts
Mounts · object
required

Filesystem mounts of this task

variables
Environment Variables · object
required

Variables provide environment-sensitive information to control how your task behaves

run
Run Configuration · object
required

Configuration for task execution

name
string
required

The unique name of the task

Last modified on March 25, 2026