> ## Documentation Index
> Fetch the complete documentation index at: https://terminal49-mintlify-db950745.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Remove a shipment party role

> Remove a party role from a shipment in the Terminal49 API. Detaches the party from the shipment while keeping the party record in your account.

Detaches the party from the shipment. The party itself is not deleted.

## Path parameters

| Parameter     | Required | Description                                      |
| ------------- | -------- | ------------------------------------------------ |
| `shipment_id` | Yes      | The ID of the shipment                           |
| `id`          | Yes      | The ID of the party role, from the list endpoint |


## OpenAPI

````yaml delete /shipments/{shipment_id}/party_roles/{id}
openapi: 3.0.0
info:
  title: Terminal49 API Reference
  version: 0.2.0
  contact:
    name: Terminal49 API support
    url: https://www.terminal49.com
    email: support@terminal49.com
  description: >-
    The Terminal 49 API offers a convenient way to programmatically track your
    shipments from origin to destination.


    Please enter your API key into the "Variables" tab before using these
    endpoints within Postman.
  x-label: Beta
  termsOfService: https://www.terminal49.com/terms
servers:
  - url: https://api.terminal49.com/v2
    description: Production
security:
  - authorization: []
tags:
  - name: Containers
  - name: Custom Field Definitions
  - name: Custom Field Options
  - name: Custom Fields
  - name: Shipments
  - name: Locations
  - name: Events
  - name: Tracking Requests
  - name: Webhooks
  - name: Webhook Notifications
  - name: Ports
  - name: Metro Areas
  - name: Terminals
  - name: Routing (Paid)
  - name: Documents
  - name: Email Submissions
  - name: Document Schemas
  - name: Search
  - name: Parties
paths:
  /shipments/{shipment_id}/party_roles/{id}:
    parameters:
      - schema:
          type: string
        name: shipment_id
        in: path
        required: true
        description: Shipment ID
      - schema:
          type: string
        name: id
        in: path
        required: true
        description: Party role ID
    delete:
      tags:
        - Parties
      summary: Remove a shipment party role
      description: Detaches the party from the shipment. The party itself is not deleted.
      operationId: delete-shipments-party-roles-id
      responses:
        '204':
          description: No Content
        '401':
          description: >-
            Unauthorized. Also returned when the record belongs to another
            account.
          content:
            application/json:
              schema:
                type: object
                properties:
                  errors:
                    type: array
                    items:
                      $ref: '#/components/schemas/error'
        '404':
          description: Not Found
components:
  schemas:
    error:
      title: Error model
      type: object
      properties:
        detail:
          type: string
          nullable: true
        title:
          type: string
          nullable: true
        source:
          type: object
          nullable: true
          properties:
            pointer:
              type: string
              nullable: true
            parameter:
              type: string
              nullable: true
        code:
          type: string
          nullable: true
        status:
          type: string
          nullable: true
        meta:
          type: object
          nullable: true
          additionalProperties: true
      required:
        - title
  securitySchemes:
    authorization:
      name: Authorization
      type: apiKey
      in: header
      description: >-
        Use a Terminal49 API key in the `Authorization` header with the `Token`
        prefix.


        `Authorization: Token YOUR_API_KEY`

````