Talend

Talend Sharing Set API

The SharingSet API from Talend — 2 operation(s) for sharingset.

GitHub OpenAPI

Operations 4

GET /sharing/sharingset/{entityType}/{entityId} Get a sharingset for an entity #
PUT /sharing/sharingset/{entityType}/{entityId} Update a sharingset for an entity #
PATCH /sharing/sharingset/{entityType}/{entityId} Patch a sharingset for an entity #
PATCH /sharing/sharingset Patch a sharingset #

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/talend/refs/heads/main/openapi/talend-sharingset-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/talend-sharingset-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

talend-sharingset-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Sharing Set API
  description: Manage how your users and groups can access your Talend Cloud entities.
  contact:
    name: Talend
  version: 2021-03
servers:
- url: https://api.eu.cloud.talend.com
  description: URL for the AWS Europe region
  x-talend:
    isPublished: true
- url: https://api.ap.cloud.talend.com
  description: URL for the AWS Asia Pacific region
  x-talend:
    isPublished: true
- url: https://api.us.cloud.talend.com
  description: URL for the AWS United States East region
  x-talend:
    isPublished: true
- url: https://api.au.cloud.talend.com
  description: URL for the AWS Australia region
  x-talend:
    isPublished: true
- url: https://api.us-west.cloud.talend.com
  description: URL for the Azure United States West region
  x-talend:
    isPublished: true
