Skip to main content

Remove Role from Application

Endpoint: DELETE /api/applications/{applicationId}/roles/{role}

Removes an existing role from an application in your Conductor cluster.

Path parameters

ParameterDescriptionTypeRequired/ Optional
applicationIdThe unique ID of the application from which the role will be deleted.stringRequired.
roleThe role to remove from the application. Supported values:
  • WORKER
  • METADATA_API
  • APPLICATION_CREATOR
The following roles can only be granted by a cluster Admin:
  • UNRESTRICTED_WORKER
  • METADATA_MANAGER
  • WORKFLOW_MANAGER
  • APPLICATION_MANAGER
  • ADMIN
For detailed role descriptions, see Assign Role to Application.
stringRequired.

Response

  • Returns 200 OK, indicating that the role is removed from the application.
  • Returns 404 if an invalid application ID is provided.

Examples

Remove a role from an application

Request

curl -X 'DELETE' \
'https://<YOUR-SERVER-URL>/api/applications/243a8a88-9f77-48b2-9429-76793a123344/roles/WORKER' \
-H 'accept: application/json' \
-H 'X-Authorization: <TOKEN>'

Response

Returns 200 OK, indicating that the role is removed from the application.