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

# Post apiassets content extract metadata

> Force a (re-)extraction of metadata for an AssetContent.

Runs synchronously and returns the updated record. Permission:
WRITE_METADATA on the parent Asset. Returns 503 when metadata
extraction is disabled on this deployment.



## OpenAPI

````yaml /api-reference/openapi.yaml post /api/assets/{id}/content/{content_pk}/extract-metadata/
openapi: 3.0.3
info:
  title: Console API
  version: 1.0.0
  description: Central control plane API for the Dataerai platform.
servers:
  - url: https://{server}
    description: Your Dataerai deployment (the API is served under /api)
    variables:
      server:
        default: your-deployment.dataerai.com
        description: Host of your Dataerai deployment
security: []
paths:
  /api/assets/{id}/content/{content_pk}/extract-metadata/:
    post:
      tags:
        - api
      description: |-
        Force a (re-)extraction of metadata for an AssetContent.

        Runs synchronously and returns the updated record. Permission:
        WRITE_METADATA on the parent Asset. Returns 503 when metadata
        extraction is disabled on this deployment.
      operationId: asset_content_extract_metadata
      parameters:
        - in: path
          name: content_pk
          schema:
            type: string
            format: uuid
          required: true
        - in: path
          name: id
          schema:
            type: string
            format: uuid
          required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AssetContent'
          description: ''
        '403':
          description: No response body
        '404':
          description: No response body
        '503':
          description: No response body
      security:
        - cookieAuthCsrfExempt: []
components:
  schemas:
    AssetContent:
      type: object
      properties:
        id:
          type: string
          format: uuid
          readOnly: true
        asset_id:
          type: string
          format: uuid
          readOnly: true
        allocation_id:
          type: string
          format: uuid
          readOnly: true
          nullable: true
        allocation:
          allOf:
            - $ref: '#/components/schemas/ContentAllocationSummary'
          readOnly: true
          nullable: true
        storage_path:
          type: string
          readOnly: true
        size_bytes:
          type: integer
          readOnly: true
        files: {}
        status:
          allOf:
            - $ref: '#/components/schemas/AssetContentStatusEnum'
          readOnly: true
        source:
          allOf:
            - $ref: '#/components/schemas/SourceEnum'
          readOnly: true
        external_record_id:
          type: string
          readOnly: true
        external_filename:
          type: string
          readOnly: true
        external_download_url:
          type: string
          format: uri
          nullable: true
          readOnly: true
        external_download_is_landing_page:
          type: boolean
          readOnly: true
        extracted_metadata:
          readOnly: true
          nullable: true
        data_type:
          type: string
          nullable: true
          readOnly: true
        data_type_confidence:
          type: number
          format: double
          readOnly: true
          nullable: true
        extraction_status:
          allOf:
            - $ref: '#/components/schemas/ExtractionStatusEnum'
          readOnly: true
        extraction_error:
          type: string
          readOnly: true
        extraction_attempted_at:
          type: string
          format: date-time
          readOnly: true
          nullable: true
        created_at:
          type: string
          format: date-time
          readOnly: true
        updated_at:
          type: string
          format: date-time
          readOnly: true
      required:
        - allocation
        - allocation_id
        - asset_id
        - created_at
        - data_type
        - data_type_confidence
        - external_download_is_landing_page
        - external_download_url
        - external_filename
        - external_record_id
        - extracted_metadata
        - extraction_attempted_at
        - extraction_error
        - extraction_status
        - id
        - size_bytes
        - source
        - status
        - storage_path
        - updated_at
    ContentAllocationSummary:
      type: object
      description: Compact allocation projection embedded inside AssetContentSerializer.
      properties:
        id:
          type: string
          format: uuid
          readOnly: true
        alias:
          type: string
          readOnly: true
        repository_name:
          type: string
          readOnly: true
        is_default:
          type: boolean
          readOnly: true
        current_bytes:
          type: integer
          readOnly: true
        data_volume_limit:
          type: integer
          readOnly: true
        current_record_count:
          type: integer
          readOnly: true
        max_records:
          type: integer
          readOnly: true
      required:
        - alias
        - current_bytes
        - current_record_count
        - data_volume_limit
        - id
        - is_default
        - max_records
        - repository_name
    AssetContentStatusEnum:
      enum:
        - uploading
        - available
        - failed
      type: string
      description: |-
        * `uploading` - Uploading
        * `available` - Available
        * `failed` - Failed
    SourceEnum:
      enum:
        - native
        - zenodo
        - databank
        - figshare
        - mdf
        - dryad
        - osf
        - mendeley
        - dataverse
        - huggingface
        - fourtu
        - cern
        - sciencebase
        - gbif
        - biostudies
        - pdb
        - pride
        - nomad
        - pangaea
        - cmr
        - pubchem
        - uniprot
        - ncbigeo
        - chembl
        - openml
        - datacite
        - dataone
        - noaa
        - cod
        - clinicaltrials
        - worldbank
        - ena
        - openneuro
        - empiar
        - mast
        - tcia
        - internetarchive
        - fooddata
        - nga
      type: string
      description: |-
        * `native` - Native
        * `zenodo` - Zenodo
        * `databank` - Illinois Data Bank
        * `figshare` - Figshare
        * `mdf` - Materials Data Facility
        * `dryad` - Dryad
        * `osf` - OSF
        * `mendeley` - Mendeley
        * `dataverse` - Dataverse
        * `huggingface` - Hugging Face
        * `fourtu` - 4TU.ResearchData
        * `cern` - CERN Open Data
        * `sciencebase` - USGS ScienceBase
        * `gbif` - GBIF
        * `biostudies` - EMBL-EBI BioStudies
        * `pdb` - RCSB Protein Data Bank
        * `pride` - EMBL-EBI PRIDE
        * `nomad` - NOMAD
        * `pangaea` - PANGAEA
        * `cmr` - NASA Earthdata (CMR)
        * `pubchem` - PubChem
        * `uniprot` - UniProt
        * `ncbigeo` - NCBI GEO
        * `chembl` - ChEMBL
        * `openml` - OpenML
        * `datacite` - DataCite
        * `dataone` - DataONE
        * `noaa` - NOAA NCEI
        * `cod` - Crystallography Open Database
        * `clinicaltrials` - ClinicalTrials.gov
        * `worldbank` - World Bank
        * `ena` - ENA
        * `openneuro` - OpenNeuro
        * `empiar` - EMPIAR
        * `mast` - MAST
        * `tcia` - TCIA
        * `internetarchive` - Internet Archive
        * `fooddata` - FoodData Central
        * `nga` - National Gallery of Art
    ExtractionStatusEnum:
      enum:
        - pending
        - succeeded
        - skipped
        - failed
      type: string
      description: |-
        * `pending` - Pending
        * `succeeded` - Succeeded
        * `skipped` - Skipped
        * `failed` - Failed

````