Retrieval and Deletion API

List, view, and delete the containers you have created.

List User RDMCs

Returns a lightweight list of every container you have created.

  • Endpoint: GET /rdmc/list/

  • Expected Response (200 OK):

{
  "success": true,
  "count": 2,
  "results": [
    {
      "container_id": "RDMC-1234-ABCD",
      "container_name": "Ocean Current Analysis",
      "status": "create",
      "epic_handle": "21.11113/0000-0000-0000-0000"
    }
  ]
}

status is create until the container is sealed, and then becomes seal. epic_handle is null until a PID has been generated.

Get Specific RDMC Container Details

Returns full details for one container: metadata, configuration, and every artifact’s links, files, and folders.

  • Endpoint: GET /rdmc/<container_id>/

  • Expected Response (200 OK):

{
  "success": true,
  "rdmc_version": "0.7.0",
  "manifest_schema_version": "1.0.6",
  "container_id": "tRQgHBG5",
  "container_name": "Single Request - Mixed and Sealed",
  "status": "seal",
  "sealed_date": "2026-08-17",
  "hash_value": "555ac64a4887fed5d414e26e06d2133346acf79bf99e185e5e030404bad596bf",
  "epic_handle": "21.T11.9997/NFDIxCS/ffb0dcb7-cf52-4178-85be-81cb833d62a4",
  "created_at": "2026-08-17T10:23:27.982360Z",
  "last_modified": "2026-08-17T10:23:36.840292Z",
  "artifacts": "Documentation; Compiled_Binaries",
  "artifact_access_levels": "Public; Restricted",
  "resource_types": "Text, Software",
  "configuration_name": null,
  "creation_method": "Local (Online)",
  "metadata": {
    "description": "Final sealed release of the application.",
    "subject": "Computer and Information Science",
    "keywords": "Automation, API, Testing",
    "license": "MIT",
    "contributors": [
      {
        "first_name": "Jane",
        "last_name": "Doe",
        "affiliation": "Institute for Computer Science",
        "orcid": "0000-0002-1825-0097",
        "role": "Lead Developer"
      }
    ],
    "container_concept": "upload"
  },
  "artifacts_details": [
    {
      "artifact_name": "Documentation",
      "access_level": "Public",
      "links": [
        {
          "title": "Project Wiki",
          "resource type": "Text",
          "link": "https://gitlab.gwdg.de/nfdixcs/a1-architecture/rdmc-prototype"
        }
      ]
    },
    {
      "artifact_name": "Compiled_Binaries",
      "access_level": "Restricted",
      "files": [
        {
          "title": "Release v1.0",
          "resource type": "Software",
          "file name": "02-application.pdf"
        }
      ],
      "folders": [
        {
          "title": "Support Libraries",
          "resource type": "Software",
          "folder name": "somef2smp"
        }
      ]
    }
  ]
}

Returns 404 if the container does not exist or does not belong to you.

Delete RDMC Container

Permanently deletes a container: the database record and every uploaded file. This cannot be undone.

  • Endpoint: DELETE /rdmc/<container_id>/delete/

  • Expected Response (200 OK):

{
  "success": true,
  "message": "Container permanently deleted."
}

Integration Guide

The examples below use curl. Any language that can send HTTP requests can make the same calls.

# List your containers
curl -X GET https://api.nfdixcs.org/rdmc_creation/rdmc/list/ \
  -H "Authorization: Token <your_token>"

# Get one container's details
curl -X GET https://api.nfdixcs.org/rdmc_creation/rdmc/RDMC-1234-ABCD/ \
  -H "Authorization: Token <your_token>"

# Delete a container — this is permanent
curl -X DELETE https://api.nfdixcs.org/rdmc_creation/rdmc/RDMC-1234-ABCD/delete/ \
  -H "Authorization: Token <your_token>"

GET requests need no body. Check the success field in the response before you use any other data in it.