# Delete an assignment

Source: https://www.supervisible.com/developers/assignments/delete-assignments-id

DELETE /assignments/{assignment_id}



## DELETE /assignments/{assignment_id}

Deletes a single planned-hours row by ID. If it was that user's last planned row on the project, the API can also remove the user's project-team membership. Logged actual-hour history for the same user, project, and capability is preserved.

Base URL: https://app.supervisible.com/api/v1

Required scope: write:assignments

## Operation contract

The definition below includes parameters, request bodies, response schemas, examples and authentication requirements.

```json
{
  "summary": "Delete an assignment",
  "description": "Deletes a single planned-hours row by ID. If it was that user's last planned row on the project, the API can also remove the user's project-team membership. Logged actual-hour history for the same user, project, and capability is preserved.",
  "tags": [
    "assignments"
  ],
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "x-required-scope": "write:assignments",
  "parameters": [
    {
      "in": "path",
      "name": "assignment_id",
      "required": true,
      "description": "Assignment ID.",
      "schema": {
        "type": "string",
        "description": "UUID"
      }
    }
  ],
  "responses": {
    "204": {
      "description": "Successful response"
    },
    "400": {
      "description": "Invalid request"
    },
    "401": {
      "description": "Unauthorized"
    },
    "403": {
      "description": "Missing required scope or current member permission"
    },
    "404": {
      "description": "Not found"
    },
    "409": {
      "description": "Conflict; refresh current state and preview again"
    },
    "429": {
      "description": "Rate limited; honor Retry-After"
    }
  }
}
```

## Referenced definitions

```json
{
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "API Key"
      }
    }
  }
}
```

[Complete OpenAPI specification](https://www.supervisible.com/openapi/public-api-v1.json)