openapi: 3.1.0
info:
title: Palantir Foundry API v2 Admin - Groups Datasets API
description: The Palantir Foundry API v2 is a REST API for interacting with Foundry resources such as users, groups, datasets, and ontologies. Endpoints use OAuth 2.0 (with Bearer tokens) and largely use JSON requests and responses.
version: v2
contact:
name: Palantir Foundry
url: https://www.palantir.com/docs/foundry/api/v2/general/overview/introduction/
servers:
- url: https://{hostname}/api/v2
description: Foundry tenant API base URL
variables:
hostname:
default: foundry.example.palantirfoundry.com
description: The hostname of your Foundry stack
security:
- bearerAuth: []
tags:
- name: Datasets
paths:
/datasets:
post:
tags:
- Datasets
summary: Create a dataset
description: Creates a new Dataset. A default branch — `master` for most enrollments — will be created on the Dataset.
operationId: createDataset
requestBody:
required: true
content:
application/json:
schema:
type: object
responses:
'200':
description: Dataset created
'401':
description: Unauthorized
components:
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: OAuth 2.0 Bearer token. The token must be passed as an `Authorization` header using the `Bearer` authentication scheme. Foundry supports user-generated API tokens (for development), Authorization Code grant, and Client Credentials grant.