Learning Outcomes
- Understanding the capabilities of the Via Foundry API.
- Steps for getting started with API authentication and usage.
- Examples of practical applications of the API.
Introduction to the Via Foundry API
The Via Foundry API serves as a comprehensive interface enabling developers to programmatically interact with the Via Foundry platform. It facilitates the management of configurations, projects, workspaces, user accounts, pipelines, and more. This API is crafted based on the OpenAPI Specification (OAS) 3.1, ensuring clarity and compatibility with diverse tools and libraries.
Key Features
| Feature Category | Key Features |
|---|---|
| Configurations | - Retrieve both platform-wide and user-specific configurations. - Access application change logs for monitoring updates. |
| Project Management | - Create, update, and delete projects. - Manage project pipelines, runs, and associated metadata. |
| Workspace Management | - Create and manage workspaces and their assets. |
| Authentication | - Supports multiple authentication mechanisms. - Personal access tokens, OAuth (Google/GitHub), and SAML. - Include functionalities for password reset, logout, and token generation. |
| Data Operations | - Handle datasets, files, and data across platforms. - Manage catalog assets for organized data handling. |
| Pipeline and Process Management | - List, create, and update pipelines and processes. - Manage revisions of pipelines and duplicate processes. |
| User Management | - Handle user credentials, service tokens, and group management. - Track user activity effectively. |
| Run Management | - Initiate and track runs. - Retrieve details, logs, and reports for individual runs. |
| Assistance and Tools | - Utilize code generation tools for specific prompts and languages. - Manage feature flags either globally or on a user-specific basis. |
First steps
Authorization
/auth/v1/personal-access-token
Many API endpoints necessitate authentication via personal access tokens or OAuth. Begin by generating a token using the personal-access-token endpoint.
Explore API Endpoints
/configurations/v1
Use /configurations/v1 to initiate interaction with platform configurations.
/project/v1
Manage projects through the /project/v1 endpoint.
/run/v1
Initiate runs and access pipeline data via /run/v1.
Interactive Documentation
Access the interactive Swagger UI at Via Foundry API Docs to test endpoints and review detailed request/response schemas.
Support and Feedback
For support refer to our API documentation available at:
<your instance>/api-docs/#/
Additionally, please feel free to contact support@viascientific.com with questions and/or feedback.