---
title: "Reject a free-email Definite Cloud signup"
method: POST
path: "/onprem/v1/hosted-signups/{signup_id}/reject"
tags: ["onprem"]
---

# Reject a free-email Definite Cloud signup

`POST /onprem/v1/hosted-signups/{signup_id}/reject`

## Request

- Base URL: `https://api.definite.app` (the document declares no server; this is the origin it was published from)
- URL: `https://api.definite.app/onprem/v1/hosted-signups/{signup_id}/reject`
- Auth: none declared
- TypeScript: <https://skmtc.dev/definite/apis/defapi/docs/onprem/v1/hosted-signups/:signup_id/reject/post.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `signup_id` string, required

## Request body

- HostedApprovalRequest
  - `reason` string, required: Reason for approving or rejecting the hosted signup

## Response `200`

Success

- SuccessResponseHostedApprovalResponse
  - `success` true, required: Flag for it request was successful
  - `data` HostedApprovalResponse, required
    - `signup_id` union, required
      - string, uuid
      - string
    - `status` 'email_pending' | 'approval_pending' | 'accepted' | 'rejected' | 'converted', required
    - `approval_status` 'not_required' | 'pending' | 'approved' | 'rejected', required
  - `meta` ResponseMeta
    - `requestId` string: Unique request identifier for tracing
    - `timestamp` string, date-time: Response timestamp (UTC)
    - `durationMs` integer, nullable: Request processing time in milliseconds

## Other responses

- `401`: Auth Invalid Token
- `403`: Forbidden Insufficient Permissions
- `404`: Resource Not Found
- `409`: Resource Conflict
- `422`: Validation Failed
- `426`: Business Quota Exceeded
- `500`: Internal Error

---

[API](https://skmtc.dev/definite/apis/defapi.md) - [All operations](https://skmtc.dev/definite/apis/defapi/llms.txt) - [OpenAPI document](https://skmtc.dev/definite/apis/defapi/revisions/5ea378187147?raw)