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

# Batch update report owners

> Updates the owner of one or more reports. The maximum batch size is 500.

If any of the requested items fail, the response code will be `207 Multi-Status` and the response will include details of individual failures.

export const UserLevelAccessCallout = () => <div className="px-5 py-3.5 gap-3 flex flex-row">
    <div>
      <Icon icon="user" size={16} />
    </div>
    <div>
      Supports <a href="/docs/apps/developer-platform/build-apps/authentication/user-level-apps">user-level access</a>.
    </div>
  </div>;

export const ScopesList = ({scopes = [], description = "This API requires one of the following scopes:"}) => {
  if (!scopes || scopes.length === 0) {
    return null;
  }
  const sortedScopes = scopes.sort((a, b) => a.localeCompare(b));
  return <div>
      <div className="text-sm mb-2">{description}</div>
      <div>
        {sortedScopes.map((scope, index) => <div key={index}>
            <code>
              <span className="text-xs">{scope}</span>
            </code>
          </div>)}
      </div>
    </div>;
};

export const SupportedProducts = ({marketing, sales, service, cms, data, commerce, crm, marketingLevel, salesLevel, serviceLevel, cmsLevel, dataLevel, commerceLevel, crmLevel}) => {
  const translations = {
    description: "Requires one of the following products or higher.",
    productNames: {
      marketing: "Marketing Hub",
      sales: "Sales Hub",
      service: "Service Hub",
      cms: "Content Hub",
      data: "Data Hub",
      commerce: "Revenue Hub",
      crm: "Smart CRM"
    },
    tiers: {
      free: "Free",
      starter: "Starter",
      professional: "Professional",
      enterprise: "Enterprise"
    }
  };
  const translateTier = tier => {
    if (!tier) return '';
    const lowerTier = tier.toLowerCase();
    return translations.tiers[lowerTier] || tier;
  };
  const products = [{
    name: marketing ? translations.productNames.marketing : '',
    level: translateTier(marketingLevel),
    icon: "https://www.hubspot.com/hubfs/Knowledge_Base_2023-24-25/developer/icons/MarketingHub.svg",
    alt: "Marketing Hub"
  }, {
    name: sales ? translations.productNames.sales : '',
    level: translateTier(salesLevel),
    icon: "https://www.hubspot.com/hubfs/Knowledge_Base_2023-24-25/developer/icons/SalesHub.svg",
    alt: "Sales Hub"
  }, {
    name: service ? translations.productNames.service : '',
    level: translateTier(serviceLevel),
    icon: "https://www.hubspot.com/hubfs/Knowledge_Base_2023-24-25/developer/icons/ServiceHub.svg",
    alt: "Service Hub"
  }, {
    name: cms ? translations.productNames.cms : '',
    level: translateTier(cmsLevel),
    icon: "https://www.hubspot.com/hubfs/Knowledge_Base_2023-24-25/developer/icons/ContentHub.svg",
    alt: "Content Hub"
  }, {
    name: data ? translations.productNames.data : '',
    level: translateTier(dataLevel),
    icon: "https://www.hubspot.com/hubfs/Knowledge_Base_2023-24-25/developer/icons/DataHub.svg",
    alt: "Data Hub"
  }, {
    name: commerce ? translations.productNames.commerce : '',
    level: translateTier(commerceLevel),
    icon: "https://www.hubspot.com/hubfs/Knowledge_Base/subscription_key_icons/commerce_icon.svg",
    alt: "Revenue Hub"
  }, {
    name: crm ? translations.productNames.crm : '',
    level: translateTier(crmLevel),
    icon: "https://www.hubspot.com/hubfs/Knowledge_Base_2023-24-25/developer/icons/SmartCRM.svg",
    alt: "Smart CRM"
  }].filter(product => product.name && product.level);
  if (products.length === 0) return null;
  return <div>
      <div className="text-sm mb-2">{translations.description}</div>
      <div className={`grid ${products.length === 1 ? 'grid-cols-1' : 'grid-cols-2'} gap-1.5`}>
        {products.map((product, index) => <div key={index} style={{
    display: 'flex',
    alignItems: 'center'
  }}>
            <img src={product.icon} alt={product.alt} className="w-3.5 h-3.5 mr-1.5 mt-2.5 mb-2.5 flex-shrink-0 align-middle" />
            <span className="font-medium mr-1 text-sm">{product.name} -</span>
            <span className="text-sm">{product.level}</span>
          </div>)}
      </div>
    </div>;
};

