> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zapnito.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Update a third-party resource (PATCH)

> Identical to the PUT operation. Updates a third-party resource identified by its third-party reference. Only the attributes sent are changed. Tags are matched by name against existing child tags and replace the tags on the resource. If none of the names match, the current tags are left in place



## OpenAPI

````yaml https://api.zapnito.com/api/docs/v1/swagger.json patch /api/v1/third_party_resources/{id}
openapi: 3.0.1
info:
  title: API V1
  version: v1
  description: Zapnito API Documentation
servers:
  - url: https://{host}
    description: Your community domain
    variables:
      host:
        default: your-community.com
        description: Your community domain, for example your-community.com
security: []
tags:
  - name: Health Check
    description: Check that the API is reachable and that your API key is valid
  - name: Identity
    description: Find out which community your API key belongs to
  - name: Users
    description: >-
      Look up the people in your community, update their profile and choose
      which notifications they receive
  - name: Organisations
    description: >-
      Create and update the organisations in your community and manage who
      belongs to them
  - name: Groups
    description: Create groups and manage which users belong to them
  - name: Invitations
    description: Invite people to join your community
  - name: Posts
    description: Create, read and update posts on behalf of your community members
  - name: Contents
    description: >-
      Read the published content of your community and publish, schedule or
      unpublish it
  - name: Channels
    description: List the channels in your community and the content published in each
  - name: Rooms
    description: Create and read the rooms where your community members meet
  - name: Tags
    description: Create tags and apply them to content
  - name: Badges
    description: Create badges and award them to content or to users
  - name: Custom Fields
    description: Read the custom profile fields your community asks its members to fill in
  - name: Third-Party Resources
    description: >-
      Link to resources hosted outside your community so they appear alongside
      your content
  - name: Rest Hooks
    description: >-
      Subscribe a URL to events in your community, so you are told when they
      happen
paths:
  /api/v1/third_party_resources/{id}:
    parameters:
      - name: id
        in: path
        required: true
        description: The third-party reference identifying the resource
        schema:
          type: string
    patch:
      tags:
        - Third-Party Resources
      summary: Update a third-party resource (PATCH)
      description: >-
        Identical to the PUT operation. Updates a third-party resource
        identified by its third-party reference. Only the attributes sent are
        changed. Tags are matched by name against existing child tags and
        replace the tags on the resource. If none of the names match, the
        current tags are left in place
      operationId: patchThirdPartyResource
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ThirdPartyResourceUpdateRequest'
        required: true
        description: Resource payload wrapped in a third_party_resource object
      responses:
        '200':
          description: The third-party resource was updated
          content:
            application/json:
              schema:
                type: object
                properties:
                  third_party_resource:
                    $ref: '#/components/schemas/ThirdPartyResource'
                required:
                  - third_party_resource
        '400':
          description: The third_party_resource object is missing. The response has no body
        '401':
          description: >-
            The API key is missing or invalid. The response body is the text
            `HTTP Token: Access denied.`
        '404':
          description: >-
            No third-party resource has the third-party reference. The response
            has no body
        '422':
          description: The request failed validation
          content:
            application/json:
              examples:
                error:
                  value:
                    errors:
                      title:
                        - can't be blank
              schema:
                type: object
                properties:
                  errors:
                    type: object
                    properties:
                      title:
                        type: array
                        items:
                          type: string
                        example:
                          - can't be blank
                required:
                  - errors
      security:
        - tokenAuth: []
components:
  schemas:
    ThirdPartyResourceUpdateRequest:
      type: object
      properties:
        third_party_resource:
          type: object
          properties:
            third_party_ref:
              type: string
              example: ABC123
            title:
              type: string
              example: External guidance document
            description:
              type: string
              example: A useful external resource
            canonical_url:
              type: string
              example: https://example.com/resource
            thumbnail_url:
              type: string
              example: https://example.com/thumbnail.png
            open_in_new_tab:
              type: boolean
              example: false
            published_at:
              type: string
              format: date-time
              example: '2024-01-01T00:00:00Z'
            category_name:
              type: string
              example: Guidance
              description: >-
                Name of the category for the resource. The category is created
                if it does not exist
            tags:
              type: array
              items:
                type: string
              example:
                - clinical
              description: >-
                Names of existing child tags to apply to the resource
                (case-insensitive)
      required:
        - third_party_resource
    ThirdPartyResource:
      type: object
      properties:
        id:
          type: integer
          example: 1
        third_party_ref:
          type: string
          example: ABC123
          description: >-
            Your own reference for the resource. Identifies it in the URLs of
            this API
        title:
          type: string
          example: External guidance document
        description:
          type: string
          nullable: true
          example: A useful external resource
        canonical_url:
          type: string
          example: https://example.com/resource
        thumbnail_url:
          type: string
          nullable: true
          example: https://example.com/thumbnail.png
        open_in_new_tab:
          type: boolean
          example: false
          description: Whether the resource opens in a new browser tab
        published_at:
          type: string
          nullable: true
          format: date-time
          example: '2024-01-01T00:00:00Z'
        category:
          type: string
          nullable: true
          example: Guidance
          description: Name of the category the resource is in
        tags:
          type: array
          items:
            type: string
          example:
            - clinical
          description: Names of the tags applied to the resource
      required:
        - id
        - third_party_ref
        - title
        - canonical_url
        - open_in_new_tab
        - tags
  securitySchemes:
    tokenAuth:
      type: apiKey
      name: Authorization
      in: header
      description: >-
        API authentication using your community API secret. The value below is
        sent as the Authorization header verbatim, so paste the whole header
        value including the prefix: Token token=<api-key>
      x-default: Token token=<api-key>

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.