Approve or reject a skill upload review. POST /api/openapi/v1/skill-upload-reviews/{reviewId}/decision, scope admin.v1.skills-upload-reviews.execute.
- Scope: admin.v1.skills-upload-reviews.execute
- Permission: Execute skill upload reviews (skills-upload-reviews)
- Permission type: Execute
- Endpoint: POST/api/openapi/v1/skill-upload-reviews/{reviewId}/decision
Authentication and request headers
Call with an application API key. This endpoint checks only the scope above; read, manage and execute permissions do not imply one another.
| Name | Location | Type | Required | Description | Example |
|---|---|---|---|---|---|
| Authorization | header | string | Yes | Application API key, passed as a Bearer token. | Bearer qwk_*** |
| X-Request-Id | header | string | No | Optional request tracing identifier; generated by the server if omitted. | req-20260831-001 |
Request parameters
| Name | Location | Type | Required | Description | Example |
|---|---|---|---|---|---|
| reviewId | path | string · uuid | Required | Review ID | "<uuid>" |
| Idempotency-Key | header | string | Required | Idempotency key used to prevent duplicate submissions | "<string>" |
| category_id | body | string · uuid | No | Category (category ID) | "<uuid>" |
| clear_category | body | boolean | No | Clear category | false |
| decision | body | string | Required | Review decision | "approve" |
| reason | body | string | No | Reason | "<string>" |
Request example
cURL
Responses
200 OK
| Name | Type | Required | Description | Example |
|---|---|---|---|---|
| created_at | string · date-time | Yes | Created at | "2026-08-27T10:00:00Z" |
| id | string | Yes | Review ID | "<string>" |
| reject_reason | string | No | Rejection reason | "<string>" |
| resource_id | string | No | Resource ID | "<string>" |
| resource_identity | string | Yes | Resource identifier | "<string>" |
| resource_type | string | Yes | Resource type | "<string>" |
| reviewed_at | string · date-time | No | Reviewed at | "2026-08-27T10:00:00Z" |
| reviewer_email | string | No | Reviewer email | "<string>" |
| reviewer_id | string | No | Reviewer ID | "<string>" |
| reviewer_name | string | No | Reviewed by | "<string>" |
| snapshot | any | Yes | Submitted content snapshot | "<string>" |
| status | string | Yes | Review status | "<string>" |
| submitted_by | string | Yes | Submitter ID | "<string>" |
| submitted_by_email | string | No | Submitter email | "<string>" |
| submitted_by_name | string | No | Submitted by | "<string>" |
| updated_at | string · date-time | Yes | Updated at | "2026-08-27T10:00:00Z" |
default Flat business error
| Name | Type | Required | Description | Example |
|---|---|---|---|---|
| code | string | No | Stable business error code | "<string>" |
| detail | string | Yes | Human-readable error description | "<string>" |
| details | OpenapiErrorDetails | No | Error details | {"field":"<string>","reason":"<string>","suggestion":"<string>"} |
| details.field | string | No | Request field that failed validation | "<string>" |
| details.reason | string | No | Stable validation failure reason | "<string>" |
| details.suggestion | string | No | Suggested normalized value | "<string>" |
| error | string | Yes | Stable HTTP error type | "<string>" |