Skip to main content
GET
/
workflows
/
{workflow_id_or_name}
/
labels
Get Agent Labels
curl --request GET \
  --url https://api.promptlayer.com/workflows/{workflow_id_or_name}/labels \
  --header 'X-API-KEY: <x-api-key>'
{
  "success": true,
  "release_labels": [
    {
      "release_label": "<string>",
      "release_label_id": 123,
      "workflow_version_id": 123,
      "workflow_version_number": 123
    }
  ]
}
List all release labels for an agent (workflow). Returns each label with its name, ID, and the version it points to. This mirrors the Get Prompt Template Labels endpoint. Please note that this feature was previously called “Workflows” and is now called “Agents”. Some references to “Workflows” remain in our SDK and will be updated before the feature exits beta.

Headers

​
X-API-KEY
string
required

Your API key for authentication.

Path Parameters

​
workflow_id_or_name
string
required

The agent ID or name.

Response

Labels retrieved successfully

​
success
boolean
required
Example:

true

​
release_labels
object[]
required