> ## Documentation Index > Fetch the complete documentation index at: https://help.pixwel.com/llms.txt > Use this file to discover all available pages before exploring further. # Update a share ## OpenAPI ````yaml /openapi.yaml put /shares/{id} openapi: 3.1.0 info: title: Pixwel Platform description: >- The Pixwel Platform REST API. Responses are decorated by proxy middleware (Fields, Links, Permissions, etc.). Use `?fields=` to request specific fields. version: '2.8' contact: email: jeff@pixwel.com license: name: UNLICENSED servers: - url: https://api-staging.pixwel.com/api description: Staging - url: https://app.pixwel.com/api description: Production security: - BasicAuth: [] paths: /shares/{id}: put: tags: - Shares summary: Update a share parameters: - name: id in: path required: true schema: type: string requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/SharesResponse' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/SharesResponse' components: schemas: SharesResponse: type: object properties: _id: type: string example: 568dfc5e07fe09720b8b4572 from: type: object properties: _id: type: string example: 566f2601581f4694168b4572 name: type: string example: Lucy Inglis emailNormal: type: string example: lucy_inglis@paramount.com $links: type: object properties: self: type: string example: //api-staging.pixwel.com/api/Users/566f2601581f4694168b4572 to: type: array items: type: object properties: _id: type: string example: 568dfc5d07fe09720b8b456f name: type: string example: Julia Holman emailNormal: type: string example: holman.julia@abc.net.au $links: type: object properties: self: type: string example: >- //api-staging.pixwel.com/api/Users/568dfc5d07fe09720b8b456f groups: type: array items: {} assets: type: array items: type: object properties: _id: type: string example: 564a29807cab46745c8b456f project: type: string example: 5600e9bef61e46d6668b4567 studio: type: string example: 51e1495bd5cddc8041000000 name: type: string example: Jacked To The Tits slug: type: string example: jacked-to-the-tits type: type: string example: film-clip.intl length: type: integer example: 46 thumbnail: type: string example: 564a2b87cbfd09150b8b4568 created: type: integer example: 1447700864 mediaType: type: string example: video creative: type: boolean example: false $links: type: object properties: self: type: string example: >- //api-staging.pixwel.com/api/Assets/564a29807cab46745c8b456f project: type: string example: //api-staging.pixwel.com/api/Projects/bigshort studio: type: string example: //api-staging.pixwel.com/api/Studios/paramount type: type: string example: //api-staging.pixwel.com/api/Assettypes/film-clip.intl thumbnail: type: string example: >- //api-staging.pixwel.com/api/Files/564a2b87cbfd09150b8b4568 $permissions: type: object properties: canAutosub: type: boolean example: true sources: type: object properties: requests: type: object properties: languages: type: array items: {} countries: type: array items: {} autosubs: type: object properties: languages: type: array items: {} countries: type: array items: {} access: type: array items: type: string example: autosubs tags: type: object properties: online: type: boolean example: true broadcast: type: boolean example: true dcp: type: boolean example: true cmyk: type: boolean example: true rgb: type: boolean example: true ingest: type: array items: type: string example: bumpers $feedback: type: object properties: share: type: string nullable: true vote: type: string nullable: true summary: type: array items: {} assetsCount: type: integer example: 5 assetCategory: type: string example: av projectNames: type: array items: type: string example: The Big Short tags: type: array items: type: array items: type: string example: broadcast urls: type: object properties: playlist: type: string example: https://platform.pixwel.com/shares/:share invite: type: string example: https://platform.pixwel.com/register/:code 564a29807cab46745c8b456f: type: string example: >- https://platform.pixwel.com/project/bigshort/film-clip.intl/564a29807cab46745c8b456f 564a29954f121cac048b4567: type: string example: >- https://platform.pixwel.com/project/bigshort/film-clip.intl/564a29954f121cac048b4567 564a29837cab46515d8b456f: type: string example: >- https://platform.pixwel.com/project/bigshort/film-clip.intl/564a29837cab46515d8b456f 564a29974f121ccf4f8b4571: type: string example: >- https://platform.pixwel.com/project/bigshort/film-clip.intl/564a29974f121ccf4f8b4571 5600e9bef61e46d6668b4568: type: string example: >- https://platform.pixwel.com/project/bigshort/trailer.intl/5600e9bef61e46d6668b4568 approved: type: boolean example: true notes: type: string example: |- Here is a selection of clips and the film trailer. Thanks feedback: type: object properties: enabled: type: boolean example: false created: type: integer example: 1452145758 questions: type: array items: {} $links: type: object properties: self: type: string example: //api-staging.pixwel.com/api/Shares/568dfc5e07fe09720b8b4572 from: type: string example: //api-staging.pixwel.com/api/Users/566f2601581f4694168b4572 permissions: type: array items: type: object properties: _id: type: string example: 568dfc5e07fe09720b8b4575 sources: type: object properties: download: type: object properties: ov: type: boolean example: true countries: type: array items: type: string example: AC languages: type: array items: {} manageWorkRequests: type: object properties: groups: type: array items: {} previews: type: object properties: ov: type: boolean example: true countries: type: array items: {} languages: type: array items: {} requests: type: object properties: ov: type: boolean example: true countries: type: array items: {} languages: type: array items: {} social: type: object properties: ov: type: boolean example: false countries: type: array items: {} languages: type: array items: {} adminWorkRequests: type: object properties: groups: type: array items: {} approved: type: boolean example: true project: type: string example: 5600e9bef61e46d6668b4567 assets: type: array items: type: string example: 5600e9bef61e46d6668b4568 tags: type: array items: type: array items: type: string example: broadcast types: type: array items: {} access: type: object properties: sharing: type: boolean example: false push: type: boolean example: false download: type: boolean example: true requests: type: boolean example: false notes: type: boolean example: false previews: type: string nullable: true manageWorkRequsts: type: boolean example: false projectAdminView: type: boolean example: false projectAdminUpdate: type: boolean example: false projectAdminEmbargos: type: boolean example: false workRequestReport: type: boolean example: false downloadReport: type: boolean example: false exceptionReport: type: boolean example: false groupSpendingReport: type: boolean example: false adminWorkRequests: type: boolean example: false shareVotingView: type: boolean example: false user: type: string example: 568dfc5d07fe09720b8b456f share: type: string example: 568dfc5e07fe09720b8b4572 $links: type: object properties: self: type: string example: >- //api-staging.pixwel.com/api/Permissions/568dfc5e07fe09720b8b4575 securitySchemes: BasicAuth: type: http scheme: basic ````