<AccordionGroup>
  <Accordion title="Supported products" defaultOpen="true" icon="cubes">
    <SupportedProducts marketing={true} sales={true} service={true} cms={true} marketingLevel="FREE" salesLevel="FREE" serviceLevel="FREE" cmsLevel="FREE" />
  </Accordion>

  <Accordion title="Required Scopes" icon="key">
    <ScopesList
      scopes={[
  'reporting.full.write',
  'reporting.full.admin'
]}
    />
  </Accordion>

  <UserLevelAccessCallout />
</AccordionGroup>


## OpenAPI

````yaml specs/2027-03-beta/analytics-reporting-v2027-03-beta.json POST /analytics/reporting/2027-03-beta/reports/owners/batch/update
openapi: 3.0.1
info:
  title: Analytics Reporting
  description: Basepom for all HubSpot Projects
  version: 2027-03-beta
  x-hubspot-product-tier-requirements:
    marketing: FREE
    sales: FREE
    service: FREE
    cms: FREE
    commerce: FREE
    crmHub: FREE
    dataHub: FREE
servers:
  - url: https://api.hubapi.com
security: []
tags:
  - name: Dashboards
  - name: Reports
paths:
  /analytics/reporting/2027-03-beta/reports/owners/batch/update:
    post:
      tags:
        - Reports
      summary: Batch update report owners
      description: >-
        Updates the owner of one or more reports. The maximum batch size is 500.


        If any of the requested items fail, the response code will be `207
        Multi-Status` and the response will include details of individual
        failures.
      operationId: >-
        post-/analytics/reporting/2027-03-beta/reports/owners/batch/update_/analytics/reporting/2027-03-beta/reports/owners/batch/update
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BatchInputWithOwnerId'
        required: true
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BatchResponsePublicReport'
        '207':
          description: multiple statuses
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BatchResponsePublicReportWithErrors'
        default:
          $ref: '#/components/responses/Error'
          description: ''
      security:
        - oauth2:
            - reporting.full.write
        - oauth2:
            - reporting.full.admin