security:
- Public: []
tags:
- name: SharingSet
paths:
  /sharing/sharingset/{entityType}/{entityId}:
    parameters:
    - name: entityType
      in: path
      required: true
      schema:
        type: string
      example: preparation
    - name: entityId
      in: path
      required: true
      description: UUID
      schema:
        type: string
        description: UUID
      example: 15de7eb2-6447-49a8-a404-a53ecd1f3473
    get:
      tags:
      - SharingSet
      summary: Get a sharingset for an entity
      description: 'Use this method to retrieve a sharingset.

        A sharingset represents the full list of users and groups who have access to the specified entity.'
      operationId: getApiV1SharingsetEntitytypeEntityid
      parameters:
      - name: foreignEntityType
        in: query
        schema:
          type: string
        example: api_test
      - name: limit
        in: query
        description: Limits the number of elements displayed in the sharingset.
        schema:
          type: integer
          format: int32
          description: Limits the number of elements displayed in the sharingset.
        example: 100
      - name: offset
        in: query
        schema:
          type: integer
          format: int32
        example: 1000
      - name: includeDeletedSharings
        in: query
        description: True or false
        schema:
          type: boolean
          description: True or false
          default: false
      - name: foreignEntityId
        in: query
        schema:
          type: string
        example: 15de7eb2-6447-49a8-a404-a53ecd1f3473
      - name: X-CLIENT-VERSION
        in: header
        schema:
          type: string
      responses:
        '200':
          description: Status 200
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SharingSetResponse'
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorMessageBody'
        '401':
          description: Not authenticated
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorMessageBody'
        '403':
          description: Not authorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorMessageBody'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorMessageBody'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorMessageBody'
        '502':
          description: Bad gateway
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorMessageBody'
        '503':
          description: Service unavailable
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorMessageBody'
    put:
      tags:
      - SharingSet
      summary: Update a sharingset for an entity
      description: 'A sharingset represents the full list of users and groups who have access to the specified entity.

        Use this method to update the sharingset by defining who can access a given entity, and with which access level (viewer, editor, owner). This PUT operation allows you to replace the whole sharingset with the new information.'
      operationId: putApiV1SharingsetEntitytypeEntityid
      parameters:
      - name: X-CLIENT-VERSION
        in: header
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PutSharingSetRequest'
      responses:
        '200':
          description: Status 200
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SharingSetKey'
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorMessageBody'
        '401':
          description: Not authenticated
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorMessageBody'
        '403':
          description: Not authorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorMessageBody'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorMessageBody'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorMessageBody'
        '502':
          description: Bad gateway
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorMessageBody'
        '503':
          description: Service unavailable
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorMessageBody'
    patch:
      tags:
      - SharingSet
      summary: Patch a sharingset for an entity
      description: 'A sharingset represents the full list of users and groups who have access to the specified entity. Use this method to patch the sharingset and define who can access a given entity, and with which access level (viewer, editor, owner).

        Unlike the PUT operation that replaces the whole sharingset, the PATCH operation allows you to apply specific changes to the sharingset. A missing level stands for a removal command of a user or group sharing.'
      operationId: patchApiV1SharingsetEntitytypeEntityid
      parameters:
      - name: X-CLIENT-VERSION
        in: header
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PatchSharingSetRequest'
      responses:
        '200':
          description: Status 200
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SharingSetKey'
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorMessageBody'
        '401':
          description: Not authenticated
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorMessageBody'
        '403':
          description: Not authorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorMessageBody'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorMessageBody'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorMessageBody'
        '502':
          description: Bad gateway
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorMessageBody'
        '503':
          description: Service unavailable
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorMessageBody'
  /sharing/sharingset:
    patch:
      tags:
      - SharingSet
      summary: Patch a sharingset
      description: 'A sharingset represents a list of users and groups.

        Use this method to patch a list of sharingsets. The PATCH operation allows you to apply specific changes to the sharingset without replacing it entirely.'
      operationId: patchApiV1Sharingset
      parameters:
      - name: X-CLIENT-VERSION
        in: header
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BulkSharingSetRequest'
      responses:
        '200':
          description: Status 200
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SharingSetKey'
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorMessageBody'
        '401':
          description: Not authenticated
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorMessageBody'
        '403':
          description: Not authorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorMessageBody'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorMessageBody'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorMessageBody'
        '502':
          description: Bad gateway
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorMessageBody'
        '503':
          description: Service unavailable
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorMessageBody'
components:
  schemas:
    SharingSetResponse:
      type: object
      properties:
        users:
          type: array
          items:
            $ref: '#/components/schemas/UserSharingResponse'
        groups:
          type: array
          items:
            $ref: '#/components/schemas/GroupSharingResponse'
    PutUserSharingRequest:
      type: object
      required:
      - level
      - userId
      properties:
        userId:
          type: string
          description: UUID
          example: 15de7eb2-6447-49a8-a404-a53ecd1f3473
        level:
          $ref: '#/components/schemas/LevelRequest'
        firstName:
          type: string
          example: John
        lastName:
          type: string
          example: Frusciante
        foreignEntity:
          $ref: '#/components/schemas/ForeignEntity'
    PatchSharingSetRequest:
      type: object
      properties:
        users:
          type: array
          items:
            $ref: '#/components/schemas/PatchUserSharingRequest'
        groups:
          type: array
          items:
            $ref: '#/components/schemas/PatchGroupSharingRequest'
    PatchUserSharingRequest:
      type: object
      required:
      - userId
      properties:
        userId:
          type: string
          description: UUID
          example: 15de7eb2-6447-49a8-a404-a53ecd1f3473
        level:
          $ref: '#/components/schemas/LevelRequest'
        firstName:
          type: string
          example: John
        lastName:
          type: string
          example: Frusciante
        foreignEntity:
          $ref: '#/components/schemas/ForeignEntity'
    PutGroupSharingRequest:
      type: object
      required:
      - groupId
      - level
      properties:
        groupId:
          type: string
          description: UUID
          example: 15de7eb2-6447-49a8-a404-a53ecd1f3473
        level:
          $ref: '#/components/schemas/LevelRequest'
        groupName:
          type: string
          example: IT department
        foreignEntity:
          $ref: '#/components/schemas/ForeignEntity'
    ErrorMessageBody:
      type: object
      required:
      - error
      - path
      - status
      - timestamp
      description: This object is returned in case of an error during an API call.
      properties:
        timestamp:
          type: integer
          format: int64
          example: 1622618273418
        status:
          type: integer
          format: int32
          example: 400
        error:
          type: string
          example: Bad Request
        exception:
          type: string
        message:
          type: string
          example: The request is invalid
        path:
          type: string
          example: /sharing/sharings/levels/dataset
    ForeignEntity:
      type: object
      required:
      - entityId
      - entityType
      properties:
        entityId:
          type: string
          description: UUID
          example: 15de7eb2-6447-49a8-a404-a53ecd1f3473
        entityType:
          type: string
          example: dataset
    BulkSharingSetRequest:
      type: object
      required:
      - bulk
      properties:
        bulk:
          type: array
          items:
            type: object
            required:
            - entityId
            - entityType
            properties:
              entityId:
                type: string
                description: UUID
                example: 15de7eb2-6447-49a8-a404-a53ecd1f3473
              entityType:
                type: string
                example: dataset
              users:
                type: array
                items:
                  $ref: '#/components/schemas/PatchUserSharingRequest'
              groups:
                type: array
                items:
                  $ref: '#/components/schemas/PatchGroupSharingRequest'
    PatchGroupSharingRequest:
      type: object
      required:
      - groupId
      properties:
        groupId:
          type: string
          description: UUID
          example: 15de7eb2-6447-49a8-a404-a53ecd1f3473
        level:
          $ref: '#/components/schemas/LevelRequest'
        groupName:
          type: string
          example: IT department
        foreignEntity:
          $ref: '#/components/schemas/ForeignEntity'
    LevelResponse:
      type: object
      required:
      - code
      - label
      - order
      description: Description of a level access for an entity.
      properties:
        code:
          type: string
          example: WRITER
        label:
          type: string
          example: Editor
        order:
          type: integer
          format: int32
          example: 2
    UserSharingResponse:
      type: object
      required:
      - foreignEntity
      - level
      - userId
      properties:
        userId:
          type: string
          description: UUID
          example: 15de7eb2-6447-49a8-a404-a53ecd1f3473
        level:
          $ref: '#/components/schemas/LevelResponse'
        firstName:
          type: string
          example: John
        lastName:
          type: string
          example: Frusciante
        foreignEntity:
          $ref: '#/components/schemas/ForeignEntity'
        deletedAt:
          type: string
          format: date-time
    PutSharingSetRequest:
      type: object
      properties:
        users:
          type: array
          items:
            $ref: '#/components/schemas/PutUserSharingRequest'
        groups:
          type: array
          items:
            $ref: '#/components/schemas/PutGroupSharingRequest'
    LevelRequest:
      type: object
      required:
      - code
      properties:
        code:
          type: string
          example: WRITER
    GroupSharingResponse:
      type: object
      required:
      - foreignEntity
      - groupId
      - level
      properties:
        groupId:
          type: string
          description: UUID
          example: 15de7eb2-6447-49a8-a404-a53ecd1f3473
        level:
          $ref: '#/components/schemas/LevelResponse'
        groupName:
          type: string
          example: IT department
        foreignEntity:
          $ref: '#/components/schemas/ForeignEntity'
        deletedAt:
          type: string
          format: date-time
    SharingSetKey:
      type: object
      required:
      - entityId
      - entityType
      properties:
        entityType:
          type: string
          example: dataset
        entityId:
          type: string
          description: UUID
          example: 15de7eb2-6447-49a8-a404-a53ecd1f3473
  securitySchemes:
    Public:
      type: http
      scheme: bearer
      description: "This Bearer authentication can be\nset in the Authorization header of your requests. \n\nAuthentication tokens and Personal Access Tokens are supported.\n\nPersonal Access Tokens can be generated in the Profile Preferences page of the Talend Cloud Portal."
      bearerFormat: Bearer <token>