---
title: "Create a resource request"
method: POST
path: "/requests/suggest"
tags: ["requests - resource"]
---

# Create a resource request

`POST /requests/suggest`

This API allows users to submit requests for modifications or contributions to dataset or metadata resources. Users can propose changes or transfers within an organization's collections, specifying details about the resource and type of request through structured parameters.

## Request body

- PublicResourceRequestDto
  - `approverParty` PublicParty
    - `type` 'USER' | 'GROUP', required
  - `contribution` ContributionDto
    - `activities` ContributionActivity[], required — Details about the contribution
      - `contributionHydratables` ContributionHydratable[]
        - `agentId` string
        - `entityType` string, required
        - `identifier` string, required
      - `type` 'AddCustomIriProperty' | 'AddCustomLiteralProperty' | 'AddTag' | 'AddToCatalog' | 'AddUsesDataFrom' | 'AddUsesDataset' | 'CreateAnalysis' | 'CreateBusinessTerm' | 'CreateCatalog' | 'CreateCatalogResource' | 'CreateDataset' | 'CreateExternalResource' | 'CreateMissingDatasetAndLinkAnalysis' | 'CreateMissingDatasetAndLinkTable' | 'ReferenceBusinessTerm' | 'RemoveCustomIriProperty' | 'RemoveCustomLiteralProperty' | 'RemoveFromCatalog' | 'RemoveTag' | 'RemoveUsesDataFrom' | 'RemoveUsesDataset' | 'SetAssetStatus' | 'SetCustomIriProperty' | 'SetCustomLiteralProperty' | 'SetCustomStringProperty' | 'SetDescription' | 'SetLicense' | 'SetName' | 'SetSummary' | 'UnreferenceBusinessTerm', required
    - `activityType` 'METADATA_EDIT' | 'RELATIONSHIP', required — The type of contribution that is being made
    - `type` 'METADATA' | 'DATASET', required — The type of resource that this contribution is done on
  - `created` string, date-time
  - `granteeOwner` string — If this is a transfer request, this is the organization that will receive the resource. Otherwise, this is the same as approverParty.
  - `message` string
  - `requestId` string, uuid — A unique id of the request assigned by the service and returned in response thus must not be provided in create request.
  - `requesterParty` PublicParty
    - `type` 'USER' | 'GROUP', required
  - `resource` PublicResource, required
    - `owner` string, required — ID of an organization that owns the resource
    - `type` 'ANALYSIS' | 'CATALOG' | 'COLUMN' | 'DATABASE' | 'DATASET' | 'DATASET_INSIGHT' | 'GLOSSARY' | 'GROUP' | 'METADATA_RESOURCE' | 'TABLE', required
  - `resourceRequestType` 'CONTRIBUTION' | 'TRANSFER', required — The type of request
  - `transferAsset` TransferAssetDto
    - `entityType` string, required — The type of resource being transferred
    - `identifier` string — The dct:identifier of resource being transferred
    - `iri` string, required — The IRI of resource being transferred
  - `updated` string, date-time

## Response `200`

default response

- PublicResourceRequestDto
  - `approverParty` PublicParty
    - `type` 'USER' | 'GROUP', required
  - `contribution` ContributionDto
    - `activities` ContributionActivity[], required — Details about the contribution
      - `contributionHydratables` ContributionHydratable[]
        - `agentId` string
        - `entityType` string, required
        - `identifier` string, required
      - `type` 'AddCustomIriProperty' | 'AddCustomLiteralProperty' | 'AddTag' | 'AddToCatalog' | 'AddUsesDataFrom' | 'AddUsesDataset' | 'CreateAnalysis' | 'CreateBusinessTerm' | 'CreateCatalog' | 'CreateCatalogResource' | 'CreateDataset' | 'CreateExternalResource' | 'CreateMissingDatasetAndLinkAnalysis' | 'CreateMissingDatasetAndLinkTable' | 'ReferenceBusinessTerm' | 'RemoveCustomIriProperty' | 'RemoveCustomLiteralProperty' | 'RemoveFromCatalog' | 'RemoveTag' | 'RemoveUsesDataFrom' | 'RemoveUsesDataset' | 'SetAssetStatus' | 'SetCustomIriProperty' | 'SetCustomLiteralProperty' | 'SetCustomStringProperty' | 'SetDescription' | 'SetLicense' | 'SetName' | 'SetSummary' | 'UnreferenceBusinessTerm', required
    - `activityType` 'METADATA_EDIT' | 'RELATIONSHIP', required — The type of contribution that is being made
    - `type` 'METADATA' | 'DATASET', required — The type of resource that this contribution is done on
  - `created` string, date-time
  - `granteeOwner` string — If this is a transfer request, this is the organization that will receive the resource. Otherwise, this is the same as approverParty.
  - `message` string
  - `requestId` string, uuid — A unique id of the request assigned by the service and returned in response thus must not be provided in create request.
  - `requesterParty` PublicParty
    - `type` 'USER' | 'GROUP', required
  - `resource` PublicResource, required
    - `owner` string, required — ID of an organization that owns the resource
    - `type` 'ANALYSIS' | 'CATALOG' | 'COLUMN' | 'DATABASE' | 'DATASET' | 'DATASET_INSIGHT' | 'GLOSSARY' | 'GROUP' | 'METADATA_RESOURCE' | 'TABLE', required
  - `resourceRequestType` 'CONTRIBUTION' | 'TRANSFER', required — The type of request
  - `transferAsset` TransferAssetDto
    - `entityType` string, required — The type of resource being transferred
    - `identifier` string — The dct:identifier of resource being transferred
    - `iri` string, required — The IRI of resource being transferred
  - `updated` string, date-time

---

[API](https://skmtc.dev/data/apis/data-world-public-api.md) · [All operations](https://skmtc.dev/data/apis/data-world-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/data/data-world-public-api/revisions/0a0cb1f94dad/schema)