XNAT API Documentation
XNAT API Documentation
Breadcrumbs

Image Assessor Sharing API

Sharing Image Assessors into a new project does not have much effect unless you share the subject record as well. See Subject Sharing API.

Share An Image Assessor Into A New Project 

PUT - /data/projects/{original-project-id}/subjects/{subject-id}/experiments/{session-id}/assessors/{assessor-id}/projects/{shared-project-id}

Parameters

{original-project-id}

Required path parameter. Specify the ID of the project that owns a given image assessor.

{subject-id} or {subject-label}

Required path parameter.

{experiment-id} or {experiment-label}

Required path parameter.

{assessor-id} or {assessor-label}

Required path parameter.

{shared-project-id}

Required path parameter. Specify the ID of the project that you intend a subject to be shared into.

Logged-in user must have ownership permissions in the shared project.

label

Optional querystring parameter. Specify a new label for this assessor that will be used in the shared project, if desired.

primary

Optional querystring parameter.

  • If set to "true", you are changing the primary ownership of the assessor from the original project to the new project.

Logged-in user must have ownership permissions in both projects to change the primary ownership.

Response Codes

200

OK

403

Forbidden (User does not have permission to perform the requested operation)

404

Project Not Found

409

Conflict Found – Attempting to share data into an object that already exists

Response Format

Returns the assessor's experiment accession ID as a string


Get A List Of Shared Projects Associated With An Image Assessor 

GET - /data/projects/{original-project-id}/subjects/{subject-id}/experiments/{session-id}/assessors/{assessor-id}/projects

Parameters

{original-project-id}

Required path parameter. Specify the ID of the project that owns a given image assessor.

{subject-id} or {subject-label}

Required path parameter.

{session-id} or {session-label}

Required path parameter.

{assessor-id} or {assessor-label}

Required path parameter.

format

Optional querystring parameter. Specify the format of the returned response.

  • html (default)

  • json

  • xml

  • csv

Response

Displaying JSON results. Note that the response does not specify which project owns an experiment

{
  "ResultSet": {
    "Result": [
      {
        "label": "string",
        "ID": "string",
        "Secondary_ID": "string",
        "Name": "string"
      },
      ...
    ]
  }
}