> For the complete documentation index, see [llms.txt](https://apidocs.akinon.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://apidocs.akinon.com/oms-openapis/packages/package-denial-reasons.md).
# Package Denial Reasons
Operations related to package denial reasons
## List package denial reasons
> Returns a paginated list of package denial reasons with filtering support.\
> \
> Supports filtering by active status, title, priority, remote ID, and date ranges.\
> Results can be ordered by ID or modification date.
```json
{"openapi":"3.0.3","info":{"title":"OMS Packages Module API","version":"1.0.0"},"tags":[{"name":"package-denial-reasons","description":"Operations related to package denial reasons"}],"servers":[{"url":"https://{domain}/api/v1/oms","variables":{"domain":{"default":"domain.akinon.com"}}}],"security":[{"tokenAuth":[]}],"components":{"securitySchemes":{"tokenAuth":{"type":"apiKey","in":"header","name":"Authorization","description":"Use format: `Token `"}},"schemas":{"PaginatedPackageDenialReasonResponse":{"type":"object","properties":{"count":{"type":"integer","description":"Total number of items"},"next":{"type":"string","nullable":true,"description":"URL for the next page"},"previous":{"type":"string","nullable":true,"description":"URL for the previous page"},"results":{"type":"array","items":{"$ref":"#/components/schemas/PackageDenialReason"}}}},"PackageDenialReason":{"type":"object","properties":{"id":{"type":"integer","description":"Unique identifier","readOnly":true},"title":{"type":"string","description":"Human-readable title/name of the denial reason","maxLength":255},"remote_id":{"type":"string","nullable":true,"description":"External system identifier","maxLength":100},"priority":{"type":"integer","nullable":true,"description":"Priority level for sorting denial reasons","minimum":0},"is_active":{"type":"boolean","description":"Whether the denial reason is active and can be used","default":true}},"required":["id","title","is_active"]}}},"paths":{"/packages/package_denial_reason/":{"get":{"tags":["package-denial-reasons"],"summary":"List package denial reasons","description":"Returns a paginated list of package denial reasons with filtering support.\n\nSupports filtering by active status, title, priority, remote ID, and date ranges.\nResults can be ordered by ID or modification date.\n","operationId":"listPackageDenialReasons","parameters":[{"in":"query","name":"page","schema":{"type":"integer","default":1,"minimum":1},"description":"Page number for pagination"},{"in":"query","name":"page_size","schema":{"type":"integer","default":20,"minimum":1,"maximum":100},"description":"Number of items per page"},{"in":"query","name":"sort","schema":{"type":"string","enum":["id","-id","modified_date","-modified_date"]},"description":"Ordering field"},{"in":"query","name":"is_active","schema":{"type":"boolean"},"description":"Filter by active status"},{"in":"query","name":"title","schema":{"type":"string"},"description":"Filter by title (case-insensitive contains search)"},{"in":"query","name":"priority","schema":{"type":"integer"},"description":"Filter by exact priority value"},{"in":"query","name":"remote_id","schema":{"type":"string"},"description":"Filter by exact remote ID"}],"responses":{"200":{"description":"Successful response with paginated denial reasons","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedPackageDenialReasonResponse"}}}},"400":{"description":"Bad request - invalid filter parameters"},"401":{"description":"Authentication credentials were not provided"},"403":{"description":"You do not have permission to perform this action"}}}}}}
```
## Create package denial reason
> Creates a new package denial reason with the provided data.\
> \
> The title must be unique across all denial reasons.
```json
{"openapi":"3.0.3","info":{"title":"OMS Packages Module API","version":"1.0.0"},"tags":[{"name":"package-denial-reasons","description":"Operations related to package denial reasons"}],"servers":[{"url":"https://{domain}/api/v1/oms","variables":{"domain":{"default":"domain.akinon.com"}}}],"security":[{"tokenAuth":[]}],"components":{"securitySchemes":{"tokenAuth":{"type":"apiKey","in":"header","name":"Authorization","description":"Use format: `Token `"}},"schemas":{"PackageDenialReasonCreate":{"type":"object","properties":{"title":{"type":"string","description":"Human-readable title/name of the denial reason","maxLength":255},"remote_id":{"type":"string","nullable":true,"description":"External system identifier","maxLength":100},"priority":{"type":"integer","nullable":true,"description":"Priority level for sorting denial reasons","minimum":0},"is_active":{"type":"boolean","description":"Whether the denial reason is active and can be used","default":true}},"required":["title"]},"PackageDenialReason":{"type":"object","properties":{"id":{"type":"integer","description":"Unique identifier","readOnly":true},"title":{"type":"string","description":"Human-readable title/name of the denial reason","maxLength":255},"remote_id":{"type":"string","nullable":true,"description":"External system identifier","maxLength":100},"priority":{"type":"integer","nullable":true,"description":"Priority level for sorting denial reasons","minimum":0},"is_active":{"type":"boolean","description":"Whether the denial reason is active and can be used","default":true}},"required":["id","title","is_active"]}}},"paths":{"/packages/package_denial_reason/":{"post":{"tags":["package-denial-reasons"],"summary":"Create package denial reason","description":"Creates a new package denial reason with the provided data.\n\nThe title must be unique across all denial reasons.\n","operationId":"createPackageDenialReason","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PackageDenialReasonCreate"}}}},"responses":{"201":{"description":"Package denial reason created successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PackageDenialReason"}}}},"400":{"description":"Bad request - validation errors"},"401":{"description":"Authentication credentials were not provided"},"403":{"description":"You do not have permission to perform this action"}}}}}}
```
## Retrieve package denial reason
> Retrieves a single package denial reason by its ID with all details.
```json
{"openapi":"3.0.3","info":{"title":"OMS Packages Module API","version":"1.0.0"},"tags":[{"name":"package-denial-reasons","description":"Operations related to package denial reasons"}],"servers":[{"url":"https://{domain}/api/v1/oms","variables":{"domain":{"default":"domain.akinon.com"}}}],"security":[{"tokenAuth":[]}],"components":{"securitySchemes":{"tokenAuth":{"type":"apiKey","in":"header","name":"Authorization","description":"Use format: `Token `"}},"schemas":{"PackageDenialReason":{"type":"object","properties":{"id":{"type":"integer","description":"Unique identifier","readOnly":true},"title":{"type":"string","description":"Human-readable title/name of the denial reason","maxLength":255},"remote_id":{"type":"string","nullable":true,"description":"External system identifier","maxLength":100},"priority":{"type":"integer","nullable":true,"description":"Priority level for sorting denial reasons","minimum":0},"is_active":{"type":"boolean","description":"Whether the denial reason is active and can be used","default":true}},"required":["id","title","is_active"]}}},"paths":{"/packages/package_denial_reason/{id}/":{"get":{"tags":["package-denial-reasons"],"summary":"Retrieve package denial reason","description":"Retrieves a single package denial reason by its ID with all details.","operationId":"retrievePackageDenialReason","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"integer"},"description":"The unique identifier of the package denial reason"}],"responses":{"200":{"description":"Successful response with denial reason details","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PackageDenialReason"}}}},"401":{"description":"Authentication credentials were not provided"},"403":{"description":"You do not have permission to perform this action"},"404":{"description":"Package denial reason not found"}}}}}}
```
## Update package denial reason (full update)
> Updates all fields of a package denial reason. All required fields must be provided.
```json
{"openapi":"3.0.3","info":{"title":"OMS Packages Module API","version":"1.0.0"},"tags":[{"name":"package-denial-reasons","description":"Operations related to package denial reasons"}],"servers":[{"url":"https://{domain}/api/v1/oms","variables":{"domain":{"default":"domain.akinon.com"}}}],"security":[{"tokenAuth":[]}],"components":{"securitySchemes":{"tokenAuth":{"type":"apiKey","in":"header","name":"Authorization","description":"Use format: `Token `"}},"schemas":{"PackageDenialReasonUpdate":{"type":"object","properties":{"title":{"type":"string","description":"Human-readable title/name of the denial reason","maxLength":255},"remote_id":{"type":"string","nullable":true,"description":"External system identifier","maxLength":100},"priority":{"type":"integer","nullable":true,"description":"Priority level for sorting denial reasons","minimum":0},"is_active":{"type":"boolean","description":"Whether the denial reason is active and can be used"}},"required":["title","is_active"]},"PackageDenialReason":{"type":"object","properties":{"id":{"type":"integer","description":"Unique identifier","readOnly":true},"title":{"type":"string","description":"Human-readable title/name of the denial reason","maxLength":255},"remote_id":{"type":"string","nullable":true,"description":"External system identifier","maxLength":100},"priority":{"type":"integer","nullable":true,"description":"Priority level for sorting denial reasons","minimum":0},"is_active":{"type":"boolean","description":"Whether the denial reason is active and can be used","default":true}},"required":["id","title","is_active"]}}},"paths":{"/packages/package_denial_reason/{id}/":{"put":{"tags":["package-denial-reasons"],"summary":"Update package denial reason (full update)","description":"Updates all fields of a package denial reason. All required fields must be provided.","operationId":"updatePackageDenialReason","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"integer"},"description":"The unique identifier of the package denial reason"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PackageDenialReasonUpdate"}}}},"responses":{"200":{"description":"Package denial reason updated successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PackageDenialReason"}}}},"400":{"description":"Bad request - validation errors"},"401":{"description":"Authentication credentials were not provided"},"403":{"description":"You do not have permission to perform this action"},"404":{"description":"Package denial reason not found"}}}}}}
```
## Delete package denial reason
> Soft deletes a package denial reason by setting its is\_active flag to false.\
> \
> This is a soft delete operation - the denial reason is not physically removed \
> from the database but marked as inactive.
```json
{"openapi":"3.0.3","info":{"title":"OMS Packages Module API","version":"1.0.0"},"tags":[{"name":"package-denial-reasons","description":"Operations related to package denial reasons"}],"servers":[{"url":"https://{domain}/api/v1/oms","variables":{"domain":{"default":"domain.akinon.com"}}}],"security":[{"tokenAuth":[]}],"components":{"securitySchemes":{"tokenAuth":{"type":"apiKey","in":"header","name":"Authorization","description":"Use format: `Token `"}}},"paths":{"/packages/package_denial_reason/{id}/":{"delete":{"tags":["package-denial-reasons"],"summary":"Delete package denial reason","description":"Soft deletes a package denial reason by setting its is_active flag to false.\n\nThis is a soft delete operation - the denial reason is not physically removed \nfrom the database but marked as inactive.\n","operationId":"deletePackageDenialReason","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"integer"},"description":"The unique identifier of the package denial reason"}],"responses":{"204":{"description":"Package denial reason deleted successfully"},"401":{"description":"Authentication credentials were not provided"},"403":{"description":"You do not have permission to perform this action"},"404":{"description":"Package denial reason not found"}}}}}}
```
## Partially update package denial reason
> Partially updates a package denial reason. Only provided fields will be updated.
```json
{"openapi":"3.0.3","info":{"title":"OMS Packages Module API","version":"1.0.0"},"tags":[{"name":"package-denial-reasons","description":"Operations related to package denial reasons"}],"servers":[{"url":"https://{domain}/api/v1/oms","variables":{"domain":{"default":"domain.akinon.com"}}}],"security":[{"tokenAuth":[]}],"components":{"securitySchemes":{"tokenAuth":{"type":"apiKey","in":"header","name":"Authorization","description":"Use format: `Token `"}},"schemas":{"PackageDenialReasonPartialUpdate":{"type":"object","properties":{"title":{"type":"string","description":"Human-readable title/name of the denial reason","maxLength":255},"remote_id":{"type":"string","nullable":true,"description":"External system identifier","maxLength":100},"priority":{"type":"integer","nullable":true,"description":"Priority level for sorting denial reasons","minimum":0},"is_active":{"type":"boolean","description":"Whether the denial reason is active and can be used"}}},"PackageDenialReason":{"type":"object","properties":{"id":{"type":"integer","description":"Unique identifier","readOnly":true},"title":{"type":"string","description":"Human-readable title/name of the denial reason","maxLength":255},"remote_id":{"type":"string","nullable":true,"description":"External system identifier","maxLength":100},"priority":{"type":"integer","nullable":true,"description":"Priority level for sorting denial reasons","minimum":0},"is_active":{"type":"boolean","description":"Whether the denial reason is active and can be used","default":true}},"required":["id","title","is_active"]}}},"paths":{"/packages/package_denial_reason/{id}/":{"patch":{"tags":["package-denial-reasons"],"summary":"Partially update package denial reason","description":"Partially updates a package denial reason. Only provided fields will be updated.","operationId":"partialUpdatePackageDenialReason","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"integer"},"description":"The unique identifier of the package denial reason"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PackageDenialReasonPartialUpdate"}}}},"responses":{"200":{"description":"Package denial reason updated successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PackageDenialReason"}}}},"400":{"description":"Bad request - validation errors"},"401":{"description":"Authentication credentials were not provided"},"403":{"description":"You do not have permission to perform this action"},"404":{"description":"Package denial reason not found"}}}}}}
```
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://apidocs.akinon.com/oms-openapis/packages/package-denial-reasons.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.