Revoke a managed customer Agent
Revoke a lost or replaced Agent and take its printers offline.
DELETE
/partner-api/v1/accounts/{relationshipId}/agents/{agentId}API version: v1operationId: revokePartnerManagedAgentView as MarkdownWhat this endpoint does
Revoke a lost or replaced Agent and take its printers offline.
Authentication
Send a one-time RS256 Developer Application assertion in Authorization: Bearer <application_assertion>. This assertion is not a Public API access token.
Request
Production base URL: https://public-api.cloudprint.me/partner-api/v1/accounts/{relationshipId}/agents/{agentId}
Parameters
| Name | Location | Type | Required | Description | Constraints |
|---|---|---|---|---|---|
relationshipId | path | string (uuid) | yes | — | — |
agentId | path | string (uuid) | yes | — | — |
Request body
This endpoint has no request body.
Example requests
cURL
bash
curl -sS -X DELETE "https://public-api.cloudprint.me/partner-api/v1/accounts/$RELATIONSHIP_ID/agents/$AGENT_ID" \
-H "Authorization: Bearer $APPLICATION_ASSERTION"Response
HTTP status: 204 — Agent revoked
Errors
| HTTP status | Description |
|---|---|
401 | Application assertion is invalid |
403 | Partner capability is not granted |
404 | Managed Account or Agent was not found |
422 | Relationship ID or Agent ID is invalid |
429 | Rate limit exceeded |
500 | Unexpected error |
Integration guidance
Related documentation
List managed customer AgentsList every Agent connected to one managed customer, including revoked Agents.Create a managed Agent EnrollmentIssue an idempotent one-time Enrollment before or after customer onboarding.Enroll an agent for a customerConnect a local CloudPrint Agent to the correct managed customer account without requiring a customer portal login.