> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pingintel.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Action Submission(s)

> Provide a list of changes to transition ("change_status") or assign ("claim") one or multiple submissions.



## OpenAPI

````yaml https://vision.staging.pingintel.com/api/schema/?format=json post /api/v1/submission/bulkupdate
openapi: 3.0.3
info:
  title: Ping.Vision API
  version: v1.0
  description: >
    ### Ping.Vision API


    This API provides convenient, efficient access to Ping Intel's data and
    services. It is designed to be used by developers and data scientists to
    integrate Ping Intel's capabilities into their applications.


    Once SSO is set up with your organization, you can create an Organization or
    Personal API key at https://auth.pingintel.com/org.


    Please see the Python client library
    [pingintel-api](https://pypi.org/project/pingintel-api/) for commandline
    tools and programmatic access, and you

    can refer to the following documentation for details on interacting with the
    system via the HTTP API.
  contact:
    email: support@pingintel.com
    name: Ping Intel
    url: https://www.pingintel.com
servers:
  - url: https://vision.pingintel.com
    description: Ping.Vision API
  - url: https://vision.staging.pingintel.com
    description: Ping.Vision API (staging)
security: []
tags:
  - name: Create Submission
    description: The Create Submission API allows you to add new data into the system.
  - name: Update Submission
    description: >-
      The Update Submission API provides various endpoints to update, modify, or
      act upon existing submissions.
  - name: Get Submission Data
    description: ''
  - name: User Memberships
    description: >-
      The User Memberships API allows you to add, remove, and change the role of
      users in different teams, divisions, or companies.
  - name: Miscellaneous
    description: ''
paths:
  /api/v1/submission/bulkupdate:
    post:
      tags:
        - Update Submission
      summary: Action Submission(s)
      description: >-
        Provide a list of changes to transition ("change_status") or assign
        ("claim") one or multiple submissions.
      operationId: api_v1_submission_bulkupdate_create
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BulkUpdateSubmission'
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/BulkUpdateSubmission'
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/BulkUpdateSubmission'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BulkUpdateSubmissionResponse'
          description: ''
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationErrorResponse'
          description: ''
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse401'
          description: ''
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse403'
          description: ''
      security:
        - authorization_header: []
components:
  schemas:
    BulkUpdateSubmission:
      type: object
      properties:
        changes:
          type: array
          items:
            $ref: '#/components/schemas/BulkUpdateSubmissionChange'
          description: List of changes to apply to each submission.
        ids:
          type: array
          items:
            type: string
          description: List of Ping IDs to update.
      required:
        - changes
        - ids
    BulkUpdateSubmissionResponse:
      type: object
      properties:
        results:
          type: array
          items:
            type: array
            items:
              $ref: '#/components/schemas/BulkUpdateSubmissionResponseItem'
      required:
        - results
    ValidationErrorResponse:
      type: object
      properties:
        error:
          type: string
          description: Server error message detail
      required:
        - error
    ErrorResponse401:
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: Request ID
        message:
          type: string
          description: Authorization error message.
      required:
        - id
        - message
    ErrorResponse403:
      type: object
      properties:
        detail:
          type: string
          description: Error message.
      required:
        - detail
    BulkUpdateSubmissionChange:
      type: object
      properties:
        action:
          enum:
            - claim
            - change_status
          type: string
          x-spec-enum-id: c9a45bd04373ef64
          description: |-
            Action to perform on the submission.

            * `claim` - claim
            * `change_status` - change_status
        parameters:
          type: object
          additionalProperties: {}
          description: Parameters for the action.
      required:
        - action
        - parameters
    BulkUpdateSubmissionResponseItem:
      type: object
      properties:
        id:
          type: string
          description: Submission ID.
        error:
          type: string
          description: Error message if the submission could not be updated.
        updated_data:
          type: array
          items:
            type: array
            items:
              $ref: '#/components/schemas/BulkUpdateSubmissionResponseUpdatedData'
          description: List of changes to apply to each submission.
      required:
        - id
    BulkUpdateSubmissionResponseUpdatedData:
      type: object
      properties:
        claimed_by_id:
          type: integer
          description: User ID that submission was updated with.
        workflow_status_id:
          type: integer
          description: Workflow status ID submission was updated with.
  securitySchemes:
    authorization_header:
      type: apiKey
      in: header
      name: Authorization
      description: >-
        Supports `Token `-prefixed API keys and `Bearer `-prefixed JWT-based
        authentication.

````