components:
  schemas:
    BatchInputWithOwnerId:
      required:
        - inputs
        - ownerId
      type: object
      properties:
        inputs:
          type: array
          description: Array of report or dashboard IDs.
          items:
            type: string
        ownerId:
          type: string
          description: The ID of the user to change the owner to.
    BatchResponsePublicReport:
      required:
        - completedAt
        - results
        - startedAt
        - status
      type: object
      properties:
        completedAt:
          type: string
          description: >-
            The date and time when the batch operation was completed, in ISO
            8601 format.
          format: date-time
        links:
          type: object
          additionalProperties:
            type: string
          description: >-
            A map of link names to associated URIs, providing additional
            resources or documentation related to the batch operation.
        requestedAt:
          type: string
          description: >-
            The date and time when the batch operation was requested, in ISO
            8601 format.
          format: date-time
        results:
          type: array
          description: >-
            An array of report objects representing the successful results of
            the batch operation.
          items:
            $ref: '#/components/schemas/PublicReport'
        startedAt:
          type: string
          description: >-
            The date and time when the batch operation started, in ISO 8601
            format.
          format: date-time
        status:
          type: string
          description: >-
            The current status of the batch operation. Valid values include
            'PENDING', 'PROCESSING', 'CANCELED', and 'COMPLETE'.
          enum:
            - CANCELED
            - COMPLETE
            - PENDING
            - PROCESSING
    BatchResponsePublicReportWithErrors:
      required:
        - completedAt
        - results
        - startedAt
        - status
      type: object
      properties:
        completedAt:
          type: string
          description: >-
            The date and time when the batch operation was completed, in ISO
            8601 format.
          format: date-time
        errors:
          type: array
          description: >-
            An array of error objects detailing any errors that occurred during
            the batch operation.
          items:
            $ref: '#/components/schemas/StandardError'
        links:
          type: object
          additionalProperties:
            type: string
          description: >-
            A map of link names to associated URIs that provide additional
            information or actions related to the batch operation.
        numErrors:
          type: integer
          description: The number of errors encountered during the batch operation.
          format: int32
        requestedAt:
          type: string
          description: >-
            The date and time when the batch operation was requested, in ISO
            8601 format.
          format: date-time
        results:
          type: array
          description: >-
            An array of report objects representing the successful results of
            the batch operation.
          items:
            $ref: '#/components/schemas/PublicReport'
        startedAt:
          type: string
          description: >-
            The date and time when the batch operation started, in ISO 8601
            format.
          format: date-time
        status:
          type: string
          description: >-
            The current status of the batch operation. Valid values include
            'PENDING', 'PROCESSING', 'CANCELED', and 'COMPLETE'.
          enum:
            - CANCELED
            - COMPLETE
            - PENDING
            - PROCESSING
    PublicReport:
      required:
        - archived
        - businessUnitId
        - createdAt
        - id
        - name
        - updatedAt
      type: object
      properties:
        archived:
          type: boolean
          description: Whether the report is archived.
        archivedAt:
          type: string
          description: >-
            If the report is archived, the date and time when the report was
            archived, in ISO 8601 format. Absent if the report is not archived.
          format: date-time
        businessUnitId:
          type: string
          description: The ID of the business unit that the report is associated with.
        createdAt:
          type: string
          description: The date and time when the report was created, in ISO 8601 format.
          format: date-time
        createdByUserId:
          type: string
          description: The ID of the user who created the report. May be absent.
        description:
          type: string
          description: A description of the report. May be absent.
        id:
          type: string
          description: The ID of the report.
        lastViewedAt:
          type: string
          description: >-
            The date and time when the report was last viewed, in ISO 8601
            format. Absent if it has not been viewed yet.
          format: date-time
        lastViewedByUserId:
          type: string
          description: >-
            The ID of the user who last viewed the report. Absent if it has not
            been viewed yet.
        name:
          type: string
          description: The name of the report.
        ownerUserId:
          type: string
          description: >-
            The ID of the user who owns the report. Absent if the report is
            currently unowned.
        permissions:
          $ref: '#/components/schemas/PublicReportPermissions'
        tags:
          type: array
          description: >-
            Array of objects representing the tags that the report is tagged
            with.


            Only returned when requested by including the `tags` field in the
            `properties` query parameter.
          items:
            $ref: '#/components/schemas/PublicTag'
        updatedAt:
          type: string
          description: >-
            The date and time when the report was last updated, in ISO 8601
            format.
          format: date-time
        updatedByUserId:
          type: string
          description: The ID of the user who last updated the report. May be absent.
    StandardError:
      required:
        - category
        - context
        - errors
        - links
        - message
        - status
      type: object
      properties:
        category:
          type: string
          description: A string categorizing the type of error.
        context:
          type: object
          additionalProperties:
            type: array
            items:
              type: string
          description: >-
            An object containing additional context about the error, with keys
            as context names and values as arrays of strings.
        errors:
          type: array
          description: >-
            An array of ErrorDetail objects providing further information about
            the error.
          items:
            $ref: '#/components/schemas/ErrorDetail'
        id:
          type: string
          description: A string representing a unique identifier for the error.
        links:
          type: object
          additionalProperties:
            type: string
          description: >-
            An object mapping link names to their associated URIs, which may
            contain documentation or remediation steps related to the error.
        message:
          type: string
          description: A string containing a human-readable message describing the error.
        status:
          type: string
          description: A string indicating the status of the error.
        subCategory:
          type: object
          properties: {}
          description: An object providing more specific categorization of the error.
      description: Ye olde error
    Error:
      required:
        - category
        - correlationId
        - message
      type: object
      properties:
        category:
          type: string
          description: The error category, represented as a string.
        context:
          type: object
          additionalProperties:
            type: array
            items:
              type: string
          description: >-
            An object providing context about the error condition, with
            additional properties as arrays of strings.
          example: >-
            {invalidPropertyName=[propertyValue], missingScopes=[scope1,
            scope2]}
        correlationId:
          type: string
          description: >-
            A unique identifier for the request, used for tracking and support
            purposes. It is a string formatted as a UUID.
          format: uuid
          example: aeb5f871-7f07-4993-9211-075dc63e7cbf
        errors:
          type: array
          description: >-
            An array containing further information about the error, with each
            item being an ErrorDetail object.
          items:
            $ref: '#/components/schemas/ErrorDetail'
        links:
          type: object
          additionalProperties:
            type: string
          description: >-
            A map of link names to associated URIs containing documentation
            about the error or recommended remediation steps. It is an object
            with string properties.
        message:
          type: string
          description: >-
            A human readable message describing the error along with remediation
            steps where appropriate. It is a string.
          example: An error occurred
        subCategory:
          type: string
          description: >-
            A specific category providing more detailed information about the
            error. It is a string.
      description: >-
        Represents an error response returned by the API when an operation
        fails. This component is used in various endpoints to provide detailed
        information about the error encountered.
      example:
        message: Invalid input (details will vary based on the error)
        correlationId: aeb5f871-7f07-4993-9211-075dc63e7cbf
        category: VALIDATION_ERROR
        links:
          knowledge-base: https://www.hubspot.com/products/service/knowledge-base
    PublicReportPermissions:
      required:
        - permissionType
      type: object
      properties:
        permissionType:
          type: string
          description: >-
            The type of permission to apply to the report. Valid values are:

            - PRIVATE: The report is only accessible to its owner and
            administrators.

            - EVERYONE_VIEW: The report is viewable by everyone.

            - EVERYONE_EDIT: The report is viewable and editable by everyone.

            - SPECIFIC: In addition to the owner, specific users and/or teams
            are granted VIEW or EDIT permissions. The `specificPermissions`
            field must also be present.
          enum:
            - EVERYONE_EDIT
            - EVERYONE_VIEW
            - PRIVATE
            - SPECIFIC
        specificPermissions:
          $ref: '#/components/schemas/PublicSpecificPermissionConfig'
    PublicTag:
      required:
        - id
        - name
      type: object
      properties:
        createdAt:
          type: string
          description: >-
            The date and time when the tag was created, in ISO 8601 format. May
            be absent.
          format: date-time
        createdByUserId:
          type: string
          description: The ID of the user who created the tag. May be absent.
        id:
          type: string
          description: The ID for the tag.
        name:
          type: string
          description: The name of the tag.
        updatedAt:
          type: string
          description: >-
            The date and time when the tag was last updated, in ISO 8601 format.
            May be absent.
          format: date-time
        updatedByUserId:
          type: string
          description: The ID of the user who last updated the tag. May be absent.
    ErrorDetail:
      required:
        - message
      type: object
      properties:
        code:
          type: string
          description: The status code associated with the error detail.
        context:
          type: object
          additionalProperties:
            type: array
            items:
              type: string
          description: >-
            Context about the error condition, represented as an object with
            additional properties that are arrays of strings.
          example: '{missingScopes=[scope1, scope2]}'
        in:
          type: string
          description: The name of the field or parameter in which the error was found.
        message:
          type: string
          description: >-
            A human readable message describing the error along with remediation
            steps where appropriate.
        subCategory:
          type: string
          description: >-
            A specific category that contains more specific detail about the
            error.
      description: >-
        Represents detailed information about an error that occurred in the API.
        This component is used to provide additional context and specifics about
        errors, typically as part of an error response.
    PublicSpecificPermissionConfig:
      required:
        - permissionType
      type: object
      properties:
        grants:
          type: array
          description: >-
            An array of grants detailing the users and/or teams to grant the
            specific permission to. At least one grantee must be specified.
          items:
            $ref: '#/components/schemas/PublicPermissionGrant'
        permissionType:
          type: string
          description: The type of permission granted, either `VIEW` or `EDIT`.
          enum:
            - EDIT
            - VIEW
    PublicPermissionGrant:
      required:
        - grantType
        - granteeId
      type: object
      properties:
        grantType:
          type: string
          description: The type of entity to grant permissions to, either `USER` or `TEAM`.
          enum:
            - TEAM
            - USER
        granteeId:
          type: string
          description: The ID of the user or team to grant permissions to.
  responses:
    Error:
      description: An error occurred.
      content:
        '*/*':
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    oauth2:
      type: oauth2
      flows:
        authorizationCode:
          authorizationUrl: https://app.hubspot.com/oauth/authorize
          tokenUrl: https://api.hubapi.com/oauth/v1/token
          scopes:
            crm.hubsql.execute: ''
            reporting.full.admin: ''
            reporting.full.edit: ''
            reporting.full.read: ''
            reporting.full.write: ''

````