# University of Texas at Austin Sharing API

**Canonical:** https://apis.io/apis/university-of-texas-at-austin/university-of-texas-at-austin-sharing-api/  
**Provider:** University of Texas at Austin — https://apis.io/providers/university-of-texas-at-austin/  
**Base URL:** https://tacc.tapis.io/v3  
**Documentation:** https://tapis-project.org/

University of Texas at Austin Sharing API is one of 21 APIs that [University of Texas at Austin](https://apis.io/providers/university-of-texas-at-austin/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Sharing. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and authentication docs.

In addition to fine grained permissions support, Tapis also supports a higher level approach to granting access. This approach is known simply as *sharing*. The sharing API allows an application owner to share an application with a set of users as well as share publicly with all users in a tenant. Sharing grants users READ access to the application and more importantly facilitates allowing others to run a job using the application. Please note that sharing an application gives a user certain implicit access to resources in the context of running a job. For example, if the application has defined a specific execution system id then while the job is running the user who has been granted access to the application via sharing will also have the applications owner's authorizations when accessing the system and paths on the system. Note that the application owner's authorizations supplement the user's authorizations, they do not replace them.

## Operations (19)

| Method | Path | Summary |
|---|---|---|
| GET | `/v3/apps/share/{appId}` | Retrieve all sharing information for an app |
| POST | `/v3/apps/share/{appId}` | Share an app with one or more users |
| POST | `/v3/apps/share_public/{appId}` | Share an app publicly with all users in the tenant |
| POST | `/v3/apps/unshare/{appId}` | Unshare an app with one or more users |
| POST | `/v3/apps/unshare_public/{appId}` | Remove public access for an app |
| GET | `/v3/files/share/{systemId}/{path}` | Retrieve all sharing information for a path on a system |
| POST | `/v3/files/share/{systemId}/{path}` | Share a path on a system with one or more users |
| POST | `/v3/files/share_public/{systemId}/{path}` | Share a path on a system publicly with all users in the tenant |
| POST | `/v3/files/unshare/{systemId}/{path}` | Unshare a path on a system with one or more users |
| POST | `/v3/files/unshare_public/{systemId}/{path}` | Remove public access for a path on a system |
| POST | `/v3/files/unshare_all/{systemId}/{path}` | Remove all shares for a path on a system including public access |
| DELETE | `/jobs/{jobUuid}/share/{user}` | Delete job share |
| GET | `/jobs/{jobUuid}/share` | Get job share |
| POST | `/jobs/{jobUuid}/share` | Share job |
| GET | `/v3/systems/share/{systemId}` | Retrieve all sharing information for a system |
| POST | `/v3/systems/share/{systemId}` | Share a system with one or more users |
| POST | `/v3/systems/share_public/{systemId}` | Share a system publicly with all users in the tenant |
| POST | `/v3/systems/unshare/{systemId}` | Unshare a system with one or more users |
| POST | `/v3/systems/unshare_public/{systemId}` | Remove public access for a system |

## Machine-readable artifacts (6)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/university-of-texas-at-austin/refs/heads/main/openapi/university-of-texas-at-austin-sharing-api-openapi.yml
- **Documentation** — https://tapis.readthedocs.io/en/latest/technical/index.html
- **SourceCode** — https://github.com/tapis-project
- **Authentication** — https://raw.githubusercontent.com/api-evangelist/university-of-texas-at-austin/refs/heads/main/authentication/university-of-texas-at-austin-authentication.yml
- **Errors** — https://raw.githubusercontent.com/api-evangelist/university-of-texas-at-austin/refs/heads/main/errors/university-of-texas-at-austin-errors.yml
- **Lifecycle** — https://raw.githubusercontent.com/api-evangelist/university-of-texas-at-austin/refs/heads/main/lifecycle/university-of-texas-at-austin-lifecycle.yml

## Other University of Texas at Austin APIs (12)

- [UT Austin Enterprise Identity Provider (SAML 2.0 + OpenID Connect)](https://apis.io/apis/university-of-texas-at-austin/enterprise-idp/)
- [Texas ScholarWorks DSpace REST API](https://apis.io/apis/university-of-texas-at-austin/scholarworks-rest/)
- [Texas ScholarWorks OAI-PMH Endpoint](https://apis.io/apis/university-of-texas-at-austin/scholarworks-oai/)
- [Texas Data Repository (Dataverse) — UT Austin collection](https://apis.io/apis/university-of-texas-at-austin/texas-data-repository/)
- [University of Texas at Austin Applications API](https://apis.io/apis/university-of-texas-at-austin/university-of-texas-at-austin-applications-api/)
- [University of Texas at Austin Archive transfers (Beta) API](https://apis.io/apis/university-of-texas-at-austin/university-of-texas-at-austin-archive-transfers-beta-api/)
- [University of Texas at Austin Child Systems API](https://apis.io/apis/university-of-texas-at-austin/university-of-texas-at-austin-child-systems-api/)
- [University of Texas at Austin Content API](https://apis.io/apis/university-of-texas-at-austin/university-of-texas-at-austin-content-api/)
- [University of Texas at Austin Credentials API](https://apis.io/apis/university-of-texas-at-austin/university-of-texas-at-austin-credentials-api/)
- [University of Texas at Austin Events API](https://apis.io/apis/university-of-texas-at-austin/university-of-texas-at-austin-events-api/)
- [University of Texas at Austin File Operations API](https://apis.io/apis/university-of-texas-at-austin/university-of-texas-at-austin-file-operations-api/)
- [University of Texas at Austin General API](https://apis.io/apis/university-of-texas-at-austin/university-of-texas-at-austin-general-api/)

## Tags

Sharing

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/university-of-texas-at-austin/university-of-texas-at-austin-sharing-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/university-of-texas-at-austin/.
