POST /entity

Create a new Entity. This method is used to create Projects, Folders, FileEntities and Records (coming soon). The passed request body should contain the following fields:

  • name - Give your new entity a Name. Note: A name must be unique within the given parent, similar to a file in a folder.
  • parentId - The ID of the parent Entity, such as a Folder or Project. This field should be excluded when creating a Project.
  • concreteType - Indicates the type of Entity to create. The value should be one of the following: org.sagebionetworks.repo.model.Project, org.sagebionetworks.repo.model.Folder, or org.sagebionetworks.repo.model.FileEntity

Note: To create an Entity the caller must be granted the ACCESS_TYPE.CREATE on the parent Entity. Any authenticated caller can create a new Project (with parentId=null).

Resource URL

https://repo-prod.prod.sagebase.org/repo/v1/entity

Parameters
generatedBy

optional

To track the Provenance of an Entity create, include the ID of the Activity that was created to track the change. For more information see: POST /activity. You must be the creator of the Activity used here.
Resource Information
Authentication Required
HTTP Methods POST
Request Object Entity
(application/json)
Response Object Entity
(application/json)