Reject Apps

POST /clients/{client_id}/apps/approval/reject

Reject one or more apps for the client. This sets is_approved to false. This operation is idempotent -- rejecting an already-rejected app is treated as a success.

Path Parameters

Parameter	Type	Description
client_id	string (uuid)	Unique identifier for the client organization

Request Body

Field	Type	Required	Description
app_ids	string (uuid)[]	Yes	List of app IDs to reject

Example Request Body

{
  "app_ids": [
    "f1a2b3c4-d5e6-7890-abcd-ef1234567890",
    "g2b3c4d5-e6f7-8901-bcde-f12345678901"
  ]
}

Response

Returns status 200 OK with a bulk operation result.

Field	Type	Description
succeeded	string (uuid)[]	App IDs successfully rejected (includes already-rejected apps)
failed	object[]	App IDs that failed with error details
failed[].id	string (uuid)	The app ID that failed
failed[].error	string	Reason for the failure

All succeeded

{
  "succeeded": [
    "f1a2b3c4-d5e6-7890-abcd-ef1234567890",
    "g2b3c4d5-e6f7-8901-bcde-f12345678901"
  ],
  "failed": []
}

Partial success

{
  "succeeded": [
    "f1a2b3c4-d5e6-7890-abcd-ef1234567890"
  ],
  "failed": [
    {
      "id": "ffffffff-ffff-ffff-ffff-ffffffffffff",
      "error": "App not found"
    }
  ]
}

Example Request

curl -X POST "https://api.example.com/v2/clients/aa7cf840-9ca9-46a3-9778-9015d6580d50/apps/approval/reject" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "app_ids": [
      "f1a2b3c4-d5e6-7890-abcd-ef1234567890",
      "g2b3c4d5-e6f7-8901-bcde-f12345678901"
    ]
  }'

Error Responses

Status	Description
400	Invalid request (missing app_ids, empty array, invalid uuid format)
401	Authentication required
403	Insufficient permissions for this client
404	Client not found
500	Server error

Notes

Idempotency

Apps that are already rejected are included in succeeded, not failed. The desired state is achieved regardless of prior state.

When to use this vs PATCH

Use this endpoint for multi-select operations (e.g. rejecting several apps from a table). Use Update App for single-app updates from a detail view.

Related Endpoints

• Approve Apps — Bulk approve apps
• Update App — Update approval on a single app
• List Apps — Filter by is_approved status