Creates a Transaction on a Branch of a Dataset.
Third-party applications using this endpoint via OAuth2 must request the following operation scope: api:datasets-write
.
string
The Resource Identifier (RID) of the Dataset on which to create the Transaction.
string
The identifier (name) of the Branch on which to create the Transaction. Defaults to master
for most enrollments.
object
string
(enum)The type of a Transaction.
Enum values: APPEND
, UPDATE
, SNAPSHOT
, DELETE
object
An operation that modifies the files within a dataset.
string
The Resource Identifier (RID) of a Transaction. Example: ri.foundry.main.transaction.0a0207cb-26b7-415b-bc80-66a3aa3933f4
.
string
(enum)The type of a Transaction.
Enum values: APPEND
, UPDATE
, SNAPSHOT
, DELETE
string
(enum)The status of a Transaction.
Enum values: ABORTED
, COMMITTED
, OPEN
string
The timestamp when the transaction was created, in ISO 8601 timestamp format.
string
The timestamp when the transaction was closed, in ISO 8601 timestamp format.
1
2
3
4
5
curl -X POST \
-H "Content-type: application/json" \
-H "Authorization: Bearer $TOKEN" \
"https://$HOSTNAME/api/v1/datasets/ri.foundry.main.dataset.c26f11c8-cdb3-4f44-9f5d-9816ea1c82da/transactions?branchId=" \
-d '{"transactionType":"SNAPSHOT"}'
1
2
3
4
5
6
{
"rid": "ri.foundry.main.transaction.abffc380-ea68-4843-9be1-9f44d2565496",
"transactionType": "SNAPSHOT",
"status": "OPEN",
"createdTime": "2022-10-10T12:23:11.152Z"
}