> ## Documentation Index > Fetch the complete documentation index at: https://docs.tolt.com/llms.txt > Use this file to discover all available pages before exploring further. # Reject partners in bulk > Rejects up to 100 partners with an optional shared rejection note. Each id is processed on its own and the response reports the outcome per id. ## OpenAPI ````yaml /api-reference/openapi.json post /v2/partners/bulk/reject openapi: 3.1.0 info: title: Tolt Public API version: 2.0.0 servers: - url: https://platform.tolt.dev description: Development security: - bearerAuth: [] paths: /v2/partners/bulk/reject: post: tags: - Partners summary: Reject partners in bulk description: >- Rejects up to 100 partners with an optional shared rejection note. Each id is processed on its own and the response reports the outcome per id. operationId: bulkRejectPartners requestBody: required: true content: application/json: schema: type: object properties: ids: type: array items: type: string minLength: 1 minItems: 1 maxItems: 100 description: >- Ids of the partners to act on, as returned when listing partners. Each one succeeds or fails on its own and gets its own entry in results. example: - part_9fQ2xLL - part_3RtV9k rejection_note: type: - string - 'null' maxLength: 2000 description: >- Reason for the rejection, shown to the partner in the partner portal. Null clears an earlier note. example: Site does not match our audience. required: - ids example: ids: - part_NLYzgNKuSuASvrvoxNtau6SY - part_9fQ2xLLmN3kP8dRvT1wYbHcS rejection_note: Site does not match our audience. responses: '200': description: Per-id results content: application/json: schema: type: object properties: success: type: boolean example: true message: type: string example: Request successful data: $ref: '#/components/schemas/BulkResult' required: - success - message - data example: success: true message: Processed partners data: succeeded: 1 failed: 1 results: - id: part_NLYzgNKuSuASvrvoxNtau6SY status: ok - id: part_9fQ2xLLmN3kP8dRvT1wYbHcS status: error code: not_found message: Partner not found headers: X-RateLimit-Limit: $ref: '#/components/headers/X-RateLimit-Limit' X-RateLimit-Remaining: $ref: '#/components/headers/X-RateLimit-Remaining' X-RateLimit-Reset: $ref: '#/components/headers/X-RateLimit-Reset' '400': description: Invalid request content: application/json: schema: $ref: '#/components/schemas/Error' example: success: false message: 'ids: Too small: expected array to have >=1 items' code: validation_error doc_url: https://docs.tolt.com/errors#validation_error errors: - field: ids message: 'Too small: expected array to have >=1 items' headers: X-RateLimit-Limit: $ref: '#/components/headers/X-RateLimit-Limit' X-RateLimit-Remaining: $ref: '#/components/headers/X-RateLimit-Remaining' X-RateLimit-Reset: $ref: '#/components/headers/X-RateLimit-Reset' '401': description: Missing or invalid API key content: application/json: schema: $ref: '#/components/schemas/Error' example: success: false message: Unauthorized code: unauthorized doc_url: https://docs.tolt.com/errors#unauthorized '413': $ref: '#/components/responses/PayloadTooLarge' '429': $ref: '#/components/responses/RateLimited' components: schemas: BulkResult: type: object properties: succeeded: type: number failed: type: number results: type: array items: type: object properties: id: type: string status: type: string enum: - ok - error code: type: string description: Error code when status is error. message: type: string required: - id - status required: - succeeded - failed - results Error: type: object properties: success: type: boolean example: false message: type: string description: Human-readable explanation. May change; branch on code instead. code: type: string enum: - bad_request - validation_error - invalid_reference - invalid_cursor - unauthorized - forbidden - not_found - conflict - already_exists - commission_paid - commission_frozen - transaction_refunded - commission_exists - rate_limited - payload_too_large - internal_error description: Stable machine-readable error code. example: not_found doc_url: type: string example: https://docs.tolt.com/errors#not_found errors: type: array items: type: object properties: field: type: string message: type: string required: - field - message description: >- One entry per offending field. Present on validation_error and invalid_reference. required: - success - message - code - doc_url headers: X-RateLimit-Limit: description: Requests allowed in the current window. schema: type: integer X-RateLimit-Remaining: description: Requests left in the current window. schema: type: integer X-RateLimit-Reset: description: Unix time, in seconds, when the window resets. schema: type: integer Retry-After: description: Seconds to wait before retrying. schema: type: integer responses: PayloadTooLarge: description: Request body exceeds 1 MB content: application/json: schema: $ref: '#/components/schemas/Error' example: success: false message: Request body exceeds 1 MB code: payload_too_large doc_url: https://docs.tolt.com/errors#payload_too_large RateLimited: description: The API key exceeded its rate limit headers: X-RateLimit-Limit: $ref: '#/components/headers/X-RateLimit-Limit' X-RateLimit-Remaining: $ref: '#/components/headers/X-RateLimit-Remaining' X-RateLimit-Reset: $ref: '#/components/headers/X-RateLimit-Reset' Retry-After: $ref: '#/components/headers/Retry-After' content: application/json: schema: $ref: '#/components/schemas/Error' example: success: false message: Too many requests. Retry after the window resets. code: rate_limited doc_url: https://docs.tolt.com/errors#rate_limited securitySchemes: bearerAuth: type: http scheme: bearer description: Tolt API key sent as a bearer token. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.