List

GET
/workspaces
/:workspace
/targets

Retrieves targets from the workspace scope or from a specific entity if one filter (projectName, pipelineId, environmentId, or actionId) is provided. Only one filter can be used at a time.

Request

REQUIRED SCOPES

TARGET_INFO

URL PARAMETERS

workspacerequired string

The workspace name.

GET PARAMETERS

projectNamestring

Name of the project.

pipelineIdinteger

ID of the pipeline.

environmentIdinteger

ID of the environment.

actionIdinteger

ID of the action.

Last modified on Oct 30, 2025

Previous pageGet Next pageEdit

Example:

CURL
 curl -X GET "https://api.buddy.works/workspaces/:workspace/targets" \
 -H "Authorization: Bearer <YOUR-TOKEN>" \
 -H "Content-Type: application/json"

EXAMPLE RESPONSE
 {
 "targets": [
 {
 "type": "SSH",
 "identifier": "ubuntu_tests",
 "id": "tg-plib9o13mdapr",
 "host": "ubuntu.tests",
 "port": "22",
 "auth": {
 "method": "PASSWORD",
 "username": "buddy",
 "password": "secure!AF+pL5fhP8FQ2xjf15IbiQ==.+znyFTURT05v8zCHLD7Dow=="
 }
 },
 {
 "type": "MATCH",
 "identifier": "dev*",
 "scope": "ANY"
 }
 ]
}

STATUS
 200 OK

LIMITS
 X-Rate-Limit-Limit: 1
 X-Rate-Limit-Remaining: 999