Agents eines verwalteten Kunden auflisten

Rufen Sie alle mit einem verwalteten Kunden verbundenen Agents einschließlich widerrufener Agents ab.

GET/partner-api/v1/accounts/{relationshipId}/agentsAPI-Version: v1operationId: listPartnerManagedAgentsAls Markdown anzeigen

Funktion dieser Methode

Rufen Sie alle mit einem verwalteten Kunden verbundenen Agents einschließlich widerrufener Agents ab.

Authentifizierung

Senden Sie eine einmalige RS256-Assertion der Developer Application in Authorization: Bearer <application_assertion>. Sie ist kein Public-API-Zugriffstoken.

Anfrage

Produktions-URL: https://public-api.cloudprint.me/partner-api/v1/accounts/{relationshipId}/agents

Parameter

Name	Position	Typ	Erforderlich	Beschreibung	Einschränkungen
`relationshipId`	path	`string (uuid)`	ja	Stabile UUID der Partnerbeziehung zum verwalteten Kunden.	—
`limit`	query	`integer`	nein	Höchstzahl der Ressourcen auf einer Ergebnisseite.	min: 1; max: 100; default: `50`
`cursor`	query	`string`	nein	Opaker Cursor der angefragten Ergebnisseite; senden Sie ihn unverändert zurück.	—
`X-Request-Id`	header	`string`	nein	Optionale Kennung zur Anfrageverfolgung; CloudPrint gibt einen sicheren Wert im Antwort-Header zurück.	maxLength: 128; example: `"order-100045-attempt-1"`

Anfrageinhalt

Die Methode hat keinen Anfrageinhalt.

Anfragebeispiele

cURL

bash

curl -sS "https://public-api.cloudprint.me/partner-api/v1/accounts/$RELATIONSHIP_ID/agents" \
  -H "Authorization: Bearer $APPLICATION_ASSERTION"

Antwort

HTTP-Status: 200 — Anfrage erfolgreich.

Antwortfelder

Name	Typ	Erforderlich	Beschreibung	Einschränkungen
`data`	`array`	ja	Ressourcen auf der aktuellen Ergebnisseite.	—
`next_cursor`	`string \| null`	ja	Opaker Cursor für die nächste Ergebnisseite; senden Sie ihn unverändert zurück.	—

Beispielantwort

json

{
  "data": [
    {
      "agent_id": "11111111-1111-4111-8111-111111111111",
      "name": "string",
      "status": "online",
      "agent_instance_id": "string",
      "hostname": "string",
      "version": "string",
      "last_seen_at": "2026-08-06T12:00:00Z",
      "created_at": "2026-08-06T12:00:00Z",
      "revoked_at": "2026-08-06T12:00:00Z"
    }
  ],
  "next_cursor": "string"
}

Fehler

HTTP-Status	Beschreibung
`401`	Authentifizierung fehlt oder ist ungültig.
`403`	Das Token hat nicht die erforderlichen Berechtigungen.
`404`	Ressource nicht gefunden.
`422`	Mindestens ein Feld ist ungültig.
`429`	Anfragelimit überschritten; beachten Sie Retry-After.
`500`	Interner CloudPrint-Fehler.

Agents eines verwalteten Kunden auflisten ​

Funktion dieser Methode ​

Authentifizierung ​

Anfrage ​

Parameter ​

Anfrageinhalt ​

Anfragebeispiele ​

cURL ​

Antwort ​

Antwortfelder ​

Beispielantwort ​

Fehler ​

Verwandte Dokumentation ​