This endpoint is in preview and may be modified or removed at any time.
To use this endpoint, add preview=true
to the request query parameters.
Creates a branch on an existing dataset. A branch may optionally point to a (committed) transaction.
Third-party applications using this endpoint via OAuth2 must request the following operation scope: api:datasets-write
.
object
string
The Resource Identifier (RID) of a Transaction.
string
The name of a Branch.
object
The created Branch
string
The name of a Branch.
string
The Resource Identifier (RID) of a Transaction.
1
2
3
4
5
curl -X POST \
-H "Content-type: application/json" \
-H "Authorization: Bearer $TOKEN" \
"https://$HOSTNAME/api/v2/datasets/ri.foundry.main.dataset.c26f11c8-cdb3-4f44-9f5d-9816ea1c82da/branches?preview=true" \
-d '{"transactionRid":"ri.foundry.main.transaction.0a0207cb-26b7-415b-bc80-66a3aa3933f4","name":"master"}'
1
2
3
4
{
"transactionRid": "ri.foundry.main.transaction.0a0207cb-26b7-415b-bc80-66a3aa3933f4",
"name": "master"
}