task_id: task_create_api_delete_label_invitation
entity_id: api_delete_label_invitation
generated_at: '2025-12-18T17:43:33.714652'
workflow_version: v003
target:
  type: api
  definition:
    id: api_delete_label_invitation
    method: DELETE
    path: /api/labels/[id]/invitations/[invitationId]
    summary: Cancel invitation
    description: Cancel a pending invitation
    tags:
    - labels
    - invitations
    path_params:
    - name: id
      type: string
      description: Label ID
    - name: invitationId
      type: string
      description: Invitation ID
    responses:
    - status: 200
      description: Invitation cancelled
    - status: 401
      description: Unauthorized
    - status: 403
      description: Not label owner
    - status: 404
      description: Invitation not found
    depends_on_models:
    - model_label_invitation
    depends_on_apis: []
    auth:
      required: true
      roles:
      - label
related:
  models:
  - id: model_label_invitation
    definition: &id001
      id: model_label_invitation
      name: LabelInvitation
      description: Invitations from labels to artists to join their roster
      table_name: label_invitations
      fields:
      - name: id
        type: uuid
        constraints:
        - primary_key
        description: Unique identifier
      - name: labelId
        type: uuid
        constraints:
        - foreign_key
        - not_null
        - indexed
        description: Reference to the inviting label (FK to labels table)
      - name: artistId
        type: uuid
        constraints:
        - foreign_key
        - not_null
        - indexed
        description: Reference to the invited artist (FK to artists table)
      - name: status
        type: enum
        enum_values:
        - pending
        - accepted
        - declined
        - expired
        constraints:
        - not_null
        - default
        default: pending
        description: Current status of the invitation
      - name: message
        type: text
        constraints: []
        description: Optional message from label to artist
      - name: expiresAt
        type: datetime
        constraints:
        - not_null
        description: When the invitation expires
      - name: createdAt
        type: datetime
        constraints:
        - not_null
        description: When invitation was created
      - name: updatedAt
        type: datetime
        constraints:
        - not_null
        description: When invitation was last updated
      relations: []
      indexes:
      - fields:
        - labelId
        - artistId
        unique: true
        name: label_artist_unique
      - fields:
        - artistId
        - status
        unique: false
        name: artist_pending_invitations
      timestamps: true
      soft_delete: false
      validations:
      - field: expiresAt
        rule: future_date
        message: Expiration date must be in the future
  apis: []
  components: []
dependencies:
  entity_ids:
  - model_label_invitation
  definitions:
  - id: model_label_invitation
    type: model
    definition: *id001
files:
  to_create:
  - app/api/labels/[id]/invitations/[invitationId]/route.ts
  reference: []
acceptance:
- criterion: DELETE /api/labels/[id]/invitations/[invitationId] returns success response
  verification: curl -X DELETE /api/labels/[id]/invitations/[invitationId]
- criterion: Request validation implemented
  verification: Test with invalid data
- criterion: Error responses match contract
  verification: Test error scenarios