> ## 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.

# Store Additional Data on Submission

> Store arbitrary custom tags on the submission. This is useful for storing additional information that is not part of the standard submission data structure.



## OpenAPI

````yaml https://vision.staging.pingintel.com/api/schema/?format=json post /api/v1/submission/{id}/add_data_items
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/{id}/add_data_items:
    post:
      tags:
        - Update Submission
      summary: Store Additional Data on Submission
      description: >-
        Store arbitrary custom tags on the submission. This is useful for
        storing additional information that is not part of the standard
        submission data structure.
      operationId: api_v1_submission_add_data_items_create
      parameters:
        - in: path
          name: id
          schema:
            type: string
          description: The pingid of the submission.
          required: true
          examples:
            Example:
              value: p-lo-ping-abc123
              description: Example ping ID.
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AddDataItems'
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/AddDataItems'
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/AddDataItems'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AddDataItemsResponse'
          description: Success response.
        '400':
          content:
            application/json:
              schema:
                type: object
                properties:
                  field_name:
                    type: array
                    items:
                      type: string
                    description: List of errors for the field
                  another_field:
                    type: array
                    items:
                      type: string
                    description: List of errors for another field
                  non_field_errors:
                    type: array
                    items:
                      type: string
                    description: General errors not tied to a specific field
                  detail:
                    type: string
                    description: Error message detail
                additionalProperties:
                  type: array
                  items:
                    type: string
              examples:
                InvalidDataExample:
                  value:
                    field_name:
                      - This field is required.
                    another_field:
                      - Value must be a positive integer.
                    non_field_errors:
                      - Invalid request.
                  summary: Invalid Data Example
                DetailErrorExample:
                  value:
                    detail: This is the error message detail.
                  summary: Detail Error Example
          description: Validation error
        '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:
    AddDataItems:
      type: object
      properties:
        action:
          enum:
            - upsert
            - replace
          type: string
          x-spec-enum-id: ccc8d10b724425f0
          description: |-
            Action to perform on the data items.

            * `upsert` - UPSERT
            * `replace` - REPLACE
        items:
          type: object
          additionalProperties: {}
          description: >-
            Key/value pairs to tag on the submission. `items` is merged into
            existing data per the `action`.
      required:
        - action
        - items
    AddDataItemsResponse:
      type: object
      properties:
        data_items:
          type: object
          additionalProperties: {}
          description: All current data items on the submission after action is complete.
        status:
          type: string
          description: Status of the operation.
      required:
        - data_items
        - status
    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
  securitySchemes:
    authorization_header:
      type: apiKey
      in: header
      name: Authorization
      description: >-
        Supports `Token `-prefixed API keys and `Bearer `-prefixed JWT-based
        authentication.

````